Skip to content

Resource Packs

natan307 edited this page Nov 16, 2026 · 1 revision

Resource Packs

Adding packs

Put resource packs in plugins/PackLoader/packs/:

  • a .zip file, or
  • a folder that contains assets/ (and optionally pack.mcmeta).

A zip that contains a single wrapper folder (for example MyPack/assets/...) is detected automatically. __MACOSX, .git, .DS_Store, Thumbs.db and desktop.ini are ignored.

Then run /packloader reload.

Uploading from a browser

  1. Run /packloader upload (console or in game).
  2. Open the link it prints. It is valid for upload.token-expire-minutes.
  3. Choose a .zip and press Upload.

From a terminal:

curl -T mypack.zip http://HOST:8163/upload/<token>/mypack.zip

The file is validated as a zip, saved into packs/, and the pack is rebuilt and resent automatically. A file with the same name is replaced. File names are sanitized to A-Z a-z 0-9 . _ -.

How merging works

Packs are applied in alphabetical order of their file/folder name; later packs override earlier ones. Name packs 01_base.zip, 02_extras.zip if order matters.

A file that exists in several packs is replaced by the later one, except these JSON files, which are merged:

File Merge behaviour
assets/*/lang/*.json keys are combined, later pack wins on a duplicate key
assets/*/sounds.json events are combined, later pack wins on a duplicate event
assets/*/font/*.json providers lists are concatenated
assets/*/atlases/*.json sources lists are concatenated
assets/minecraft/models/item/*.json overrides lists are concatenated

The merge is shallow (top-level keys). If two packs define the same top-level key that is not a list above, the later one wins.

pack.mcmeta is never taken from your packs: PackLoader generates one (or uses plugins/PackLoader/pack.mcmeta if you create it).

Resource path rules

Minecraft only accepts lowercase names. Paths under assets/ must use a-z 0-9 / . _ -. PackLoader logs a warning for every invalid path (first 10 shown) because clients ignore or reject them.

Pack size

Minecraft clients refuse server packs larger than 250 MiB. PackLoader warns when the built pack exceeds that.

Output

The built pack is plugins/PackLoader/generated/pack-<sha1>.zip. It is deterministic: the same inputs give the same SHA-1, so the pack is only resent when something really changed. Old built packs are deleted.

The zip comment contains an author credit; it is not visible to players.

Clone this wiki locally