UltimateChristmas / Bosses & models
Bosses & animated models
Six festive fights ship ready to run, and four of them wear fully animated Blockbench models rendered by the plugin's own engine — no ModelEngine or BetterModel required. Loot goes to the players who actually fought.
module id: bosses config: modules/bosses.yml models: models/ + models/README.txt
The bosses
| Id | Name | Health | Abilities | Model |
|---|---|---|---|---|
grinch | The Grinch | 800 | roar, frost, summon | animated (11 clips) |
krampus | Krampus | 1200 | roar, leap, summon, frost | vanilla (piglin brute) |
frost_monarch | The Frost Monarch | 2000 | frost, roar, summon, leap | vanilla (stray) |
grinch_sneaky | The Sneaky Elf | 120 | — | animated minion |
grinch_strong | The Strong Minion | 300 | — | animated minion |
grinch_crazy | The Crazy Minion | 90 | — | animated minion |
The three minions are summonable on their own as mini-bosses, so you can inspect each model and its animations in isolation.
Running fights
/christmas boss the control-center GUI: summon, inspect,
teleport to, and despawn bosses live
/christmas boss spawn <id> summon where you stand
/christmas boss despawn <id> remove without rewards
/christmas boss list what is alive right now
/christmas boss animate <id> <clip> play any model clip once (tab-completes)
Permission: ultimatechristmas.admin.boss.
The animate preview of death holds the defeat pose until the boss is despawned — it does not kill the entity or grant rewards. Normal deaths are driven by the actual kill.
Fight mechanics
ability-interval-seconds: 12 # seconds between ability uses taunt: true # broadcast spawn and death lines remove-minions-on-death: true # clear summoned minions when the boss dies
- Abilities — any mix of
roar(knockback),frost(slowing storm),leapandsummon(minion waves). - Minion waves — the Grinch's
summoncycles through the three minion types, using each one's own model and stats athealth-multiplier: 0.35of its standalone health. At most eight summoned minions near the boss at once, and cleanup only ever touches the minions of that particular encounter. - Loot — shared among the top
reward-top-contributorsdamage dealers. Each winner rolls one bucket from the weighted reward table.
A full boss entry
bosses:
grinch:
display-name: "&2&lThe Grinch"
entity-type: WITHER_SKELETON # the base mob under the model
health: 800 # Minecraft caps mob health at 1024;
speed: 0.18 # the plugin warns if capped
hitbox-scale: 1.25
attack-damage: 9
glowing: true
abilities: [roar, frost, summon]
reward-top-contributors: 5
minions:
types: [grinch_sneaky, grinch_strong, grinch_crazy]
health-multiplier: .35
spawn-messages:
- "&2The Grinch:&7 Ho ho - NO. No Christmas this year!"
death-messages:
- "&aThe Grinch's heart grows three sizes... he retreats for now."
rewards:
shards_big: { weight: 40, shards: 150-300 }
diamonds: { weight: 30, shards: 50,
items: [ { material: DIAMOND, amount: 6 } ] }
title: { weight: 10, shards: 500, pass-xp: 300, firework: true,
messages: ["&6You are now a &eGrinch Slayer&6!"] }
Animated models
A boss can wear a Blockbench model with real animation clips. The model section picks the model and the renderer:
model:
id: grinch
provider: display # see providers below
scale: 1.0 # tune if the model is too big or small
offset-y: 0.0 # lift so the feet meet the ground
yaw-offset: 180 # flip if the model faces backwards
run-speed-threshold: .32 # blocks/tick where walk becomes run
movement-animation-speed: .85 # locomotion playback rate
rage-health-threshold: .35 # when the rage clip fires
animations: # map states/events to the model's clip names
idle: idle
walk: walk
run: run
attack: attack # played when the boss lands a hit
spawn: laugh # played once when it appears
hurt: hurt # nonfatal incoming damage
death: death # finishes even after the base mob dies
rage: rage # once when crossing rage-health-threshold
victory: celebrate # when this boss kills a player
carry: carry_present # minion idle pose outside combat
ability-animations: # play a clip when an ability fires
summon: summon
roar: laugh
frost: steal # a reaching gesture accompanies the frost cast
Providers
| Provider | Meaning |
|---|---|
display | The plugin's own renderer. No third-party plugin; plays the model's animations (idle/walk/run automatically, event clips on triggers). Needs the resource pack on the client. |
modelengine | Render via ModelEngine. |
bettermodel | Render via BetterModel. |
auto | Built-in if a rig is loaded and no model plugin is present; otherwise ModelEngine/BetterModel. |
none | Always the vanilla mob. No pack needed. |
The bundled models
grinch— clips: idle, walk, run, attack, laugh, summon, steal, hurt, rage, death, celebrate.grinch_minion_sneaky,grinch_minion_strong,grinch_minion_crazy— clips: idle, walk, run, attack, laugh, carry_present, hurt, death.santa_claus— clips: idle, walk, wave, laugh, drop_gift, give_gift, interact, celebrate. Used by the Santa NPC, configured inmodules/santa.yml.
Animation events, as wired by default: idle/walk/run come from actual movement; attack on a melee hit; hurt on nonfatal damage; laugh on spawn; summon on the summon ability; steal on the frost cast; rage once below 35% health; celebrate after killing a player; death plays out fully after the kill; minions hold carry_present while resting without a combat target.
Bringing your own models
- Author an entity cube project in Blockbench, with named animation clips (any names — you map them in the config).
- Drop the
.bbmodelintosrc/main/resources/models/(building from source) or ask us about precompiled rigs;tools/generate_resourcepack.pycompiles per-bone item models, the resource pack, and the runtime rig. - Reference it from a boss:
model: { id: your_model, provider: display }and map its clip names underanimations.
The compiler supports cube geometry, per-face UVs, arbitrary rest rotations, numeric rotation/position/scale tracks and loop/once/hold — and rejects unsupported features loudly instead of dropping them silently. Full details live in models/README.txt in the data folder.
Minecraft caps a mob's base health at 1024. Configure more and the plugin warns and caps; for larger numbers, scale damage instead, or use a MythicMobs base.
Music during fights
With the music module active, a fanfare plays when a boss spawns and a battle theme (Winter Siege) plays during the fight — both configurable per cue.