Create: Hand Made 0.4.0-beta 更新说明

发布日期： 2026-10-14 适用版本： Minecraft 1.20.1 / Forge

手搓学迎来 0.4.0！ 本次更新重做了配方的底层架构，为 KubeJS 和整合包作者提供完整的自定义配方支持，同时给风箱加上了期待已久的独占配方功能。

普通玩家升级后不用做任何事——所有工具照常使用。如果你自己写过数据包或 KubeJS 脚本，请看文末的「需要注意」。

🆕 新功能 风箱独占配方 风箱以前只能跑 Create 原版的鼓风配方（熔炼、烟熏、缠魂、洗涤）。现在你可以在数据包或 KubeJS 里定义自己的风箱配方了。

比如给一个物品加一条"只能用手搓风箱熔炼"的配方：

{
  "type": "create_hand_made:bellows_recipe",
  "fan_type": "blasting",
  "ingredients": [{"item": "minecraft:raw_iron"}],
  "results": [{"item": "minecraft:iron_ingot"}]
}

手搓风箱的配方优先级高于原版Create 配方。 所以只要匹配到独占配方，就会用它，不再走 Create 那套。

手锯切石

手锯现在能处理原版切石配方。把石头、石砖、深板岩之类放进副手，主手持手锯右键，就能像切石机一样切出各种变体。

• 优先切削，切石兜底 ——木头走切削，石头走切石，互不干扰
• 跟随 Create 配置 ——如果你在 Create 里关了机械锯切石，手搓手锯也会跟着关
• JEI 有独立页面 ——搜"手锯切石"能看到所有可切的配方

手锯 HUD 改进

• 数量角标： 产物数量 > 1 时右下角显示数字
• 多行布局： 配方超过 9 个自动换行，最多 4 行，不用横向滚屏
• 滑动窗口： 配方超过 36 个时，HUD 变成滑动窗口，跟随你选中的配方，上下显示 +N 提示还剩多少

🔧 改进

配方底层架构重做

内部 L3（独占配方）系统从手工解析迁移到 Minecraft 标准 RecipeType。对玩家完全透明 ，但让 KubeJS 整合包作者能写出更规范的配方。

JEI 类别升级

所有 JEI 类别现在都会同时显示原版 Create 配方和手搓学独占配方。 以前只有原版，独占配方要靠猜。

结构更稳定

• 每个家族都有独立的 RecipeType，不会和 Create 或其他模组的配方冲突
• 类型安全恢复，运行时崩溃概率降低

⚠️ 需要注意

如果你只是普通玩家（玩游戏，不写脚本）：

✅ 什么都不用做，升级即可。

如果你自己写过数据包或 KubeJS 脚本：

⚠️** 旧的 L3 独占配方会失效** ，需要手动迁移。主要改动：

1. 目录变了 ：data/<你的命名空间>/handmade/recipe/<工具>/ → data/<你的命名空间>/recipes/
2. type 字段变了 ：从 minecraft:cutting 之类的原版类型 → create_hand_made:tool_recipe
3. tool 字段新增 ：JSON 里要写明是哪个工具的配方，比如 "tool": "hand_saw"

完整迁移对照表：

L2 过滤也有一处小改动 ：旧的 press_hammer 工具 id 拆成了 press_hammer_basin 和 press_hammer_depot，按你实际要过滤的配方路径选一个即可。

KubeJS 脚本写法：

ServerEvents.recipes(event => {
  event.recipes.create_hand_made.cutting_recipe(...)
  event.recipes.create_hand_made.pressing_recipe(...)
  event.recipes.create_hand_made.crushing_recipe(...)
  event.recipes.create_hand_made.filling_recipe(...)
  event.recipes.create_hand_made.application_recipe(...)
  event.recipes.create_hand_made.tool_recipe(...)
  event.recipes.create_hand_made.stonecutting_recipe(...)
  event.recipes.create_hand_made.bellows_recipe(...)
})

整合包作者 ：如果你已经在整合包里用了旧格式的 L3 配方，请参考仓库里的完整迁移指南（数据包迁移指南,到时候加）逐个更新。

📦 兼容性

见Readme 存档兼容 ：老存档无需转换，直接升级即可。

💬 反馈

遇到问题欢迎在 GitHub Issues 反馈。 祝玩得开心！🎉