Minecraft 自定义物品材质：服务器主完整指南（2026）
本文译自英文。阅读原文。
自定义物品材质能让服务器里的物品显得更真实：一把katana看起来就是一把真正的katana，而不是一把改了名字的铁剑。好消息是，你不需要模组，而且从 Minecraft 1.20.5+ 开始，你甚至不需要自己托管资源包。
下面介绍整个系统的工作原理，以及每个服务器版本下最快的实现方式。
快速解答
自定义物品材质在 Minecraft 服务器上分为两个部分：
- 物品携带一个材质引用：
CustomModelData（1.13 – 1.21.3）或物品模型组件（1.21.4+）。 - 资源包将该引用映射到你的材质文件，服务器会在玩家加入时把资源包发送给他们。
无需客户端模组。ExecutableItems 等插件会为你分配这个引用，并且从 1.20.5+ 开始，还能通过配置中的 URL 自动托管资源包。如果你不想自己绘制材质，在 1.21.4+ 上还附带 60 多种内置 3D 武器材质。
自定义物品材质的实际工作原理
Minecraft 客户端会根据已加载的资源包来渲染物品。服务器资源包会在玩家加入时自动下载并应用（玩家只需接受一次）。你的资源包包含：
- 材质（PNG 文件，通常为 16×16 或 32×32），
- 模型（JSON 文件，描述材质如何包裹物品：平面、手持或完整 3D），
- 映射，即声明“当物品带有引用 X 时，使用这个模型”。
物品这一侧需要插件来完成：它负责创建物品并为其写入正确的引用，让客户端加载你的模型，而不是原版模型。
CustomModelData 与物品模型（1.21.4 的变化）
| 服务器版本 | 系统 | 工作方式 |
|---|---|---|
| 1.13 – 1.21.3 | CustomModelData | 物品上带有一个数字；资源包中的 overrides 数组将数字映射到模型 |
| 1.21.4+ | 物品模型组件 | 物品上直接带有模型引用，更简洁，无需处理繁琐的覆盖 |
如果你使用的是 1.21.4+，请参考 1.21.4+ 材质指南；对于旧版本，CustomModelData 分步指南会带你从零开始构建资源包，其中包括动画材质和按状态切换的材质（例如拉弓时会变化的弓，参见弓材质指南）。
三种方式，从最简单到最高度自定义
1. 使用内置材质（无需任何工作）
ExecutableItems Premium 在 1.21.4+ 上附带 60 多种现成的 3D 武器材质。在物品编辑器中选择一种即可，无需构建资源包，也无需托管。
2. 自动托管资源包（自带材质，省去托管）
从 Minecraft 1.20.5+ 开始，ExecutableItems 可以通过配置中的 URL 提供自己的资源包。放入你的材质，插件会负责打包并分发给玩家。旧版本的托管资源包流程请参见上传材质包。
3. 完全自定义的资源包（完全掌控）
自己构建资源包：材质、模型、映射，然后托管并在 server.properties 中设置。当自定义物品只是更大范围视觉改造（自定义 GUI、字体、音效）的一部分时，这是合适的方式。通用物品指南涵盖了完整的 11 步流程。
想直接购买而不是自己制作？可直接用于服务器的材质包自带材质、3D 模型和物品配置，并附带可用于你自己服务器的许可证。
与其他材质插件搭配使用
已经在使用 ItemsAdder 或 Nexo 做外观装饰了？它们可以与 ExecutableItems 良好共存：EI 可以在条件和能力中引用第三方物品，因此由 ItemsAdder 负责视觉效果，由 EI 提供行为逻辑。关于它们如何分工，请参见兼容插件列表和我们的自定义物品插件对比。
常见问题与陷阱
- 材质显示为原版物品：物品上的引用与资源包中的映射不匹配，或者玩家拒绝了服务器资源包。
- 紫黑方格：模型 JSON 指向的材质路径在资源包中不存在（区分大小写！）。
- 在 1.21.3 中正常，在 1.21.4 中失效：你升级时跨越了物品模型的变更；请使用物品模型组件重新映射。
- 使用旧版客户端的玩家：通过 ViaVersion 连接时，旧版客户端可能无法渲染较新的模型功能；如果你要支持较宽的版本范围，请保留一个备用材质。
常见问题解答
自定义物品材质需要模组吗？ 不需要。服务器资源包可在原版客户端上使用，玩家加入时接受资源包即可。
如何为物品设置自定义材质？ 为物品指定一个材质引用（CustomModelData 或物品模型组件，取决于版本），并在资源包中完成映射。使用 ExecutableItems 时，这两步都可以在物品编辑器中完成。
如果我不会绘制材质怎么办？ 使用 60 多种内置 3D 武器材质（EI Premium，1.21.4+），或者获取免费的社区材质并自行映射。
材质可以有动画吗？ 可以，请参见动画材质指南。