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%

---