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%
Similar projects
Plugin →VeinMiner
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
99.3MSueta
Simple Voice Chat
A working voice chat in Minecraft!
76.8MSueta
Chunky
Pre-generates chunks, quickly and efficiently
18.4MSueta
VeinMiner Enchantment
Veinminer Addon - Adds vineminer enchantment to enchanting tables. Only tools with the enchantment can veinmine
18MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
WorldEdit
A Minecraft Map Editor... that runs in-game! With selections, schematics, copy and paste, brushes, and scripting. Use it in creative, or use it temporarily in survival.
11.6MSueta