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
- A Paper server, API version 1.21+.
- Nothing else. The plugin has no required dependencies — the boss models render through its own built-in engine, so ModelEngine and BetterModel are optional.
Optional plugins are detected automatically at startup; the console log lists which integrations are active:
| Plugin | What it adds |
|---|---|
| NoteBlockAPI | Plays the 23 bundled carols (the music module is silent without it) |
| LuckPerms | Group-specific reward tables |
| Vault | Lets shop entries be priced in server currency |
| PlaceholderAPI | Festive placeholders for scoreboards and holograms |
| WorldGuard | Region limits for Santa, presents and the tree |
| LibsDisguises | Gives the Santa NPC a player skin (plain villager without it) |
| MythicMobs | Shard rewards from your custom mobs |
| ItemsAdder | Shard rewards from your custom blocks |
| ModelEngine / BetterModel | Alternative renderers for boss models — never required |
Quick start
- Drop
UltimateChristmas-4.0.0.jarintoplugins/and start the server. - Set up the resource pack so players see the animated bosses. This is the only real setup step.
- Check the season clock in
config.yml(timezone, start date, Christmas Day). - Run
/christmasin game for the full help menu. Aliases:/uc,/xmas. - 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.
| Module | In one line |
|---|---|
| economy | Shards, a festive currency earned from blocks and mobs |
| shop | Santa's Workshop — a tabbed GUI store priced in shards or money |
| advent | A 25-door advent calendar with streaks and catch-up |
| santa | An animated, wandering Santa who drops presents on the ground |
| bosses | The Grinch, Krampus and the Frost Monarch — with animated models |
| presents | Hidden presents that spawn near players in waves |
| quests | Daily, weekly and season objectives over tracked stats |
| pass | A festive battle pass with free and premium tiers |
| cosmetics | Festive hats and particle trails |
| tree | A community tree the whole server decorates together |
| secretsanta | An anonymous gift exchange between players |
| snowball | Rewarded snowball fights and trick snowballs |
| feasts | Festive food and drink with buffs |
| music | 23 bundled carols, a radio playlist, and automatic music cues |
| snow | Personal snowfall, optional ground snow, admin blizzards |
| ambience | Join greetings and distant sleigh bells during the season |
| countdown | A boss-bar countdown and a midnight firework show |
| leaderboard | Boards over any tracked stat |
| admin | The command router, module control and diagnostics (see module system) |
| platform | Shared 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.