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