UltimateChristmas 4.0 Wiki

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

IdNameHealthAbilitiesModel
grinchThe Grinch800roar, frost, summonanimated (11 clips)
krampusKrampus1200roar, leap, summon, frostvanilla (piglin brute)
frost_monarchThe Frost Monarch2000frost, roar, summon, leapvanilla (stray)
grinch_sneakyThe Sneaky Elf120—animated minion
grinch_strongThe Strong Minion300—animated minion
grinch_crazyThe Crazy Minion90—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

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

ProviderMeaning
displayThe 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.
modelengineRender via ModelEngine.
bettermodelRender via BetterModel.
autoBuilt-in if a rig is loaded and no model plugin is present; otherwise ModelEngine/BetterModel.
noneAlways the vanilla mob. No pack needed.

The bundled models

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

  1. Author an entity cube project in Blockbench, with named animation clips (any names — you map them in the config).
  2. Drop the .bbmodel into src/main/resources/models/ (building from source) or ask us about precompiled rigs; tools/generate_resourcepack.py compiles per-bone item models, the resource pack, and the runtime rig.
  3. Reference it from a boss: model: { id: your_model, provider: display } and map its clip names under animations.

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.