UltimateChristmas 4.0 Wiki

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

CommandDoesPermission
/christmas shards [player]Check a balanceultimatechristmas.shards (.others for other players)
/christmas pay <player> <amount>Send shards to another playerultimatechristmas.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