
CYE:配方控制
用一个 JSON 配置即可更改、添加和禁用任何配方或物品——在数据包、KubeJS 和生成的配方之后应用,因此你的更改始终生效。
CYE: Recipe Control
更改、添加和禁用任意配方——并对数据包、KubeJS 以及会自行生成配方的模组拥有最终决定权。
⚠️ 早期开发阶段(beta)。 该模组仍在开发中,目前已仅在专用服务器上测试过——单人游戏和大多数游戏版本尚未在游戏内测试。目前不建议在重要世界或公开整合包中使用。 使用前请备份你的世界,并请报告任何问题。
❗ Fabric / Quilt:需要 Fabric API。 没有它模组无法加载。(在 Quilt 上,QFAPI 也可以。)Forge 和 NeoForge 无需其他依赖。
一个小巧的 jar,适用于 Fabric、Quilt、Forge 和 NeoForge。无需脚本,无需为每个世界配置数据包:你在一个 JSON 文件中描述更改,模组会在每次加载数据时直接将其应用到游戏的配方管理器。
为 CYELauncher 打造(其可视化配方编辑器会为你生成配置),但也可在任何客户端或服务器上独立使用——配置就是纯 JSON。
为什么
数据包与其他一切内容一起加载,因此模组或 KubeJS 脚本可以覆盖它们。有些模组(例如 GregTech CEu)根本不提供配方文件——它们在游戏加载时生成数万个配方,因此数据包无从覆盖。
CYE: Recipe Control 在配方管理器被填充之后运行——在原版、数据包、KubeJS 脚本和生成的配方之后——并编辑最终结果。更改后的配方随后照常发送给玩家,因此读取服务器配方的配方查看器(JEI / EMI / REI、配方书)也应该能显示它们——这部分尚未在游戏内测试。
功能
- 按 id 替换任意配方——原版、模组或运行时生成的。
- 添加新配方。
- 禁用配方。
- 禁用物品:移除所有产出该物品的配方。可选地也移除该物品是满足某原料的唯一途径的配方。标签会被展开,因此禁用
minecraft:stick也会移除使用#c:rods/wooden的配方(如果木棍是其中唯一物品),但禁用一种木板不会破坏所有#minecraft:planks配方。 - 坏配方不会阻止加载:解析失败的配方会被跳过并报告。
- 每次加载和
/reload后生成报告——config/cye-recipe-control.report.txt说明更改了什么、添加了什么、移除了什么、什么失败了以及原因,外加一项自检,确认更改确实已进入配方管理器。 - 完整配方列表——
config/cye-recipe-control/recipes.txt(游戏中每个配方的id<TAB>type,包括生成的配方)。便于查找你想要替换的配方的 id。
支持的版本
在专用服务器上测试过(✅)——替换、添加、禁用配方,禁用物品,/reload:
| 加载器 | Minecraft | 状态 |
|---|---|---|
| Forge | 1.20.1 | ✅(也可配合 GregTech CEu 7.5 和 KubeJS 6) |
| NeoForge | 1.21.1 | ✅ |
| NeoForge | 26.1 | ✅ |
| Fabric / Quilt | 1.21.1 | ✅ |
| Fabric / Quilt | 1.21.4 | ✅ |
| Fabric / Quilt | 1.21.2 | ✅ |
| Fabric / Quilt | 1.20.1 – 1.21.11 的所有其他发布版 | 应该可用(包含名称表),未在游戏内测试 |
| NeoForge | 1.20.5 – 1.21.x | 应该可用,未在游戏内测试 |
- Fabric / Quilt——需要 Fabric API(Quilt 上——Fabric API 或 QFAPI)。
- Java 17+。
- 不支持旧版本(1.19 及以下)。
安装
- 服务器:将 jar 放入
mods/(Fabric / Quilt 上——连同 Fabric API),并将配置放入config/cye-recipe-control.json。玩家不需要该模组。 - 单人游戏:将其放入客户端的
mods/(内置服务器负责处理)。 - CYELauncher:无需操作——启动器会从本项目下载最新的兼容文件,保持更新,并在你启动带有配方更改的实例时写入配置。
- 整合包:你可以将该模组包含在你的整合包中——在 beta 期间,请先与你的整合包一起测试。
配置——config/cye-recipe-control.json
{
"recipes": {
"minecraft:iron_pickaxe": {
"status": "edited",
"recipe": {
"type": "minecraft:crafting_shaped",
"pattern": ["ADA", " B ", " B "],
"key": {
"A": { "item": "minecraft:iron_ingot" },
"D": { "item": "minecraft:diamond" },
"B": { "item": "minecraft:stick" }
},
"result": { "id": "minecraft:iron_pickaxe", "count": 1 }
}
},
"mypack:sand_to_glass": {
"status": "new",
"recipe": {
"type": "minecraft:smelting",
"ingredient": { "item": "minecraft:sand" },
"experience": 0.1,
"cookingtime": 100,
"result": { "id": "minecraft:glass", "count": 4 }
}
},
"minecraft:golden_apple": { "status": "disabled" }
},
"disabled_items": {
"minecraft:tnt": { "ingredients": true },
"minecraft:diamond_sword": { "ingredients": false }
}
}
recipes——键为配方 id。status:edited/new——recipe是配方 JSON,格式与数据包中适用于你的 Minecraft 版本的格式完全一致(格式在 1.20.5 和 1.21.2 中发生了变化),包括模组配方类型,如gtceu:macerator。status:disabled——该配方被移除。
disabled_items——物品 id →{ "ingredients": true | false }。false移除产出该物品的配方;true还会移除没有它就无法再合成的配方。recipes中列出的配方永远不会被disabled_items触及。
更改在世界/服务器启动时以及每次 /reload 时应用。
报告——config/cye-recipe-control.report.txt
# CYE: Recipe Control — 2026-10-21T18:24:11
changed 2, added 1, removed 329, errors 0, verified 4/4 (recipes before 39613, after 39285; reload)
N mypack:sand_to_glass
E minecraft:iron_pickaxe
- minecraft:golden_apple
x minecraft:stick — recipes removed: 327 (result and ingredient)
! mypack:broken — JsonParseException: Pattern references symbol 'X' but it's not defined in the key
(此版本中报告文本为乌克兰语。)
限制
- 物品不会从游戏注册表中移除(那会破坏世界)——被禁用的物品只是无法被合成。它仍然可以出现在战利品、创造模式标签页、JEI 的物品列表等中。
- 在香草配方管理器之外保留自己配方副本的模组,可能仍会在其机器中使用原始配方。工作台 / 熔炉 / 锻造 / 切石机配方始终会受到影响。
- 在 1.20.1 上,像 GregTech CEu 这类模组的机器配方可以按 id 禁用,但"禁用物品"无法检测其产物(1.20.1 中没有配方编解码器)。
- 配方 JSON 必须匹配你的 Minecraft 版本的格式——模组不会在版本之间进行转换。
工作原理(供好奇者)
该模组对 Minecraft 没有编译时依赖。它通过反射按官方(Mojang)名称查找游戏的类;对于具有不同运行时名称的环境(1.21.11 之前的 Fabric intermediary、Forge 1.20.1 SRG),jar 中包含根据官方映射生成的小型查找表。钩子:
- Forge / NeoForge——以最低优先级注册的重载监听器,在配方管理器之后运行。
- Fabric / Quilt——Fabric API 服务器生命周期事件(
SERVER_STARTING、END_DATA_PACK_RELOAD),然后配方会重新发送给玩家。
致谢
- 名称查找表根据 Mojang 的官方映射、Fabric Intermediary 和 Forge MCPConfig 生成;仅包含模组使用的那几十个名称。
许可证
MIT。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。