UltimateChristmas 4.0 Wiki

Wiki / UltimateChristmas

UltimateChristmas 4.0

A complete Christmas event system for Paper 1.21+ servers: an animated Grinch raid boss with three minions, an advent calendar, a wandering Santa, a festive battle pass, 23 note-block carols, and more — organized as 20 independent modules you can switch on and off live.

Requirements

Optional plugins are detected automatically at startup; the console log lists which integrations are active:

PluginWhat it adds
NoteBlockAPIPlays the 23 bundled carols (the music module is silent without it)
LuckPermsGroup-specific reward tables
VaultLets shop entries be priced in server currency
PlaceholderAPIFestive placeholders for scoreboards and holograms
WorldGuardRegion limits for Santa, presents and the tree
LibsDisguisesGives the Santa NPC a player skin (plain villager without it)
MythicMobsShard rewards from your custom mobs
ItemsAdderShard rewards from your custom blocks
ModelEngine / BetterModelAlternative renderers for boss models — never required

Quick start

  1. Drop UltimateChristmas-4.0.0.jar into plugins/ and start the server.
  2. Set up the resource pack so players see the animated bosses. This is the only real setup step.
  3. Check the season clock in config.yml (timezone, start date, Christmas Day).
  4. Run /christmas in game for the full help menu. Aliases: /uc, /xmas.
  5. Try it: /christmas boss spawn grinch.

The modules

Each feature is documented on its own page, with its commands, permissions and full configuration. Manage them with the module system.

ModuleIn one line
economyShards, a festive currency earned from blocks and mobs
shopSanta's Workshop — a tabbed GUI store priced in shards or money
adventA 25-door advent calendar with streaks and catch-up
santaAn animated, wandering Santa who drops presents on the ground
bossesThe Grinch, Krampus and the Frost Monarch — with animated models
presentsHidden presents that spawn near players in waves
questsDaily, weekly and season objectives over tracked stats
passA festive battle pass with free and premium tiers
cosmeticsFestive hats and particle trails
treeA community tree the whole server decorates together
secretsantaAn anonymous gift exchange between players
snowballRewarded snowball fights and trick snowballs
feastsFestive food and drink with buffs
music23 bundled carols, a radio playlist, and automatic music cues
snowPersonal snowfall, optional ground snow, admin blizzards
ambienceJoin greetings and distant sleigh bells during the season
countdownA boss-bar countdown and a midnight firework show
leaderboardBoards over any tracked stat
adminThe command router, module control and diagnostics (see module system)
platformShared core: season clock, storage, reward engine (see installation)

How the configs fit together

Only genuinely global settings live in config.yml: the season clock, the currency name, player storage, and the resource-pack URL. Everything else lives in modules/<name>.yml, one file per module, heavily commented. Every reward in every module uses the same reward format — learn it once and you can configure the whole plugin.