Compatibility
Minecraft: Java Edition
Platforms
Links
Tags
Creators
Details
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%