内置编辑器

OneEnoughItem

注意：仅教程仅适用于1.0.5.1。

概述

OneEnoughItem（简称 OEI）是一款支持物品替换的模组，配合其可视化编辑界面，可以轻松创建和管理替换规则。本教程将指导你如何使用其图形化编辑器。

开始使用

打开编辑器
按下默认快捷键 Ctrl + R 打开可视化编辑界面。
如果 R 键与其他功能冲突，可在游戏设置中修改快捷键。
创建新文件（首次使用）
如果尚未创建数据包：
- 在左侧输入框中输入数据包名称（可留空，默认为 OEI）。
- 在右侧输入框中输入 JSON 文件名（如 replacements）。
- 点击 创建文件 按钮。
系统将自动在以下路径生成文件：

<存档名称>/datapacks/<数据包名称>/data/oei/replacements

加载已有文件
若已有替换规则文件：
- 点击 选取文件 按钮。
- 在列表中选择目标文件条目。

选择后会出现三个操作按钮：

添加：向文件中新增一条替换规则。
特别注意：若在添加模式下，保存到JSON后就别进行新增操作了，因为添加模式保存到JSON是固定写入一个新的JSON对象，若要更改最好是切换到该文件的更改模式。
更改：修改已有规则。
- 点击后，界面左上角会出现 选择对象元素 按钮。
- 用于选择要修改的规则序号（即第几条规则，从 1 开始计数）。
- 例如，以下 JSON 是一个包含两个个规则对象的数组：
```
[
  {
    "matchItems": ["#forge:ores"],
    "resultItems": "minecraft:egg"
  },
  {
    "matchItems": ["minecraft:stone"],
    "resultItems": "minecraft:air"
  }
]
```
  - 第 1 条规则：匹配矿石标签中的所有物品，结果为鸡蛋。
  - 第 2 条规则：匹配石头，结果为空气。
- 选择对应序号后即可编辑并保存。
删除：删除该文件。

创建文件示例文件条目界面

数据包替换规则

在数据包中新增了 Rules 字段，方便玩家对单个物品的替换规则（如配方、标签等）进行更细致的控制。

完成所有替换规则的编辑并保存重载。
精确替换/保留规则
- 如果需要对某个物品规则的 配方、标签 等进行精细操作，可以点击主界面的 Web 规则注入器 按钮。
- 点击后会启动一个本地网页并自动打开，你可以在网页中进行数据包替换规则注入。
- 说明：
  - replace = 原物品有关的全部删除，结果物品有关的全部保留。
  - retain = 原物品和结果物品都保留。
网页的操作方法不再赘述，因为非常直观简单。

全局默认规则

如果不想逐个设置细分规则，可以通过 config/oei/common.json 配置文件来填写全局默认规则。
当某个物品没有单独规则时，会默认使用这里的全局规则。

示例：

{
  "common": {
    "Deeper_Replace": false,
    "Clear_Food_Properties": false,
    "Enable_Lite": false,
    "Default_Rules": {
      "data": {
        "recipes": "replace",
        "advancements": "retain"
      },
      "tag": {
        "items": "retain",
        "blocks": "replace"
      }
    }
  }
}

该默认规则含义为：

替换配方
保留成就
保留物品标签
替换方块标签

注意：铁砧相关逻辑目前无法处理，属于功能限制。

注意事项

定期保存：编辑时请频繁按下 Ctrl + S，避免因切换界面或意外退出导致数据丢失。
界面尺寸建议：使用界面尺寸 4 或以上，防止按钮无法点击。
配置文件更改说明：每个配置的更改都要重启游戏生效（ Default_Rules 除外，可重载两次生效）。
禁止的操作：
不支持 嵌套替换（如 A → B，B → C，期望 A → C）。
不支持将 标签（Tag）作为 resultItems 的结果项。
编辑器已禁止上述操作，若手动编辑 JSON 强行实现，可能导致不可预知的行为。
禁用物品：可通过手动编写数据包来把不需要的物品替换成空气来实现禁用物品，为了保证兼容性，在创造模式物品栏和 JEI 等模组中并不会删除，而是显示原物品，但实际不可被拿出。若替换为空气出现问题可替换为屏障达成一样的效果。

如有问题，欢迎提交 Issue 或者进我们反馈交流群。

内置编辑器

OneEnoughItem​

概述​

开始使用​

数据包替换规则​

注意事项​

OneEnoughItem

概述

开始使用

数据包替换规则

注意事项