# FrozenShards \ud83d\udc8e<\/p>\n
A lightweight virtual shard economy plugin for PaperMC servers.
\nGive, take, pay shards between players, and let them spend it in a fully configurable GUI shop \u2014 all with rich PlaceholderAPI support including a top-10 leaderboard.<\/p>\n
—<\/p>\n
## \u2705 Requirements<\/p>\n
– PaperMC 1.20+
\n– Java 17+
\n– PlaceholderAPI (required for all placeholders)
\n– AJLeaderboards (optional, for leaderboard displays)<\/p>\n
—<\/p>\n
## \u2699\ufe0f Installation<\/p>\n
1. Make sure **PlaceholderAPI** is installed
\n2. Drop `FrozenShards.jar` into your `\/plugins` folder
\n3. Do a full server **restart** (not \/reload)
\n4. Plugin will auto-generate `config.yml`, `data.yml`, and `shardshop.yml`
\n5. Edit `shardshop.yml` to add your own items, prices, and commands<\/p>\n
—<\/p>\n
## \ud83d\udcac Commands<\/p>\n
| Command | Description | Permission | —<\/p>\n ## \ud83d\udd16 PlaceholderAPI Placeholders<\/p>\n **Balance** The formatted placeholder automatically shortens numbers: **Leaderboard \u2014 Player Names** **Leaderboard \u2014 Shard Counts** > Leaderboard data is cached every 60 seconds to prevent lag on scoreboard refresh.<\/p>\n —<\/p>\n ## \ud83c\udfc6 Leaderboard Example (AJLeaderboards \/ Scoreboards) #2 %frozenshards_top2_player% \u2014 %frozenshards_top2_value% shards<\/p>\n #3 %frozenshards_top3_player% \u2014 %frozenshards_top3_value% shards<\/p>\n Your balance: %frozenshards_value_formatted%<\/p>\n —<\/p>\n","protected":false},"excerpt":{"rendered":" A lightweight virtual shard economy plugin<\/p>\n","protected":false},"featured_media":73710,"template":"","meta":{"_minecraft_slug":"frozenshards","_minecraft_project_id":"Ob9fr5La","_minecraft_author":"DrFrozenXD","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":194,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"frozenshards.zip","_minecraft_size_bytes":770618,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:30:54.658014Z","_minecraft_date_created":"2026-03-24T22:49:25.335346Z","_minecraft_date_modified":"2026-03-23T07:26:59.144986Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/frozenshards","_minecraft_icon_attachment_id":73710,"_minecraft_imported_at":"2026-06-04T06:58:25+00:00","_minecraft_import_hash":"394344dcbfd31593fed1667d46bea221","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,127,129,91,92],"mod_loader":[130,132,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-73709","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-paper","mod_category-spigot","mod_category-storage","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n|—|—|—|
\n| `\/shards give
\n| `\/shards take
\n| `\/shards giveall
\n| `\/shards takeall
\n| `\/payshards
\n| `\/shardshop` | Open the shard shop GUI | \u2014 |<\/p>\n
\n| Placeholder | Example Output |
\n|—|—|
\n| `%frozenshards_value%` | `1250000` |
\n| `%frozenshards_value_formatted%` | `1.25m` |<\/p>\n
\n`1000` \u2192 `1k` | `25040` \u2192 `25.04k` | `789000` \u2192 `789k` | `6000000` \u2192 `6m` | `1000000000` \u2192 `1b`<\/p>\n
\n| Placeholder | Example Output |
\n|—|—|
\n| `%frozenshards_top1_player%` | `DrFrozen` |
\n| `%frozenshards_top2_player%` | `Steve` |
\n| `%frozenshards_top3_player%` to `%frozenshards_top10_player%` | … |<\/p>\n
\n| Placeholder | Example Output |
\n|—|—|
\n| `%frozenshards_top1_value%` | `4800000` |
\n| `%frozenshards_top2_value%` | `3120000` |
\n| `%frozenshards_top3_value%` to `%frozenshards_top10_value%` | … |<\/p>\n
\n#1 %frozenshards_top1_player% \u2014 %frozenshards_top1_value% shards<\/p>\n