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