Custom Item Definitions v2.5.6
自定义物品定义库 | 免费依赖插件 | 原作者 0xF | Biu腐蚀网中文整理
这是一个底层库插件:它自己不产生任何玩法,作用是给其他插件提供「创建完整自定义物品」的能力。很多带自定义丹药、材料、道具的插件都需要它,建议常备。
自定义物品在数据空间中被定义、注册与展示一、它能做什么
普通插件想加新物品,往往只能寄生在胶水、绷带等原版物品上;本库可以基于一个父物品,创建出真正独立的 ItemDefinition,和官方物品一样完整:
| 能力 | 说明 |
|---|---|
| 独立标识 | 自定义短名、物品 ID、显示名、描述、皮肤,不再寄生原版物品。 |
| 独立属性 | 可设最大堆叠、物品类别、标志位,以及自定义物品组件(itemMod)。 |
| 制作与修理 | 可单独开关是否可修理、可制作,可配制作配方与所需工作台等级。 |
| 自动生命周期 | 注册即返回物品定义;依赖插件卸载时自动注销,不残留、不冲突。 |
二、谁需要它
SPxx 修仙:插件里的 9 种丹药、3 种符纸、9 种材料,全部通过本库注册成独立图标物品。
未安装本库时,这些自定义物品无法注册,洗髓、突破、渡劫、炼丹画符等功能会停用(插件本身不会崩服)。
未安装本库时,这些自定义物品无法注册,洗髓、突破、渡劫、炼丹画符等功能会停用(插件本身不会崩服)。
三、安装(一步即可)
把 CustomItemDefinitions.cs 放进 oxide/plugins/ 目录,控制台执行:
oxide.reload CustomItemDefinitions
日志出现「Loaded plugin CustomItemDefinitions」即装好。无需配置文件、无需授权、无需注册权限;运行数据在需要时自动生成,缺失也会安全初始化。
加载顺序提示:请先装好本库,再 reload 依赖它的插件(如 SPxx)。若先启动了依赖插件,reload 一次本库、再 reload 对应插件即可恢复。
四、管理员命令(F1 控制台,需管理员)
| 命令 | 作用 |
|---|---|
| itemid <短名> | 查询某物品的物品 ID,例:itemid scrap。 |
| shortname <物品ID> | 反查某物品 ID 对应的短名。 |
两个命令仅作查询工具,需 Rust 原生管理员身份,普通玩家无法使用。
五、常见问题
Q:这个插件收费吗? 免费,作为公共依赖库自由使用。
Q:不装会怎样? 依赖它的插件无法注册自定义物品、相关功能停用,但不会崩服。
Q:需要给玩家授权限吗? 不需要,本库不注册任何 Oxide 权限。
原作者 0xF(dsc.gg/0xf-plugins)| Biu腐蚀网仅做中文整理与免费分发,不盗取、不转售。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END








