本帖最后由 pXiaoD 于 2023-1-26 15:29 编辑
不同于 Wiki，本篇教程注重点在于系统性的概述 ItemsAdder 的各个功能，为初学者带来一次跨越整个插件的基础使用指导，以便于后续学习研究。教程适合一次性按顺序阅读，因为不是 Wiki，前文已经提及的内容在后文只会概括性的介绍，因此本文更是一种引导而不是手册。
目录
第一章：首次使用
为初学者从零开始进行首次使用前的系统性指导。
第二章：基础使用
为初学者概况 ItemsAdder 配置的组成，阅读完以后可以看懂别人所给的配置的各个地方是干什么的。
第三章：贴图
由概念到实例的介绍替换 font 的用法。
第四章：物品
由概念到示例的介绍 ItemsAdder 的自定义物品，并介绍如何第三方挂钩方面的内容。
第五章：方块
就物品一章拓展而来，带来方块的额外属性和其他用法。
第六章：家具
就物品一章拓展而来，带来家具的额外属性和其他用法。
第七章：配方
就物品的合成配方的用法做出讲解。
第八章：事件
就物品单独的事件属性做出一章讲解，并以实例带入到方块、家具中。
第九章：原版
就一些原版的内容开始讲解，例如音效、Tooltip等，并融入到 ItemsAdder 中。
阅读
离线阅读版
ItemsAdder 使用指导 pdf离线版.zip
(2.55 MB, 下载次数: 299)
Gitbook 在线阅读版
实时更新，最近更新于：2023/1/16
来自群组: Complex Studio
ItemsAdder 使用指导
不同于 Wiki，本篇教程注重点在于系统性的概述 ItemsAdder 的各个功能，为初学者带来一次跨越整个插件的基础使用指导，以便于后续学习研究。教程适合一次性按顺序阅读，因为不是 Wiki，前文已经提及的内容在后文只会概括性的介绍，因此本文更是一种引导而不是手册。
目录
第一章：首次使用
为初学者从零开始进行首次使用前的系统性指导。
第二章：基础使用
为初学者概况 ItemsAdder 配置的组成，阅读完以后可以看懂别人所给的配置的各个地方是干什么的。
第三章：贴图
由概念到实例的介绍替换 font 的用法。
第四章：物品
由概念到示例的介绍 ItemsAdder 的自定义物品，并介绍如何第三方挂钩方面的内容。
第五章：方块
就物品一章拓展而来，带来方块的额外属性和其他用法。
第六章：家具
就物品一章拓展而来，带来家具的额外属性和其他用法。
第七章：配方
就物品的合成配方的用法做出讲解。
第八章：事件
就物品单独的事件属性做出一章讲解，并以实例带入到方块、家具中。
第九章：原版
就一些原版的内容开始讲解，例如音效、Tooltip等，并融入到 ItemsAdder 中。
阅读
离线阅读版
ItemsAdder 使用指导 pdf离线版.zip
(2.55 MB, 下载次数: 299)
Gitbook 在线阅读版
实时更新，最近更新于：2023/1/16
来自群组: Complex Studio
**ing crazy
谢谢，懂了
辛苦了 感谢你的编写
非常强，建议反复观看
太猛了，了解了基本的东西
本帖最后由 pXiaoD 于 2023-1-26 21:52 编辑
2023/1/16 更新补充内容
在本回复只列出新增加的章节，大量章节有所更新，可见新的离线版本：
ItemsAdder 使用指导 最新 3.3.x 版本.zip
(1.54 MB, 下载次数: 39)
总体配置结构了解
在阅读完 首次使用 一章后，恭喜你来到了第二章。在本章你将基础地掌握 ItemsAdder 的一些基础知识。
ItemsAdder 插件内的大概框架
在此之前，我们需要了解 ItemsAdder 文件夹内的大概框架。请注意，是大概。各个文件的具体作用，将在后文陆续揭秘，此时的你不宜了解太多。
我们会发现该文件夹下有以下部分组成：
以上 6 个文件，在你基础的配置完 ItemsAdder 以后，基本只会看 contents 文件夹内的内容了，所以整个插件并不难，需要的是前期你的耐心。
contents 文件夹
那么，很显然，contents 文件夹是我们关注的重心，所以我们还需要对它进行研究分析，请再次打开它，我们可以发现里面包括一个名字为 _iainternal 的文件夹，这是 ItemsAdder 为你提供的基础包。
从这我们似乎不能发现什么，你可以 点击这里 下载 ItemsAdder 为你提供的示例配置。
打开示例配置，我们不难发现，contents 文件夹内包含的是其他若干文件夹，这些文件夹对应一个新的概念：包，你可以做物品包、盔甲包，这些文件夹名称就是包的名称。
包文件夹内的组成
打开任意一个包所对应的文件夹，我们发现它由如下 2 个文件夹组成：
resourcepack 文件夹
我们先不着急 configs 文件夹包括的物品配置文件的学习，因为下面我们重点学习的就是这个，在此之前，我们先来把目光投放到 resourcepack 文件夹身上。我们需要了解一个新的概念，我们称为 namespace，中文意思为命名空间。
我们随意打开一个网上下载的资源包，发现一进入压缩包预览页面，映入眼帘的往往是一个 minecraft 文件夹，这就是 Minecraft 原版自身给自己的命名空间，游戏自身会在这个命名空间内找到自己所要的纹理、模型、音效等等。
而我们自己也可以创建一个新的命名空间，把自己想要增加的纹理、模型、音效等等放入进去，更好的管理它们，在需要修改、删除它们时能快速定位到其所在目录。
在上文我们已经介绍了包的概念，各个包下的 resourcepack 文件夹正是子资源包，而打开这个文件夹映入眼帘的正是 namespace！
包和 namespace 的关系
首先是包的作用。例如，你可以把一些武器放在一起，再把另外的盔甲放在一起，这时，包的作用就是分类了。ItemsAdder 并不限制你的包到底是怎么区分的，但很显然在这里，笔者推荐你使用“物品分类”进行配置。
这些由你想设置的包的名称和各包下 resourcepack 文件夹下的 namespace 不必一模一样，但在本教程为了培养良好习惯，全部默认只能一样且一一对应。namespace 用于插件内部管理，而玩家无法看到，所以你不必填写中文，也不能使用中文，只能是 小写英文、数字和下划线 组成。
在使用插件各个指令，或者配置 ItemsAdder 内物品，乃至与 ItemsAdder 挂钩（兼容）的插件时，我们在填写 ItemsAdder 物品的名称时，非常建议你写 namespace:id 的格式，例如 weapon:starter_sword。namespace 即是文件夹的名称，id 即是物品的ID。
关于各包 resourcepack 文件夹的各命名空间下的具体结构，将在后文中陆续介绍。
2023/1/16 更新补充内容
在本回复只列出新增加的章节，大量章节有所更新，可见新的离线版本：
ItemsAdder 使用指导 最新 3.3.x 版本.zip
(1.54 MB, 下载次数: 39)
总体配置结构了解
在阅读完 首次使用 一章后，恭喜你来到了第二章。在本章你将基础地掌握 ItemsAdder 的一些基础知识。
ItemsAdder 插件内的大概框架
在此之前，我们需要了解 ItemsAdder 文件夹内的大概框架。请注意，是大概。各个文件的具体作用，将在后文陆续揭秘，此时的你不宜了解太多。
我们会发现该文件夹下有以下部分组成：
- contents 文件夹。这是贯彻整个教程的文件夹，也是整个插件的核心所在。这里保存着所有 ItemsAdder 你所添加的内容的配置。
- lang 文件夹。是英文单词 language（语言）的缩写，现在不用我说，你也知道这是干什么的吧。
- storage 文件夹。这是保存 ItemsAdder 一些缓存记录的数据的地方，在教程没有特别标注的地方，请不要动这里。轻则物品的 CustomModelData 值全部被打乱，重则你的资源包就因此报废了，你要花上一整天时间去修补到底哪里不小心出现问题了。（此时的你可能看不懂到底是什么，总之记得这里很危险，不要乱动，就对了）
- output 文件夹。你第一次使用时可能看不到这个文件夹，它的作用笔者将在后文揭秘。
- config.yml 文件。是英文单词 configuration（配置）的缩写，同样不用我说了。
- ia_gui.yml 文件。配置 /ia 指令后打开的各种 UI 的文件。
以上 6 个文件，在你基础的配置完 ItemsAdder 以后，基本只会看 contents 文件夹内的内容了，所以整个插件并不难，需要的是前期你的耐心。
contents 文件夹
那么，很显然，contents 文件夹是我们关注的重心，所以我们还需要对它进行研究分析，请再次打开它，我们可以发现里面包括一个名字为 _iainternal 的文件夹，这是 ItemsAdder 为你提供的基础包。
从这我们似乎不能发现什么，你可以 点击这里 下载 ItemsAdder 为你提供的示例配置。
打开示例配置，我们不难发现，contents 文件夹内包含的是其他若干文件夹，这些文件夹对应一个新的概念：包，你可以做物品包、盔甲包，这些文件夹名称就是包的名称。
包文件夹内的组成
打开任意一个包所对应的文件夹，我们发现它由如下 2 个文件夹组成：
- configs 文件夹：这个包的物品配置文件所在的文件夹，一个包可以由若干物品配置文件，物品配置文件不止止是物品，还有其他内容，只是为了方便理解叫做物品配置文件，你可以在下一节快速了解一下它。
- resourcepack 文件夹：这个包的资源包所在的文件夹。ItemsAdder 最终发给玩家的资源包是所有包的子资源包打包后自动生成的，这时 output 文件夹作用就体现出来了：它的作用就是存放这些包的子资源包最终打包生成的总资源包。
resourcepack 文件夹
我们先不着急 configs 文件夹包括的物品配置文件的学习，因为下面我们重点学习的就是这个，在此之前，我们先来把目光投放到 resourcepack 文件夹身上。我们需要了解一个新的概念，我们称为 namespace，中文意思为命名空间。
我们随意打开一个网上下载的资源包，发现一进入压缩包预览页面，映入眼帘的往往是一个 minecraft 文件夹，这就是 Minecraft 原版自身给自己的命名空间，游戏自身会在这个命名空间内找到自己所要的纹理、模型、音效等等。
而我们自己也可以创建一个新的命名空间，把自己想要增加的纹理、模型、音效等等放入进去，更好的管理它们，在需要修改、删除它们时能快速定位到其所在目录。
在上文我们已经介绍了包的概念，各个包下的 resourcepack 文件夹正是子资源包，而打开这个文件夹映入眼帘的正是 namespace！
包和 namespace 的关系
首先是包的作用。例如，你可以把一些武器放在一起，再把另外的盔甲放在一起，这时，包的作用就是分类了。ItemsAdder 并不限制你的包到底是怎么区分的，但很显然在这里，笔者推荐你使用“物品分类”进行配置。
这些由你想设置的包的名称和各包下 resourcepack 文件夹下的 namespace 不必一模一样，但在本教程为了培养良好习惯，全部默认只能一样且一一对应。namespace 用于插件内部管理，而玩家无法看到，所以你不必填写中文，也不能使用中文，只能是 小写英文、数字和下划线 组成。
在使用插件各个指令，或者配置 ItemsAdder 内物品，乃至与 ItemsAdder 挂钩（兼容）的插件时，我们在填写 ItemsAdder 物品的名称时，非常建议你写 namespace:id 的格式，例如 weapon:starter_sword。namespace 即是文件夹的名称，id 即是物品的ID。
关于各包 resourcepack 文件夹的各命名空间下的具体结构，将在后文中陆续介绍。
本帖最后由 pXiaoD 于 2023-1-26 15:38 编辑
资源包合并
资源包合并是我们在使用 ItemsAdder 时经常遇到的问题。以插件挂钩为例，如果我们想要和其他也需要使用资源包的插件同时使用，那么就必须学会资源包合并。
v.3.3.0 版本以前
见离线版本。
v.3.3.0 版本以后
v.3.3.0 以后版本合并资源包就非常轻松了，你只需要创建新的包，然后将需要合并的资源包的 assets 文件夹放入这个包的 resourcepack 文件夹内即可。这也是插件作者做出重大改动的原因所在——方便合并资源包。
资源包合并
资源包合并是我们在使用 ItemsAdder 时经常遇到的问题。以插件挂钩为例，如果我们想要和其他也需要使用资源包的插件同时使用，那么就必须学会资源包合并。
v.3.3.0 版本以前
见离线版本。
v.3.3.0 版本以后
v.3.3.0 以后版本合并资源包就非常轻松了，你只需要创建新的包，然后将需要合并的资源包的 assets 文件夹放入这个包的 resourcepack 文件夹内即可。这也是插件作者做出重大改动的原因所在——方便合并资源包。
资源包结构了解
一个资源包由任意命名空间组成，原版自身使用了 minecraft 命名空间，即一打开资源包出现的 minecraft 文件夹。
各命名空间下常用的文件夹是：
一个资源包由任意命名空间组成，原版自身使用了 minecraft 命名空间，即一打开资源包出现的 minecraft 文件夹。
各命名空间下常用的文件夹是：
- models 文件夹：存放模型文件的地方。
- textures 文件夹：存放纹理文件（即材质图片）的地方。
- sounds 文件夹：存放音效文件的地方。
- lang 文件夹：存放语言文件的地方。
本帖最后由 pXiaoD 于 2023-1-26 21:01 编辑
材质异常
自 1.19 版本起，凡是贴图配置出现问题的，整个游戏的贴图都会无法显示，而不仅限于出现问题的贴图。自 1.19.3 版本起，凡是模型配置出现问题（model_path 选项）的，整个游戏的自定义模型（即本教程所述的家具）都会无法显示，而不仅限于出现问题的模型（家具）。Mojang 更加严格的资源包显示使得我们不得不重视起 ItemsAdder 配置严谨性，故在最近的更新中补充此节。
在此之前，我们可以通过出现问题的贴图或者模型快速定位问题根源，而现在是整个游戏的贴图或者模型都出现异常，我们无法判断问题根源。
下面介绍一种判断问题根源的方法，可以通过如下步骤解决这个问题：
特别注意
材质异常
自 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 文件夹，不过这会导致以前玩家放置的方块、家具，以及贴图等都会被打乱，不到万不得已不要这么做！
本帖最后由 Annijang 于 2023-2-2 14:05 编辑
真不错，也可以作为的那itemsadder插件的一个补充，加油呀。前面的那几张在我的itemsadder帖子里有讲解，只是相比于后面那几章事件什么的，我不知道咋描述qwq
真不错，也可以作为的那itemsadder插件的一个补充，加油呀。前面的那几张在我的itemsadder帖子里有讲解，只是相比于后面那几章事件什么的，我不知道咋描述qwq