# Resourcepack is not loading correctly

{% hint style="danger" %}
**Please read this page CAREFULLY before asking for support.**

Most of the times the issue can be easily fixed by reading this page.
{% endhint %}

* 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](https://code.visualstudio.com/))
* 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)

{% hint style="warning" %}

#### Always use the Vanilla client when something is broken!

The log provided by the game will often be asked from support when necessary.\
A non-bloated log is better for supporting you, and finding a solution easily.
{% endhint %}

#### Original launcher

<details>

<summary>Click to expand</summary>

Enable output log

![](https://708574821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-887967055%2Fuploads%2Fgit-blob-27e385328a92ad9990a6e7eea68179610a33dfd2%2Fimmagine.png?alt=media)

Join the server and read the log

![](https://708574821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-887967055%2Fuploads%2Fgit-blob-74d9298ad40b0b0d5bb6c94ca158549ef22617c8%2Fimmagine.png?alt=media)

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.

</details>

#### Any launcher

<details>

<summary>Click to expand</summary>

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.

</details>

## Common issues <a href="#resourcepack-not-loading-i-get-an-error-in-chat" id="resourcepack-not-loading-i-get-an-error-in-chat"></a>

* Be sure to follow all resourcepack hosting [tutorial ](https://itemsadder.devs.beer/plugin-usage/plugin-configuration/resourcepack-hosting)steps.
* If you use [`self-host`](https://itemsadder.devs.beer/plugin-usage/plugin-configuration/resourcepack-hosting/self-hosting) make sure the **port** is opened. Ask your hosting about it.
* 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](https://itemsadder.devs.beer/compatibility-with-other-plugins/compatible/skinsrestorer).
* If get black and purple textures and you are on 1.21.11 or greater [read here](https://itemsadder.devs.beer/faq/multiple-atlases-used-in-model).
* Check if you have another plugin that uses **custom resourcepacks**.\
  **I**f 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](https://itemsadder.devs.beer/adding-content/merge-resourcepacks).
* 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](https://itemsadder.devs.beer/plugin-usage/plugin-configuration/resourcepack-hosting).

### Resourcepack not sent at all <a href="#my-players-cant-see-textures-but-ive-followed-the-whole-tutorial" id="my-players-cant-see-textures-but-ive-followed-the-whole-tutorial"></a>

* 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](https://www.spigotmc.org/resources/resourcepackbroadcast.88318/).\
  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.

### Errors about downloading vanilla assets

Please read the tutorial here.

{% content-ref url="failed-to-download-minecraft-assets" %}
[failed-to-download-minecraft-assets](https://itemsadder.devs.beer/faq/failed-to-download-minecraft-assets)
{% endcontent-ref %}

## Resourcepack not updating after `/iazip`

If you are on **Cloudflare** make sure to use Cache Bypass, clean the cache or implement a custom rule that force no cache on the resourcepack file. Source [here](https://github.com/PluginBugs/Issues-ItemsAdder/issues/3894#issuecomment-2817017486).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://itemsadder.devs.beer/faq/identify-why-textures-are-not-shown.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
