ItemsAdder 自定义物品材质

ItemsAdder

突破 Minecraft 原版限制，为你的服务器添加自定义物品、方块、生物、表情、载具、盔甲、HUD 等海量内容。自动生成资源包，玩家加入服务器时自动下载，无需安装任何客户端模组。
下载地址1为本人购买的获得了授权的插件jar网盘地址，收取积分不过分吧。
请看清楚支持的范围，我不负责处理问题。
发布之前，已经确认过插件可以正常使用。
插件首次加载需要保证良好的网络环境否则可能下载失败

概述

ItemsAdder 由 LoneDev 开发，是 Minecraft 社区最受欢迎的付费自定义内容插件之一。自 2016 年发布以来，已累计 12,000+ 份销量和 14,000+ 次下载，拥有 500+ 条五星好评。
核心优势
5 分钟快速上手：详细的文字/视频教程，首次安装即可运行
原版体验：完美融入 Minecraft，如同官方更新内容
零卡顿：以性能为核心设计，不会导致 TPS 下降或服务器崩溃
无限自定义：你的想象力是唯一限制
资源包自动托管：内置 HTTP 服务器，自动分发给玩家

兼容性与版本

| 项目 | 详情 |
| :--- | :--- |
| 服务端 | Spigot / Paper / Purpur / Pufferfish |
| ItemsAdder v4 | Minecraft 1.20.6 – 1.21.11+（Java 21 推荐） |
| ItemsAdder v3 | Minecraft 1.15.2 – 1.20.4（Java 8 – 17） |
| 前置依赖 | ProtocolLib（必须） |
| 可选依赖 | LoneLibs（v4.0.10 起不再需要）、Vault、PlaceholderAPI、MythicMobs、ModelEngine、WorldGuard 等 |
版本选择提示：如果你的服务器是 1.20.6 及以上，使用 v4 系列（当前最新 v4.0.17）；如果是 1.20.4 及以下，使用 v3 系列（最新 v3.6.6-legacy）。

核心功能
自定义物品与工具
自定义武器（剑、弓、弩、钓竿等），支持自定义攻击力、攻速、耐久度
自定义工具，支持真实耐久度系统
自定义消耗品（食物、饮料、药水）
物品可堆叠（无漏洞）
支持自定义合成、冶炼、锻造和铁砧修复配方
自定义方块（超过 1130 个）
基于音符盒（Note Block）、蘑菇方块、绊线等原版机制实现
支持自定义硬度、挖掘等级、爆炸抗性、掉落物
支持方块属性完整配置
不依赖盔甲架或实体，不会导致卡顿
自定义生物与实体
基于现有实体 AI 创建自定义怪物
支持自定义模型、动画、生命值、移动速度
与 ModelEngine 深度集成，支持高级骨骼动画
自定义实体可拥有独立掉落物、经验值
表情系统（Emotes）
类似大逃杀游戏的玩家表情动作
支持自定义动画
可配置触发条件和权限
家具与载具
静态和动态家具（椅子、桌子、灯具等）
可交互椅子（玩家可坐上去）
自定义载具（汽车、飞机），支持自定义燃料系统
表情符号与字体（Emojis & Font Images）
540+ 内置表情符号
可在聊天、告示牌、书籍、全息图、铁砧命名等场景使用
支持 Tab 自动补全
自定义 HUD 元素（血条、法力条等）
HUD 与 GUI
自定义抬头显示（HUD），如生命值、经验条、自定义状态栏
自定义 GUI 菜单界面
可视化 GUI 编辑器（Visual Studio Code 扩展）
自定义聊天等级和格式
世界生成
自定义矿石生成（地下矿物）
自定义树木生成
地表装饰方块（石头、植物等）
洞穴装饰方块
自定义液体（熔岩、水变种）
音乐与音效
自定义音乐光盘
自定义音效和背景音乐
支持触发器播放
资源包保护
资源包解压保护，防止纹理被盗
内置 HTTP 服务器自动托管

命令列表
玩家命令

| 命令 | 权限 | 说明 |
| :--- | :--- | :--- |
| /ia | ia.user.ia | 打开 ItemsAdder 物品浏览界面 |
| /ia [玩家名] | ia.user.ia.categories.others | 打开其他玩家的物品界面 |
| /iarecipe [物品] | ia.user.iarecipe | 查看自定义物品的合成配方 GUI |
| /iaimage（别名 /e、/iaemoji） | ia.user.image.gui | 打开表情符号列表 GUI |
| /iatexture | ia.user.iatexture | 强制客户端重载资源包 |
| /iatexture [all\|玩家] | ia.user.iatexture.all | 强制所有玩家重载资源包 |
| /iasha1 | ia.user.iasha1 | 计算当前资源包的 SHA1 值 |
| /iaemote [玩家] | ia.user.iaemote | 播放自定义玩家表情动画 |
管理员命令

| 命令 | 权限 | 说明 |
| :--- | :--- | :--- |
| /iaget [数量] | ia.admin.iaget | 按命名空间 ID 获取自定义物品 |
| /iagive [数量] [silent] | ia.admin.iagive | 给予玩家自定义物品 |
| /iadrop [数量] | ia.admin.iadrop | 在坐标或玩家位置掉落物品 |
| /iaremove [数量] [silent] | ia.admin.iaremove | 从玩家背包移除物品 |
| /iadurability | ia.admin.iadurability | 修改当前物品耐久度 |
| /iarename | ia.admin.iarename | 重命名当前物品（支持表情和文字特效） |
| /iarepair | ia.admin.iarepair | 修复当前物品 |
| /iareload | ia.admin.iareload | 重载所有配置文件 |
| /iazip | ia.admin.iazip | 重新生成资源包并托管 |
| /iablock | ia.admin.iablock | 查看准星所指方块的信息 |
| /ialiquid | ia.admin.ialiquid | 查看准星所指液体的信息 |
| /iaentity | ia.admin.iaentity | 管理自定义实体 |
| /iasummon [数量] | ia.admin.iasummon | 召唤自定义生物 |
| /iakill | ia.admin.iakill | 杀死自定义生物 |
| /iahitbox | ia.admin.iahitbox | 显示已放置家具的碰撞箱 |
| /iahud [名称] | ia.admin.iahud | 手动显示/隐藏指定 HUD |
| /iaplayerstat [操作] | ia.admin.iaplayerstat | 读写自定义玩家数据（用于 HUD 更新） |
| /iaplaysound | ia.admin.iaplaysound | 播放自定义音效 |
| /iatag | ia.admin.iatag | 显示当前物品的调试信息 |
| /iacleancache | ia.admin.iacleancache | 清理缓存中未使用的 ID |
| /iaconfig | ia.admin.iaconfig | 配置文件操作 |
| /iaspawntree | ia.admin.iaspawntree | 生成自定义树木 |
| /iatrademachine | ia.admin.iatrademachine | 打开交易机器界面 |
| /iaplaytotemanimation | ia.admin.iatotemanimation | 播放不死图腾动画 |
| /iainfo | ia.admin.iainfo | 显示插件信息（含资源包 URL） |

权限节点
玩家基础权限（推荐首次安装时给予）

| 权限节点 | 说明 |
| :--- | :--- |
| ia.user.ia | 使用 /ia 命令打开物品界面 |
| ia.user.iarecipe | 使用 /iarecipe 查看合成配方 |
| ia.user.iatexture | 使用 /iatexture 重载资源包 |
| ia.user.image.gui | 使用 /iaimage 打开表情列表 |
| ia.user.image.hints | Tab 补全时显示表情提示 |
| ia.user.image.chat | 在聊天中使用表情 |
| ia.user.image.command | 在命令中使用表情 |
| ia.user.image.sign | 在告示牌上使用表情 |
| ia.user.image.book | 在书籍中使用表情 |
| ia.user.image.use. | 使用所有表情（可用具体表情名替换 ） |
| ia.user.ia.seeitem. | 在 /ia 菜单中查看所有物品 |
| ia.menu.seecategory. | 在 /ia 中查看所有分类 |
物品级权限

每个自定义物品都有独立的权限节点，格式为 ia.user.ia.seeitem.<命名空间>.<物品ID>。例如：

ia.user.ia.seeitem.myitems.ruby_sword

只有拥有对应权限的玩家才能在 /ia 菜单中看到并获取该物品。

配置文件结构
主配置文件 config.yml

控制资源包托管方式、数据库连接、全局设置等。

resource-pack:
hosting:
no-host:
enabled: false
simple_self_host: # 推荐方式（v4.0.17+）
enabled: true
server_address: auto
self-host: # 传统自托管
enabled: false
server-ip: 127.0.0.1
pack-port: 8163
external-host: # 外部托管（Dropbox 等）
enabled: false
url: ''
lobfile:
enabled: false
内容文件夹结构

所有自定义内容存放在 plugins/ItemsAdder/contents/ 下，按命名空间（namespace）组织：

plugins/ItemsAdder/contents/
myitems/ # 命名空间文件夹
configs/ # 配置文件目录
myswords.yml # 自定义武器配置
myblocks.yml # 自定义方块配置
myfood.yml # 自定义食物配置
textures/ # 纹理文件目录
item/
ruby_sword.png
golden_apple.png
block/
marble_block.png
自定义物品配置示例
contents/myitems/configs/myswords.yml
info:
namespace: myitems

items:
ruby_sword:
display_name: "&cRuby Sword"
lore:
- "&7A blade forged from pure rubies"
- "&7Damage: +10"
resource:
material: DIAMOND_SWORD
generate: true
textures:
- item/ruby_sword.png
attribute_modifiers:
mainhand:
attackDamage: 10
attackSpeed: 1.6
durability:
max_custom_durability: 800
自定义方块配置示例
contents/myitems/configs/myblocks.yml
info:
namespace: myitems

items:
marble_block:
display_name: "Marble Block"
resource:
material: PAPER
generate: true
texture: block/marble_block.png
behaviours:
block:
placed_model:
type: REAL_NOTE
break_particles: STONE
hardness: 1.5
blast_resistance: 6
drop:
type: myitems:marble_block

资源包托管方式

ItemsAdder 支持多种资源包分发方式，在 config.yml 中选择其一：

| 方式 | 说明 | 适用场景 |
| :--- | :--- | :--- |
| simple_self_host | 自动处理地址和端口（v4.0.17+） | 推荐，最简单 |
| self-host | 手动指定 IP 和端口，内置 HTTP 服务器 | 自建服务器/有额外端口 |
| external-host | 上传到外部 CDN/网盘，填入 URL | 大型网络/需要 CDN 加速 |
| ia-host | 使用 ItemsAdder 官方托管服务 | 不想自建托管 |
| lobfile | 生成本地文件，手动分发 | 测试/特殊场景 |
网络环境（BungeeCord / Velocity）

多服网络中，只需一个服务器生成并托管资源包，其他服务器通过 external-host 引用同一 URL，避免玩家切换服务器时重复下载。

安装步骤
第一步：下载插件与依赖

| 服务器版本 | 所需文件 |
| :--- | :--- |
| 1.20.6 – 最新版 | ItemsAdder v4.0.17 + ProtocolLib 5.5.0 |
| 1.20.1 – 1.20.4 | ItemsAdder v3.6.6-legacy + LoneLibs 1.0.65 + ProtocolLib 5.3.0 |
第二步：安装到服务器
停止服务器
将 ItemsAdder.jar 和 ProtocolLib.jar（以及 v3 所需的 LoneLibs.jar）放入 plugins/ 文件夹
启动服务器，等待插件加载完成
确认控制台无报错
第三步：配置资源包托管
打开 plugins/ItemsAdder/config.yml
推荐使用 simple_self_host（v4.0.17+）：

resource-pack:
hosting:
simple_self_host:
enabled: true
server_address: auto
如果使用传统 self-host，需向主机商申请额外端口（非服务器连接端口）：

self-host:
enabled: true
server-ip: '你的服务器IP'
pack-port: 8163
第四步：生成资源包
加入服务器（确保接受资源包）
执行 /iazip 命令
插件会自动生成资源包并启动托管
使用 /iainfo 查看资源包 URL 是否可访问
第五步：安装官方默认内容包（可选）
从 GitHub Releases 下载 DefaultPack
解压到 plugins/ItemsAdder/ 目录，覆盖同名文件
执行 /iazip 重新生成资源包
第六步：验证
退出服务器重新加入，确认资源包自动下载
执行 /ia 查看物品界面是否正常显示
执行 /iarecipe 测试配方 GUI

与其他插件的兼容性

| 插件 | 集成方式 |
| :--- | :--- |
| CosmeticsCore | 共享资源包，装饰品模型合并到 IA 资源包中 |
| MythicMobs | 自定义生物模型绑定 |
| ModelEngine | 高级骨骼动画支持 |
| WorldGuard | 区域保护兼容 |
| Vault / LuckPerms | 权限系统集成 |
| PlaceholderAPI | 变量占位符支持 |
| EssentialsX | 基础功能兼容 |
| MMOItems | 可共存，注意命名空间不冲突 |

更新记录

| 版本 | 日期 | 重要变更 |
| :--- | :--- | :--- |
| v4.0.17 | 2026-05-30 | 最新稳定版，simple_self_host 优化 |
| v4.0.16 | 2026-04-17 | 1.21.11 兼容修复 |
| v4.0.15 | 2025-11 | 性能优化与 bug 修复 |
| v4.0.13 | 2025 | 现代图形配置系统（Minecraft 1.21.4+） |
| v4.0.10 | 2025 | 不再需要 LoneLibs 前置 |
| v4.0.0 | 2025 | 大版本更新，仅支持 1.20.6+ |
| v3.6.6 | 2024 | v3 最终版本，支持 1.20.1–1.20.4 |
| v3.0.0 | 2021 | 引入命名空间系统重构 |

常见问题
物品显示为纸/皮革（纹理不加载）
确认资源包已接受下载（加入服务器时弹出的提示）
执行 /iatexture 强制重载
检查 config.yml 中托管方式是否正确配置
浏览器访问 /iainfo 显示的 URL，确认能下载 zip 文件
/iazip 执行后玩家看不到更新
确认托管方式配置正确且 URL 可访问
让玩家执行 /iatexture 强制刷新
检查防火墙是否放行了资源包端口
多服网络玩家反复下载资源包
所有服务器使用同一个资源包 URL（只在主服务器执行 /iazip）
其他服务器的 config.yml 中设置 external-host 指向主服务器的 URL
自定义生物不显示模型
确认 ModelEngine 已安装并正确配置
执行 /meg reload 重载 ModelEngine
执行 /iazip 重新打包资源
检查实体配置中的 model_folder 路径是否正确

获取支持

| 渠道 | 链接 |
| :--- | :--- |
| 官方网站 | https://itemsadder.com |
| SpigotMC 资源页 | https://www.spigotmc.org/resources/73355/ |
| 官方文档（英文） | https://wiki.itemsadder.com |
| 官方文档（中文，部分过时） | 社区维护的中文 Wiki |
| GitHub 问题追踪 | https://github.com/LoneDev6/Issues-ItemsAdder |
| Discord 社区 | 通过 SpigotMC 资源页获取邀请 |
| 配置编辑器（VS Code 扩展） | ItemsAdder Configurations Editor |

许可协议

ItemsAdder 为付费插件，由 LoneDev 开发并维护。
价格约 24.99 EUR（约人民币 200 元），每个服务器/网络需单独购买许可证
购买后享受终身更新
支持多种语言界面（中文、英文、日文、韩文等 14 种语言）
禁止反编译、转售、破解或重新分发
详细条款请参阅 SpigotMC 资源页的 Terms of Service

制作 by LT-YHC