FrozenShards

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 restart 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%

---