UltimateChristmas 4.0 Wiki

UltimateChristmas / Hidden presents

Hidden presents

Presents are hidden near online players in waves. They are marker entities — no blocks are placed in the world — opened by right-clicking or hitting them, and each one rolls its contents fresh from a weighted table.

module id: presents config: modules/presents.yml

How players use it

Watch for the wave announcement, find the floating present, right-click or hit it. /christmas presents (permission ultimatechristmas.presents) shows how many are hidden right now. Finding presents also feeds the presents_found stat for quests, the pass and leaderboards.

Spawning

spawn-interval-seconds: 600  # how often a wave appears
per-spawn: 2                 # presents per wave
max-active: 12               # most hidden at once

icon: RED_SHULKER_BOX        # the block shown floating on each marker

# Hide presents near online players (recommended) rather than near world spawn.
near-players: true
min-distance: 24
max-distance: 120

announce: true               # broadcast when a wave appears

hologram:
  enabled: true
  text: "&c&l✦ &aPresent &c&l✦"

region: ""                   # confine to a WorldGuard region (blank = anywhere)
worlds: []                   # worlds presents may appear in (empty = all)

What's inside

A weighted reward table, rolled per present. The default runs common → uncommon → rare → epic (which broadcasts) → a 1-weight lump of coal:

rewards:
  common:
    weight: 45
    shards: 25-75
    items: [ { material: COOKIE, amount: 4 } ]
  rare:
    weight: 18
    shards: 200-400
    pass-xp: 50
    items: [ { material: DIAMOND, amount: 2 } ]
    firework: true
  epic:
    weight: 6
    shards: 500-800
    pass-xp: 100
    items: [ { material: ENCHANTED_GOLDEN_APPLE, amount: 1 } ]
    broadcast: ["&6%player% &efound an epic present!"]
    firework: true
  coal:
    weight: 1
    shards: 5
    naughty-nice: -1
    messages: ["&8Just a lump of coal. Unlucky!"]

Admin commands

/christmas presents status    counts and locations summary
/christmas presents spawn     force a wave right now
/christmas presents clear     remove every hidden present

Permission: ultimatechristmas.admin.presents.