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
- Make sure PlaceholderAPI is installed
- Drop
FrozenShards.jarinto your/pluginsfolder - Do a full server restart (not /reload)
- Plugin will auto-generate
config.yml,data.yml, andshardshop.yml - Edit
shardshop.ymlto 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%
