内置编辑器
OneEnoughItem
概述
OneEnoughItem（简称 OEI）是一款支持物品替换的模组，配合其可视化编辑界面，可以轻松创建和管理替换规则。本教程将指导你如何使用其图形化编辑器。
开始使用
打开编辑器
按下默认快捷键 Ctrl + R 打开可视化编辑界面。如果 R 键与其他功能冲突，可在游戏设置中修改快捷键。
创建新文件（首次使用）
如果尚未创建数据包：- 在左侧输入框中输入数据包名称（可留空，默认为
OEI）。 - 在右侧输入框中输入 JSON 文件名（如
replacements）。 - 点击 创建文件 按钮。
系统将自动在以下路径生成文件：
- 在左侧输入框中输入数据包名称（可留空，默认为
<存档名称>/datapacks/<数据包名称>/data/oei/replacements
- 加载已有文件
若已有替换规则文件：- 点击 选取文件 按钮。
- 在列表中选择目标文件条目。
选择后会出现三个操作按钮：
- 添加：向文件中新增一条替换规则。
特别注意：若在添加模式下，保存到JSON后就别进行新增操作了，因为添加模式保存到JSON是固定写入一个新的JSON对象，若要更改最好是切换到该文件的更改模式。
- 更改：修改已有规则。
- 点击后，界面左上角会出现 选择数组元素 按钮。
- 用于选择要修改的规则序号（JSON 数组中的第几项）。
- 例如，以下 JSON 包含两个规则：
[
{
"matchItems": ["#forge:ores"],
"resultItems": "minecraft:egg"
},
{
"matchItems": ["minecraft:stone"],
"resultItems": "minecraft:air"
}
]- 第一个
{}是 数组序列 1 - 第二个
{}是 数组序列 2
- 第一个
- 选择对应序号后即可编辑并保存。
- 删除：删除该文件。
扩展功能（实验性）
需安装 KubeJS 模组
当检测到 KubeJS 时，编辑界面会多出一个 配方去重 按钮。
为什么需要配方去重？
替换物品后，原物品相关的配方仍会保留，导致重复。例如：
- 将
#forge:armors（盔甲）替换为jungle_sign（丛林木告示牌） - 合成盔甲的配方依然可用，造成逻辑混乱。
使用方法：
- 完成所有替换规则的编辑并保存。
- 点击 配方去重 按钮。
- 系统会根据当前 JSON 文件中的替换规则，自动生成用于移除原配方的 KubeJS 脚本。
- 出现“移除成功”提示后，点击重载按钮使更改生效。
注意：铁砧相关逻辑目前无法处理，属于功能限制。
注意事项
- 定期保存：编辑时请频繁按下 Ctrl + S，避免因切换界面或意外退出导致数据丢失。
- 界面尺寸建议：使用界面尺寸 4 或以上，防止按钮无法点击。
- 配方去重使用建议：
请在 完成所有物品替换后 再执行去重操作。
不建议中途频繁修改并去重，可能引发未知问题。
- ️ 创造模式物品栏显示问题：
Fabric / NeoForge 环境：创造模式中看不到被替换后的物品，属于正常现象，不影响实际功能。
Forge 环境：标签（Tag）替换后可能出现同样情况，重启游戏通常可解决。
- 禁止的操作：
不支持 嵌套替换（如 A → B，B → C，期望 A → C）。
不支持将 标签（Tag）作为 resultItems 的结果项。
编辑器已禁止上述操作，若手动编辑 JSON 强行实现，可能导致不可预知的行为。