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.