Skip to main content

Resource Pack Manager Troubleshooting

This page only covers behavior that is currently confirmed in the ResourcePackManager codebase.

Players are not receiving the resource pack​

Check these first:

  • autoHost must be enabled if you want ResourcePackManager to send its hosted pack automatically
  • the merged pack must exist and finish uploading successfully
  • players only receive the pack on join, or after a fresh upload during the current runtime

If needed:

  1. Run /rspm reload.
  2. Watch console output for upload or remote-server errors.
  3. Rejoin with a test player after the reload completes.

If you are self-hosting instead of auto-hosting, ResourcePackManager does not push your custom URL for you. In that setup you still need your own server-side pack delivery flow.

ItemsAdder is installed, but its content is missing from the final pack​

This usually means ItemsAdder is still configured in a way that prevents ResourcePackManager from reading or hosting its output.

Use:

/rspm itemsadder configure

That command currently:

  • enables resource-pack.hosting.no-host.enabled
  • disables protection_1, protection_2, and protection_3
  • runs /iazip
  • reloads ResourcePackManager shortly after

If the command tells you ItemsAdder is already hosting its own pack, disable ItemsAdder hosting manually first and run the command again.

The merged pack is invalid or fails to upload​

ResourcePackManager's auto-host integration explicitly handles these server-side error types:

  • missing required files
  • file too large
  • invalid file format
  • missing session
  • remote server unavailable

If you hit one of these:

  1. Run /rspm reload to rebuild the pack.
  2. Check whether one of the source packs is malformed, encrypted, or otherwise unreadable.
  3. Check whether the final merged pack still contains a valid pack.mcmeta and pack.png at the root.

The plugin skips packs it cannot extract cleanly and logs warnings in console when that happens.

One plugin's assets are overriding another plugin's assets​

This is controlled by priorityOrder in:

plugins/ResourcePackManager/config.yml

Higher entries win over lower entries.

For non-mergeable files, ResourcePackManager replaces the lower-priority file. For mergeable JSON files, it merges content instead. The currently mergeable JSON categories are:

  • sounds.json
  • language files
  • vanilla item model JSON in minecraft/models/item
  • atlas files
  • font files
  • 1.21.4+ item model definitions in items/

pack.mcmeta is also merged specially: the highest pack_format wins, supported_formats ranges are widened, and overlay entries are combined.

If you need to inspect what happened during the last merge, check:

plugins/ResourcePackManager/collision_log.txt

GUI text or font-based elements look wrong​

Font files are one of the JSON categories ResourcePackManager merges, but that does not guarantee two different font systems will behave well together in Minecraft.

If a font-driven menu or HUD looks wrong:

  1. Change priorityOrder so the pack you want to win is higher.
  2. Run /rspm reload.
  3. Check collision_log.txt to confirm collisions happened where you expected.

Resource pack changes are not showing up immediately​

ResourcePackManager has a watchdog for supported pack sources.

It waits until a changed pack remains unchanged for 3 seconds, then once all watched packs are stable the remix happens immediately.

If you are actively regenerating another plugin's pack, give it a few seconds after file writes stop. If in doubt, run /rspm reload after the upstream plugin finishes.

Auto-hosting cannot reach the remote server​

ResourcePackManager's built-in host talks to:

https://magmaguy.com/rsp/

If that connection fails, the plugin logs communication warnings and cannot auto-host until it reconnects successfully.

Your options are:

  1. fix the server's outbound HTTPS connectivity
  2. wait for the remote service to become reachable again
  3. disable autoHost and self-host the generated zip instead

I want to self-host the merged pack​

The code-supported setup is:

  1. Set autoHost: false.
  2. Set resourcePackRerouting if you want ResourcePackManager to write an extra copy into an existing folder.
  3. Host ResourcePackManager_RSP.zip yourself.

resourcePackRerouting is resolved relative to the plugins directory, and the target folder must already exist.

I need to inspect what remote data is stored for this server​

Use:

/rspm data_compliance_request

If there is an active remote hosting session, ResourcePackManager downloads the response into:

plugins/ResourcePackManager/data_compliance

If there is no remote session, the command reports that there is no remote data to request.