# 材质异常
自 **1.19** 版本起，凡是贴图配置出现问题的，整个游戏的贴图都会无法显示，而不仅限于出现问题的贴图。自 **1.19.3** 版本起，凡是模型配置出现问题（`model_path` 选项）的，整个游戏的自定义模型（即本教程所述的家具）都会无法显示，而不仅限于出现问题的模型（家具）。**Mojang** 更加严格的资源包显示使得我们不得不重视起 **ItemsAdder** 配置严谨性，故在最近的更新中补充此节。
在此之前，我们可以通过出现问题的贴图或者模型快速定位问题根源，而现在是整个游戏的贴图或者模型都出现异常，我们无法判断问题根源。
下面介绍一种判断问题根源的方法，可以通过如下步骤解决这个问题：
* 打开 **Minecraft** 官方启动器。
* 点击 **设置** 按钮，并启用 **当《Minecraft：Java版》启动器时输出日志** 选项。
* 进入游戏，同时会出现一个日志显示框。
* 我们重点关注进入游戏后的日志报错（特别是橙色的！），分析问题所在，笔者某个资源包出现问题，无法加载，经过日志排查发现是因为物品名称不小心输入法输入时首个字母自动大写了。
* 官方 **Wiki** 还介绍了另外一种经常出现的问题，那就是模型文件错误或者你的物品配置中的 `model_path` 填写错误。这种情况下就会出现如下图所示的报错。
## 特别注意
* 如果你使用的是第三方启动器，可以直接打开 **.minecraft** 文件夹，找到 `launcher_log.txt` 文件，不过不会实时更新，定位难，缺点很大。
* 在发现是物品配置错误的问题，例如上文笔者介绍的物品名称有大写字母时，你还需要修改 **ItemsAdder** 自动生成的模型文件等。**ItemsAdder** 不会自动更新它们的！它们通常位于 `各个包的文件夹/resourcepack/namespace名称/models/auto_generated` 文件夹，如果你不会修改，可以直接删除所有这种名称的文件夹。
* 如果一直不能解决问题，可以尝试检查 **storage** 文件夹内储存的数据，还是以上文笔者遇到情况为例，这里的 `real_blocks_note_ids_cache.yml` 会记录物品名称和对应的 **CustomModelData**，有可能这里的物品名称还是没有更新，需要手动更新。实在不行可以删除 **storage** 文件夹，不过这会导致以前玩家放置的方块、家具，以及贴图等都会被打乱，不到万不得已不要这么做！
---
# 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://docs.superiormc.cn/itemsadder-doc/ji-chu-shi-yong/cai-zhi-yi-chang.md?ask=
```
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.