UltimateChristmas 4.0 Wiki

UltimateChristmas / Quests

Quests

Daily, weekly and season objectives. A quest tracks a stat the plugin already records, so adding one is pure YAML — no code, no placeholders, no third-party quest plugin.

module id: quests config: modules/quests.yml

How players use it

/christmas quests (permission ultimatechristmas.quests) opens the objectives menu with live progress. Daily and weekly quests reset automatically on the season clock.

Trackable stats

StatCounts
shards_earnedShards earned from any source
gifts_openedSanta's presents opened
presents_foundHidden presents found
snowballs_hitSnowball hits landed
boss_damageDamage dealt to bosses
bosses_slainBoss kills participated in
advent_claimedAdvent doors opened
ornaments_hungOrnaments hung on the tree
gifts_givenGifts delivered via Secret Santa / pay

Defining an objective

announce-completions: false   # broadcast when someone completes a quest

objectives:
  daily_presents:
    name: "&aFind 3 presents"
    stat: presents_found
    goal: 3
    scope: daily              # daily | weekly | season
    icon: CHEST               # shown in the quest menu
    reward:                   # a standard reward
      shards: 150
      pass-xp: 50

  weekly_boss:
    name: "&4Help defeat a festive boss"
    stat: bosses_slain
    goal: 1
    scope: weekly
    icon: WITHER_SKELETON_SKULL
    reward:
      shards: 500
      pass-xp: 200

  season_generosity:
    name: "&dGive 5 gifts to other players"
    stat: gifts_given
    goal: 5
    scope: season
    reward:
      shards: 600
      pass-xp: 250
      naughty-nice: 10

Give every quest some pass-xp — quests are one of the main engines of festive pass progress, and the loop "do quests → level the pass → claim tiers" is what keeps players logging in.

Admin

/christmas quests reset <player> (permission ultimatechristmas.admin.quests) resets a player's quest progress.