1.0.0
Compatibility
Changes
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%
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:Ob9fr5La:4urGR1U0"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:Ob9fr5La:4urGR1U0"
}

