UltimateChristmas 4.0 Wiki

UltimateChristmas / Resource pack

Resource pack

The built-in model renderer draws the Grinch, his minions and Santa through item displays, which means the player's game needs the model resource pack. Without it a modeled boss or Santa is invisible with only a name tag. This page is the one setup step that matters.

Where to get the pack

You don't download it anywhere: it ships inside the plugin jar. Start the server once with UltimateChristmas installed and it is unpacked to:

plugins/UltimateChristmas/pack/UltimateChristmas-Models.zip

That zip is a normal Minecraft Java resource pack for 1.21.8. Take it from that folder (download it through your host's file manager or SFTP), then get it to your players with one of the options below.

Option A — you don't already use a server resource pack

The plugin sends the pack to every player when they join. You only need to put the zip online once:

  1. Upload the zip to any place that gives a direct download link — a link that starts the download straight away rather than opening a web page. Your own web host, a CDN, GitHub releases, a Dropbox link ending in ?dl=1, or a free pack host such as mc-packs.net all work. Google Drive and normal Dropbox share links do not, because they open a preview page.
  2. Paste the link into plugins/UltimateChristmas/config.yml:
    resource-pack:
      url: "https://yourhost.example/UltimateChristmas-Models.zip"
      required: false   # true kicks players who decline the pack. Usually false.
  3. Restart the server. The console prints Sending the model resource pack to players on join.

The plugin works out the pack's hash from its own copy of the zip, so upload exactly that file — don't unzip, edit or re-zip it, or players' games will reject the download.

What players see

Option B — you already have a server pack

If your server already delivers a pack (ItemsAdder, Oraxen, a custom pack in server.properties), don't send a second one — add ours to it, or merge it in:

Players who already have the pack loaded — however it reached them — see the models. The plugin never forces its own delivery.

When the pack updates

Bundled models, rigs and the pack are versioned by content. When a plugin update changes them, the data-folder copies are refreshed automatically (previous ones are kept in model-backups/). Players must download the updated pack, so after such an update:

The plugin never invents or changes a hosting URL on its own.

Testing it in game

/christmas boss spawn grinch           the full fight
/christmas boss spawn grinch_sneaky    one minion, on its own
/christmas boss animate grinch summon  play any clip once (tab-completes)
/christmas boss animate grinch celebrate
/christmas santa spawn                 Santa at your feet, walking and dropping presents
/christmas santa drop                  watch his drop animation right now

If you see the model animate, delivery works. The animate preview of death holds the pose until the boss is despawned — it does not kill the entity or grant rewards.

Troubleshooting

ProblemFix
Only a floating name tag, no modelThat player doesn't have the pack. Check they accepted the prompt (or enabled Server Resource Packs), and that the URL downloads the zip when opened in a browser.
"Failed to download resource pack"The link isn't a direct download, or the uploaded file differs from plugins/UltimateChristmas/pack/UltimateChristmas-Models.zip. Re-upload that exact file.
Models look broken or purple/blackAn old copy of the pack is cached. Upload the current zip and restart; with a merged pack, re-merge the new version.
Another plugin's pack disappearedTwo plugins are each sending a pack. Use Option B and merge ours into the existing one, with our url left blank.

Skipping models entirely

Set provider: none on any boss in modules/bosses.yml and it falls back to its vanilla mob (a wither skeleton Grinch, and so on). Santa's equivalent is model.provider: none in modules/santa.yml, which makes him a named villager. No pack needed. See Bosses & models for the full provider list, including ModelEngine and BetterModel.