Reliable Recipes

Reliable Recipes

一个轻量级的工具,通过简单的 JSON 配置实现对配方和标签的修改!

可靠配方

forge fabric neoforge

一个强大且对开发者友好的实用工具,旨在通过简单 JSON 配置文件来操作配方和标签。 可靠配方允许整合包作者使用标准 JSON 文件轻松地添加、移除或修改配方和标签,无需复杂脚本(说的就是你,KubeJS!)。


快速入门

可靠配方会监视 Minecraft 实例中的一个特定文件夹以寻找 JSON 文件:

  • 位置: 将配置文件放置在 ./config/reliable_recipes/ 目录中(例如 my_recipe_changes.json)。
  • 格式: 规则在一个 JSON 数组中定义。每条规则必须指定一个 "action"(操作)。
[
  {
    "action": "remove_recipe",
    "mod": "examplemod",
    "type": "minecraft:crafting_shaped"
  }
]

配方操作

在筛选出要修改的配方后,您可以使用 "action" 属性来应用操作。

1. remove_recipe(或 remove)

从游戏中完全移除匹配的配方。

{
  "action": "remove_recipe",
  "id": [
    "minecraft:wooden_pickaxe",
    "minecraft:wooden_hoe"
  ]
}

2. replace_input

扫描输入材料并将目标物品/标签替换为替代品。

  • target:要查找的物品 ID 或标签(例如 #minecraft:logs)。
  • replacement:要使用的替代物品 ID 或标签。可以是字符串或物品数组。
{
  "action": "replace_input",
  "target": "minecraft:stick",
  "replacement": [
    "minecraft:bamboo",
    "minecraft:stick"
  ],
  "mod": "minecraft"
}

3. replace_output

更改匹配配方的输出结果。

  • replacement:输出的新物品 ID。
{
  "action": "replace_output",
  "replacement": "minecraft:golden_apple",
  "id": "minecraft:cake"
}

4. prevent_repair

阻止特定物品通过所有标准修复方式进行修复。

{
  "action": "prevent_repair",
  "target": "minecraft:diamond_pickaxe"
}

5. set_repair_material

覆盖在铁砧中修复特定工具或武器所需的修复材料。

{
  "action": "set_repair_material",
  "target": "minecraft:diamond_sword",
  "material": "minecraft:dirt"
}

筛选器

筛选器决定哪些配方会受影响。一个配方必须同时匹配所有提供的筛选字段才会被选中。

字段 描述 示例
output 产出物品的注册名。 "minecraft:stone_pickaxe"
id 配方的特定 ID。 "minecraft:black_bed_from_white_bed"
mod 拥有该配方的模组 ID。 "farmersdelight" 或 ["create", "mekanism"]
type 配方类型。 "minecraft:smoking"
input 如果配方包含此输入材料则匹配。 "minecraft:stick" 或 "#minecraft:logs"

标签修改

从物品中剥离标签或完全清空标签。这有助于清理 JEI/EMI 显示或隔离物品。

1. remove_all_tags(或 remove_tag)

移除指定物品的所有标签关联。

{
  "action": "remove_all_tags",
  "id": [
    "minecraft:stick",
    "minecraft:cake"
  ]
}

2. remove_from_tag

从特定标签中移除特定物品。

{
  "action": "remove_from_tag",
  "tag": "minecraft:planks",
  "id": "minecraft:oak_planks"
}

3. clear_tag

清空指定标签中的所有物品/方块。

{
  "action": "clear_tag",
  "tags": [
    "curios:artifact"
  ]
}

合成转化后向移植

可靠配方向后移植了 minecraft:crafting_transmute 合成配方类型。这允许您在合成网格中升级/转换物品,同时保留其所有物品组件(例如耐久度、附魔和自定义名称)。

配方字段

  • input(材料,必填):被升级的物品。
  • material(材料,必填):所需的材料物品。
  • material_count(整数或最小/最大范围,可选,默认为 1):所需材料的数量(例如 1 或 {"min": 1, "max": 4})。
  • result(物品,必填):输出的物品。
  • add_material_count_to_result(布尔值,可选,默认:false):如果为 true,则网格中放置的材料数量将会加到输出结果的数量上。

示例 JSON

{
  "type": "minecraft:crafting_transmute",
  "category": "equipment",
  "input": {
    "item": "minecraft:iron_pickaxe"
  },
  "material": {
    "item": "minecraft:gold_ingot"
  },
  "material_count": 1,
  "result": {
    "id": "minecraft:golden_pickaxe"
  }
}

模组兼容性

  • 可靠移除: 自动移除被可靠移除器黑名单隐藏物品的配方和标签列表。
  • EMI 集成: 在 EMI 中(处于开发者模式),将鼠标悬停在配方输出上时按下删除键,可以自动将一个移除规则追加到 ./config/reliable_recipes/generated_removals.json 文件中。

文档与维基

如需更多高级示例和详细信息,请参阅我们的维基: Modded Minecraft Wiki


许可证

代码许可证 (MIT)