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:
- 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. - 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.
- 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
- On join they get a "This server recommends a custom resource pack" prompt. Clicking Yes downloads it once; later joins use the cached copy.
- A player who clicked No can turn it back on: in the Multiplayer list, select the server, click Edit and set Server Resource Packs to Enabled, then rejoin.
- Players can also install it by hand: put
UltimateChristmas-Models.zipin their.minecraft/resourcepacksfolder and enable it under Options → Resource Packs. Handy for testing on your own client.
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:
- Merge (recommended). Unzip
UltimateChristmas-Models.zipand copy itsassets/folder into your existing pack. The files are namespaced, so nothing collides with your own assets. Re-zip, re-hash and re-host your pack the way you normally do — and leaveresource-pack.urlin ourconfig.ymlblank so the plugin doesn't push a second pack. - ItemsAdder / Oraxen. Drop the pack's contents into the folder your pack tool merges from, and let it rebuild the combined pack.
- Multiple server packs. Clients on 1.20.3+ can load several server packs, so you can also push ours alongside yours if your setup manages multi-pack delivery. Merging stays the simplest route and works for every client.
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:
- Option A: upload the new zip from
plugins/UltimateChristmas/pack/over the old one at the same URL, then restart. The plugin picks up the new hash, so players download the new version on their next join. - Option B: re-merge the new zip into your pack and re-publish it.
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
| Problem | Fix |
|---|---|
| Only a floating name tag, no model | That 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/black | An 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 disappeared | Two 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.