Custom Item Core

XiceCustomItem 自定义物品插件

XiceCustomItem 是服务器自定义物品和展示方块的公共能力层，让经济、领地、RPG 和工业插件可以共享同一套物品标记、模型、发放和资源包检查逻辑。

功能概述

插件向其它插件提供 CustomItemService，用于注册自定义物品定义、创建带持久化标记的物品、设置模型 key、显示名、描述和发光覆盖。它会统一识别自定义物品，避免把普通基底物品误当作插件物品。

CustomBlockService 提供基于 ItemDisplay 的展示方块能力，统一计算六向朝向、展示实体旋转和类石质挖掘进度。虚拟货币机、简易刷石机、魔法砧、魔法砂轮和副本启动仪等展示方块都依赖这套公共逻辑。

插件还会阻止已注册自定义物品进入普通原版合成配方，避免玩家把领地戒指、实体货币、魔法粉末等物品当作基底材料误消耗；产物本身是插件自定义物品的专用配方仍可正常合成。

命令入口

• /xicecustomitem give <物品ID> [玩家|选择器] [数量]：统一发放已注册自定义物品。
• /xicecustomitem list：查看当前注册的自定义物品。
• /xicecustomitem checkpack [资源包根目录]：检查资源包中对应物品模型文件是否存在。
• /xicecustomitem reload：重载发放权限配置。

部署方式

插件基于 Paper API 运行，当前项目按 Paper 1.21.11 和 Java 21 构建。构建产物安装为 /opt/xicemc/runtime/plugins/XiceCustomItem.jar。

运行时配置文件位于 /opt/xicemc/runtime/plugins/XiceCustomItem/config.yml。配置中包含 access 授权表，当前 Web 权限页通过它管理 /xicecustomitem give 的使用人。

领地、经济、简易工业和 RPG 插件会在启动时向 XiceCustomItem 注册自己的物品。当前已接入的命名空间包括 xiceclaim、xiceeconomy、xicesimpleindustry 和 xicerpg。