Amethyst+ for ItemsAdder

本插件为 Minecraft 服务器添加了可通过升级下界合金、钻石和铁质装备获得的新物品。穿戴由紫水晶灌注的物品会赋予你特殊效果，但会消耗耐久度。建议为物品附上“经验修补”魔咒或在铁砧中使用紫水晶进行修复。

💡安装指南

如何安装

• 启动服务器。
• 将 ItemsAdder 文件夹放入服务器的 /plugins 目录中。
• 在游戏内或控制台使用指令 /iareload 和 /iazip 完成加载。

✨物品图库

（图库内容）

ItemsAdder 是一款功能强大的 Minecraft 插件，它允许服务器管理员轻松添加自定义物品、方块、实体、盔甲、食物、工具、武器等，并支持资源包，为服务器带来独一无二的内容和视觉体验。

💡核心功能

• 自定义物品：创建具有独特名称、材质、模型、属性、附魔光效和 NBT 数据的物品。
• 自定义方块：添加新的功能性或装饰性方块，并可以定义其放置、破坏行为以及音效。
• 自定义实体：引入全新的生物、坐骑或 NPC，并自定义其模型、行为与掉落物。
• 资源包集成：自动为玩家分配和管理自定义资源包，无需玩家手动安装。
• 高级模型支持：支持使用 Blockbench 创建的 .bbmodel 模型文件，实现高精度 3D 物品和实体。
• 配方系统：为自定义物品添加合成配方（工作台、熔炉等）。
• 字体图像：利用 Minecraft 的字体系统，在物品名称、告示牌、聊天栏中显示自定义图标。

🎮指令与权限

主要管理员指令（通常以 /ia 或 /itemsadder 开头）：

• /iazip：生成资源包 ZIP 文件。
• /iareload：重载插件配置与资源。
• /iagive <玩家> <物品命名空间>:<物品ID>：给予玩家指定自定义物品。
• /iamenu：打开物品浏览菜单。

常用权限节点

• itemsadder.admin：授予所有管理员权限。
• itemsadder.player：默认玩家权限（如使用某些自定义物品）。
• itemsadder.give：允许使用 /iagive 指令。

🔧安装与配置

• 将 ItemsAdder.jar 放入服务器的 plugins 文件夹。
• 重启服务器以生成配置文件和文件夹结构。
• 在 plugins/ItemsAdder 目录中，您会找到 contents 和 data 等文件夹，用于存放您的自定义内容配置。
• 根据官方 Wiki 指南创建您的第一个自定义物品的 YAML 配置和材质文件。
• 使用 /iazip 生成资源包，并通过插件自动分发给玩家，或手动上传至资源包托管服务。

✨依赖与兼容性

• 必需依赖：ItemsAdder 需要 Spigot、Paper 或衍生服务端（如 Purpur）。对于 1.20.5+ 版本，必须使用 Paper 或基于 Paper 的服务端。
• 推荐依赖：ProtocolLib（用于实体模型等高级功能）。
• 模型支持：如需使用 .bbmodel 模型，需安装 Oraxen 或 ModelEngine（特定版本下），但插件也内置基础模型支持。
• 资源包：为获得最佳效果，建议配置资源包自动下载或提供高速托管链接。

❓常见问题

• 玩家看不到自定义物品的材质？

确保资源包已正确生成并分发给玩家。检查服务器 server.properties 中 resource-pack= 的链接是否有效，或确认 ItemsAdder 的自动分发功能已启用。

• 如何更新自定义内容？

更新 contents 文件夹中的配置和材质文件后，使用 /iareload 重载插件，并重新生成资源包（/iazip）。

• 支持哪些 Minecraft 版本？

ItemsAdder 支持广泛的版本，请访问官方页面查看与您服务器版本对应的具体插件版本。

• 可以与其他物品插件共存吗？

可以，但请注意自定义物品的 ID 和模型管理可能与其他插件（如 Oraxen）存在冲突，建议仔细规划命名空间。

如需完整文档、教程和社区支持，请访问插件的官方 Wiki 页面。