Resourcepack is not loading correctly

Please read this page CAREFULLY before asking for support.

  • resourcepack not loaded at all

  • an error shown fullscreen when the player joins

  • black and purple texture is shown

  • your model doesn't load correctly

  • the pack failed to load

  • custom sounds don't play

  • infinite resourcepack loading glitch

How to read the SERVER logs

  • run the command /iazip

  • wait it to finish

  • read your server console or open the file logs/latest.log using any text editor (for example VSCode)

  • check if any error or warning was thrown and read them carefully, they contain useful information most of the times

How to read the CLIENT logs (not SERVER)

Always use the Vanilla client when something is broken!

Any launcher:

Join the server and let the pack load. Open your Minecraft GAME log file, not server logs. It is usually located here: %appdata%\.minecraft\logs\latest.log You can clearly see which files failed to load and why, the errors are clear in most of the cases.

Original launcher:

Enable output log

Join the server and read the log

You can clearly see which files failed to load and why. The errors are clear in most of the cases.

In this example I had two broken files gem_vending_machine and whitebathroom_sink. The error tells me that the JSON files are broken, they probably have bad characters inside or they are corrupted.

"Resourcepack not loading, I get an error"

  • Make sure you're not using UPPERCASE, space or special characters in items names, namespaces, texture files (png) and model files (json). For example an ID for a custom item: CustomSword is wrong, use custom_sword.

  • If you have SkinsRestorer please read here.

  • Check if you have another plugin that uses custom resourcepacks. If you have a similar plugins please disable its resourcepack feature or ItemsAdder won't be able to apply the pack correctly. If you want to apply both packs read here.

  • Make sure you don't have any resourcepack set in the server.properties file.

  • Minecraft limits servers resourcepacks size to 50MB on Minecraft 1.14, 100MB on 1.15+ and 250MB on 1.18+. Make sure to compress your textures and your music files before creating the zip file.

  • Run /iainfo command and make sure the resourcepack URL is reachable from your browser and it directly downloads the resourcepack .zip file. If you paste the link on your browser (Firefox/Chrome) you must instantly see the download start. If you see a download page with buttons it is an invalid URL. Read the resourcepack hosting tutorials.

  • Be sure to follow all resourcepack hosting tutorial steps.

  • If you use self-host make sure the port is opened. Ask your hosting about it.

"My players can't load the resourcepack! I've followed the whole tutorial"

  • Enable the resourcepack in the server list settings: http://imgur.com/a/SG0AU

  • Make sure you don't have any inventory (GUI) or book opening on join. This can cause the resourcepack prompt to disappear and the player won't be able to click on it. In order to fix this you can use the free plugin ResourcePackBroadcast. This allows you to run commands as soon as the resourcepack is accepted (and various other features).

  • Increasing the delay-ticks in config.yml of ItemsAdder to 10 or greater.

  • Leave the server, go to %appdata%/.minecraft/server-resource-packs and delete everything. Then join the server again.

Last updated

Was this helpful?