修正readme

This commit is contained in:
1820982382
2026-08-08 03:14:17 +08:00
parent 0c72822f40
commit 2c1aabe78a
3 changed files with 21 additions and 14 deletions
+9 -5
View File
@@ -1,5 +1,7 @@
# TC KubeJS Bridge (tckubejsbridge)
> **中文** | [English](README_EN.md)
将 **神秘时代4(Thaumcraft 4 移植版)** 的配方系统桥接到 **KubeJS**,让整合包作者/服务器管理员
可以在 KubeJS 脚本中直接注册 TC 的注魔、炼金、奥术合成配方以及物品固有要素,并支持**替换原有配方**。
@@ -38,7 +40,7 @@ gradle :tckubejsbridge:build
## 脚本用法
将脚本放入 `kubejs/server_scripts/`,**重启游戏生效**(见"注意事项"第 1 条)。
将脚本放入 `kubejs/server_scripts/`,然后**重启游戏或执行 `/reload` 生效**(见"注意事项"第 1 条)。
### 1. 注魔配方
@@ -153,10 +155,12 @@ ServerEvents.recipes(event => {
## 注意事项
1. **改脚本后必须重启**,`/reload` 不生效:
- TC 配方在 `ThaumcraftApi.getCraftingRecipes()` 内存列表,KubeJS `/reload` 不清空它
- 本 mod 的去重集合(按 research 键)也不随 `/reload` 清空
- 若将来需要 `/reload` 支持,可在脚本中调用 `thaumcraft.clearRegistered()` 清空去重集合
1. **支持热重载**:改脚本后执行 `/reload` 即可生效,无需重启游戏。
- KubeJS 每次 `/reload` 都会重新执行 `ServerEvents.recipes`,脚本会再次运行。
- 若脚本使用"先删后注册"(`thaumcraft.removeInfusion(...)` 再 `infusion(...)`)写法,
删除步骤会清掉本 mod 的去重键并移除 TC 内存列表中的旧配方,因此新配方能正确重新注册。
- 纯新增(不先删)的脚本重复 `/reload` 会被去重拦截(`skipping`),请配合
`thaumcraft.clearRegistered()` 使用或在脚本开头调用它。
2. **research 键全局唯一**:重复键会被跳过(防止重复注册)。如需同名配方,请改键。
3. **配方不进原版 RecipeManager**:TC 注魔/炼金/奥术配方是 TC 自己的内存列表。
本桥接在脚本执行时直接调用 TC API 注册,并对 KubeJS 输出无害占位配方,