FrozenShards 💎

A lightweight virtual shard economy plugin for PaperMC servers. Give, take, pay shards between players, and let them spend it in a fully configurable GUI shop — all with rich PlaceholderAPI support including a top-10 leaderboard.

---

✅ Requirements

• PaperMC 1.20+
• Java 17+
• PlaceholderAPI (required for all placeholders)
• AJLeaderboards (optional, for leaderboard displays)

---

⚙️ Installation

1. Make sure PlaceholderAPI is installed
2. Drop FrozenShards.jar into your /plugins folder
3. Do a full server restart (not /reload)
4. Plugin will auto-generate config.yml, data.yml, and shardshop.yml
5. Edit shardshop.yml to add your own items, prices, and commands

---

💬 Commands

Command	Description	Permission
/shards give <player> <amount>	Give shards to a player	frozenshards.admin
/shards take <player> <amount>	Remove shards from a player	frozenshards.admin
/shards giveall <amount>	Give shards to all online players	frozenshards.admin
/shards takeall <amount>	Remove shards from all online players	frozenshards.admin
/payshards <player> <amount>	Send your shards to another player	—
/shardshop	Open the shard shop GUI	—

---

🔖 PlaceholderAPI Placeholders

Balance

Placeholder	Example Output
%frozenshards_value%	1250000
%frozenshards_value_formatted%	1.25m

The formatted placeholder automatically shortens numbers: 1000 → 1k | 25040 → 25.04k | 789000 → 789k | 6000000 → 6m | 1000000000 → 1b

Leaderboard — Player Names

Placeholder	Example Output
%frozenshards_top1_player%	DrFrozen
%frozenshards_top2_player%	Steve
%frozenshards_top3_player% to %frozenshards_top10_player%	...

Leaderboard — Shard Counts

Placeholder	Example Output
%frozenshards_top1_value%	4800000
%frozenshards_top2_value%	3120000
%frozenshards_top3_value% to %frozenshards_top10_value%	...

Leaderboard data is cached every 60 seconds to prevent lag on scoreboard refresh.

---

🏆 Leaderboard Example (AJLeaderboards / Scoreboards)

#1 %frozenshards_top1_player% — %frozenshards_top1_value% shards

#2 %frozenshards_top2_player% — %frozenshards_top2_value% shards

#3 %frozenshards_top3_player% — %frozenshards_top3_value% shards

Your balance: %frozenshards_value_formatted%

---