💎 The Shard Economy

The Shard system is the backbone of the UltimateChristmas plugin’s progression. Shards act as a special event currency, earned through everyday activities like mining, farming, and fighting festive mobs—and later spent in the Shard Shop.

🎯 What are Shards?

In-game currency distinct from money/tokens/XP.
Rewards playtime and engagement (not trading/automation).
Players earn shards by:
- Breaking specific blocks (configurable per material),
- Killing certain mobs or MythicMobs,
- Interacting with ItemsAdder blocks (if enabled).

Chat feedback example: + 5 shards (You now have 120). Spend shards via the /shards shop GUI, admin commands (/shards give/take), or as rewards from NPCs/quests.

⚙️ Config summary (`shards.yml`)

Section	Purpose
`blocks`	Vanilla block rewards (e.g., `coal_ore`, `oak_log`).
`mobs`	Natural mob rewards (e.g., `zombie`, `creeper`).
`itemsadder-blocks`	Custom ItemsAdder blocks drop shards.
`mythicmobs`	Boss/event creature rewards via MythicMobs.
`enable-itemsadder` / `enable-mythicmobs`	Toggles for those hooks.

Each source has two parameters: shards (amount) and chance (0.0–1.0 probability).

Example

coal_ore:
  shards: 2
  chance: 0.1
# → 10% chance to get 2 shards on mining coal ore.

MythicMobs example

FrostGiant:
  shards: 50
  chance: 0.5
# → 50% chance to drop 50 shards on kill.

📈 Player feel

Shards create a steady drip of progress—random “sparkles” that make routine actions feel valuable. Tweak weights to balance your economy and combine with Advent/Santa/Snowball for cross-feature synergy.

🧩 Advanced uses

Shops — spend in /shards shop.
Quests — grant via shards give %player% 50.
Bosses — MythicMobs drops shards automatically.

← Previous: Commands & Permissions Next: ShardShop →