OCC — One-Click Crafting / 一键递归合成

EN: One click on a JEI bookmark: OCC plans the entire recipe tree from your actual inventory, shows exactly what is missing, then crafts it all.

中: 点一下 JEI 收藏物品：OCC 按你背包里的实际材料把整棵配方树算完、把缺什么列清楚，然后一次性合完。

1. Summary / 简介

EN — One-click recursive crafting driven by your real inventory: plan the whole recipe tree, preview it as an expandable tree, get an exact list of missing materials, then craft the final item in a single action. For Minecraft Forge 1.20.1, integrates with JEI bookmarks, and handles GregTech CEu's manual crafting recipes (hammers, wire cutters, plates, circuits) correctly.

中 — 以真实背包为准的一键递归合成：先把整棵配方树推演完，用可展开的树界面预览，给出精确的 缺料清单，最后一次动作把成品合出来。适用于 Minecraft Forge 1.20.1，对接 JEI 收藏栏，并且正确 处理 GTCEu 这类"手工配方"（锤子、剪线钳、板材、电路）。

2. The problem / 解决什么问题

EN — Deep crafting chains are tedious. Want a chest from logs, or a GTCEu circuit from ingots? You have to work out which intermediates you need, in what order, how many of each, and repeat the same 3×3 recipe dozens of times — while guessing whether you really have the materials.

中 — 深配方链很折磨人。想用原木做箱子、用锭做 GTCEu 电路？你得自己算需要哪些中间产物、 先后顺序、各要几个，然后把同一个 3×3 配方重复几十遍，还要边做边猜材料够不够。

EN — OCC turns that into one click: it reads the item you bookmarked in JEI, computes the whole production chain against your current inventory, and crafts the intermediate steps for you in the correct order.

中 — OCC 把它变成一次点击：读取你在 JEI 收藏的物品，按当前背包算出整条生产链，并按正确 顺序替你完成所有中间合成。

3. What it does / 功能

4. How it works / 工作原理

1. EN — Recipe index. On first use, every crafting-table recipe is indexed by output item and rebuilt when the recipe manager reloads (/reload). 中 — 配方索引。 首次使用时把全部工作台配方按产物建索引，/reload 后自动重建。

2. EN — Virtual inventory. Your 36 main slots are copied into counters; tool durability is converted into available uses. 中 — 虚拟库存。 把主背包 36 格的计数拷出来；工具耐久折算成可用次数。

3. EN — Backtracking planner. From the target recipe, consume stock, then satisfy the rest from candidate recipes; every branch can be rolled back, so dead ends move on to the next recipe. 中 — 回溯规划。 从目标配方出发先吃现货，再对缺口挑候选配方继续展开；每条分支都能回滚， 走不通就换下一条。

4. EN — Plan scoring. All root recipes are really planned and compared: fewest net materials consumed → most surplus → preferred mod → fewest crafts. 中 — 计划打分。 所有根配方都真算一遍再比：净消耗最少 → 余料最多 → 命中优先 mod → 点火次数最少。

5. EN — Execution. The chosen plan is a flat list of single crafts in dependency order, each fired for real on the server, consuming across stacks and returning leftovers. 中 — 执行。 选中的计划是一条按依赖排序的点火序列，逐次在服务端真实执行，跨堆扣料、 余留物按原版返还。

6. EN — Diagnostics. If no plan exists, OCC re-plans up to 12 times, filling the reported gaps into a virtual bag until a plan becomes feasible; the accumulated additions are the real shortfall. 中 — 失败诊断。 无可行计划时最多重算 12 轮，每轮把缺口补进虚拟背包，直到能算出可行解； 累计补进去的量就是真实缺口。

5. Controls / 操作方式

Both trigger methods work only while the pointer is over a JEI bookmark in the player inventory or a crafting table screen. 两种方式都只在鼠标指向 JEI 收藏物品（背包/工作台界面）时生效。

Mouse + modifiers / 鼠标组合键（开箱即用）

Key binds / 按键绑定

Registered under Options → Controls → Key Binds → OCC One-Click Crafting；位于 「选项 → 控制 → 按键绑定 → OCC 一键递归合成」。

Defaults are unbound on purpose, so OCC never steals keys from other mods; press a row then a key to assign, Reset returns it to "Not Bound". 默认不占键位，避免与其他模组撞键；点某行再按键即可绑定，「重置」回到未指定。

6. The crafting tree screen / 合成树界面

7. Missing-material reports / 缺料清单

Reported in chat, one item per line, no hover required. 聊天栏一次性分行列出，不需要悬停。

[OCC] 缺少 4 种材料（按 还差/需/现有 列出）：
  · 工具·铁锤      还差 1（需 1，现有 0）   gtceu:iron_hammer
  · 铜锭          还差 8（需 30，现有 22）  minecraft:copper_ingot
  · 粘性树脂        还差 2（需 4，现有 2）    gtceu:sticky_resin
  · 钻石          还差 3（需 3，现有 0）    minecraft:diamond

Note / 备注：in-game message text is currently Chinese; an English localization pass is planned. 目前游戏内提示文本为中文，后续会做多语言化（见第 11 节）。

8. Configuration / 配置（config/occ-common.toml）

9. Compatibility / 兼容性

10. Known limitations / 已知限制