UltimateChristmas / Shard economy
Shard economy
Shards are the plugin's festive currency. Players earn them through gameplay they are already doing — mining, chopping, fighting — and spend them in Santa's Workshop. You don't change your server's gameplay; Christmas rewards appear on top of it.
module id: economy config: modules/economy.yml
How players use it
| Command | Does | Permission |
|---|---|---|
/christmas shards [player] | Check a balance | ultimatechristmas.shards (.others for other players) |
/christmas pay <player> <amount> | Send shards to another player | ultimatechristmas.pay |
Earning itself is gated by ultimatechristmas.earn (default: everyone). A short action-bar note shows what was earned.
Admin commands
/christmas eco give <player> <amount> /christmas eco take <player> <amount> /christmas eco set <player> <amount>
Permission: ultimatechristmas.admin.economy.
Configuring earning sources
Four source types. Every entry takes shards (a number or an inclusive range like "3-7") and chance (0.0–1.0 — or write a number above 1 and it is read as a percentage).
earning:
# Blocks a player placed themselves pay nothing. Leave this on: without it,
# a player can place an ore block and break it over and over for free shards.
ignore-player-placed: true
announce: true # action-bar note when shards are earned
announce-threshold: 1
blocks: # vanilla blocks
diamond_ore: { shards: 20-35, chance: 0.80 }
spruce_log: { shards: 1, chance: 0.20 }
ancient_debris: { shards: 40-60, chance: 1.0 }
mobs: # vanilla mobs, by Bukkit entity type
zombie: { shards: 3-6, chance: 0.30 }
witch: { shards: 15-25, chance: 0.60 }
ender_dragon: { shards: 400-600, chance: 1.0 }
itemsadder-blocks: # needs ItemsAdder; ignored if the id doesn't exist
christmas:present_block: { shards: 20-30, chance: 1.0 }
mythicmobs: # needs MythicMobs; internal names, not display names
FrostGiant: { shards: 60-90, chance: 1.0 }
EvilElf: { shards: 20-35, chance: 0.75 }
The default config ships sensible values for ores, winter blocks (snow, ice), festive mobs (strays, snow golems, polar bears) and the big vanilla bosses. Treat them as a starting point and tune to your economy.
Player-to-player payments
pay: enabled: true minimum: 1 # Naughty/nice credit for being generous. Rate-limited to once an hour so it # cannot be farmed by two accounts passing shards back and forth. nice-points: 1
Where shards flow
- In: earning sources above, advent doors, boss loot, Santa's gifts, presents, quest rewards, snowball hits, the tree.
- Out: the shop and advent catch-up purchases.