UltimateChristmas 4.0 Wiki

UltimateChristmas / Community tree

Community tree

One shared tree the whole server decorates together. Players hang ornaments toward a goal; each ornament pays the player who hung it, and when the goal is met, every player online receives the completion reward.

module id: tree config: modules/tree.yml

Setting it up

  1. Build (or pick) your tree in the hub.
  2. Stand next to it and run /christmas tree sethere (permission ultimatechristmas.admin.tree).
  3. Done. The location and progress are saved in the config under state — leave that section to the plugin.

How players use it

/christmas tree hang      hang an ornament (must stand within the radius)
/christmas tree status    progress toward the goal

Permission: ultimatechristmas.tree. Hanging feeds the ornaments_hung stat for quests and leaderboards.

Configuration

goal: 500                 # ornaments needed to fully decorate the tree
radius: 6.0               # how close a player must stand to hang one
cooldown-seconds: 300     # seconds between one player's contributions

# Require a specific item in hand to hang (blank = anything, nothing consumed).
# e.g. "GLOWSTONE_DUST" to make players bring ornaments.
ornament-material: ""

reward:                   # per-ornament, for the player who hangs it
  shards: 25
  nice-points: 1

ambient-particles: true

# The shared reward every online player receives when the tree is completed.
completion-reward:
  gift:
    weight: 1
    shards: 1000
    pass-xp: 300
    items: [ { material: DIAMOND, amount: 4 } ]
    messages: ["&a&lThe tree is complete! Here is your gift."]
    firework: true

Set ornament-material to something craftable or buyable (e.g. glowstone dust, or a custom shop item) and the tree becomes a server-wide resource sink with a shared payoff.

Admin

/christmas tree sethere    place the tree where you stand
/christmas tree reset      reset progress for a new run

Permission: ultimatechristmas.admin.tree. With the music module active, completing the tree also plays a fanfare cue.