配方图

RecipeGraph

RecipeGraph 是一个用于 Minecraft 的客户端侧配方扫描与导出模组。它可以在游戏内通过命令全量扫描 JEI 中的配方数据，并按指定模组范围导出为 JSON 图数据。导出的 JSON 可以使用模组内配套的 index.html 进行检索和查看。

功能特性

• 在游戏内使用命令导出配方图数据。
• 支持按模组 ID 过滤导出范围。
• 支持通过配置文件限定要扫描的 JEI 配方类型。
• 导出结果包含节点与边数量统计。
• 配套 index.html 可用于浏览、搜索和分析导出的配方图。

使用前提

本模组依赖 Fabric 客户端环境，并通过 JEI 运行时获取配方信息。因此请确保：

• 已安装 Fabric Loader。
• 已安装本模组及其所需依赖。
• 已安装并启用 JEI。
• 已进入游戏世界后再执行导出命令。

快速开始

1. 启动游戏并进入任意世界。

2. 第一次运行时，模组会在配置目录下创建：

   config/recipegraph-types.json
   

3. 按需要编辑 recipegraph-types.json，限定需要扫描的配方类型。

4. 在游戏聊天栏中执行导出命令。

5. 根据聊天栏中打印的导出路径找到生成的 .graph.json 文件。

6. 打开模组内配套的 index.html，按照页面指引加载导出的 JSON 文件进行检索。

配方类型配置

模组第一次运行时会自动创建 recipegraph-types.json。该文件用于限定需要扫描的配方类型。

默认配置大致如下：

{
  "recipeTypes": [
    "minecraft:crafting",
    "minecraft:smelting",
    "minecraft:blasting",
    "minecraft:smoking",
    "minecraft:campfire_cooking",
    "minecraft:stonecutting",
    "minecraft:smithing"
  ]
}

其中 recipeTypes 是一个配方类型 ID 列表。模组会读取该列表，并只扫描列表中的配方类型。

如果某个 ID 无法解析为合法的 Minecraft Identifier，该项会被忽略。可以使用以下命令查看当前配置中的配方类型是否在 JEI 中可用：

/recipegraph types

命令输出示例：

Configured RecipeGraph JEI recipe types: 7
- minecraft:crafting [available]
- minecraft:smelting [available]
- minecraft:blasting [available]

状态说明：

• available：JEI 当前运行时中存在该配方类型。
• missing：配置中写入了该类型，但 JEI 当前未找到对应类型。
• unknown：JEI 运行时暂不可用，无法判断类型状态。

游戏内命令

导出全部模组配方

/recipegraph export

未指定参数时，等价于导出所有模组范围。

导出文件名通常会以 all 作为基础名称，例如：

all.graph.json

导出指定模组配方

/recipegraph export <mods>

<mods> 可以是一个或多个模组 ID，多个 ID 可以使用空格或逗号分隔。

示例：

/recipegraph export minecraft

/recipegraph export minecraft,create

/recipegraph export minecraft create farmersdelight

导出时，模组会根据指定的模组 ID 生成文件名。文件名中不适合作为路径字符的内容会被替换为 _。

例如：

/recipegraph export minecraft create

可能生成：

minecraft_create.graph.json

查看当前扫描类型

/recipegraph types

该命令会读取或创建 recipegraph-types.json，然后列出当前配置中的配方类型，并显示其在 JEI 中的状态。

导出结果

执行导出命令后，游戏聊天栏会显示导出结果，例如：

RecipeGraph exported: <导出文件的绝对路径>
Nodes: <节点数量>, edges: <边数量>

其中：

• Nodes 表示导出的图节点数量。
• edges 表示导出的图边数量。
• 导出路径以游戏内实际打印结果为准。

生成的文件扩展名为：

.graph.json

使用 index.html 检索

模组内提供了配套的 index.html 页面，用于查看和检索导出的配方图数据。

使用方式：

1. 在config文件夹找到模组提供的 index.html。
2. 使用浏览器打开该文件。
3. 按照页面提示选择或加载导出的 .graph.json 文件。
4. 在页面中进行配方、物品、节点或关联关系检索。

命令摘要

命令	说明
/recipegraph export	导出全部模组范围的配方图
/recipegraph export <mods>	按指定模组 ID 导出配方图
/recipegraph types	查看当前配置的配方类型及 JEI 可用状态

备注

RecipeGraph 主要用于配方数据分析、配方链检索和模组整合包中的物品生产关系排查。导出结果依赖当前客户端已加载的 JEI 配方数据，因此不同整合包、不同模组列表或不同配置下得到的结果可能不同。