KubeJS 可视化编辑器

KubeJS 可视化编辑器

用于KubeJS的可视化编辑器,支持大多数流行的科技模组。

KubeJS

KubeJS 可视化编辑器使用说明

作者:LiangYing_FX Minecraft 1.21.1 · NeoForge 21.1.x

目前处于开发阶段;原版和 MEK 应该可以正常使用。 由 DeepSeek 制作。


这是什么

一个用于 KubeJS 的游戏内可视化配方编辑器。选择模组、选择配方类型、填入物品,实时查看脚本生成,然后将其写入 kubejs/server_scripts/。它还可以使用你自己的 PNG 纹理注册自定义物品。


安装

  1. 安装 NeoForge 1.21.1 和 KubeJS 2101.x

  2. 将 kubejs-editor-0.1.0.jar 放入 mods/

  3. 为你想要编辑的模组安装对应的 KubeJS 附属模组(例如 Mekanism 需要 KubeJS-Mekanism)

  4. 启动游戏

没有对应附属模组的模组会在列表中标记为 *。


打开编辑器

默认按 K 键。可在选项 → 控制 → 按键绑定中重新绑定。


工作流程

  1. 在左侧选择模组,在中间选择配方类型

  2. 在右侧填写字段;带有 ... 的字段会打开物品选择器(按 ID 或名称搜索)

  3. 你也可以直接从 JEI 将材料拖到字段或合成槽位上

  4. 下方的预览会实时更新

  5. 使用“加入队列”收集多个条目,或点击“保存全部”

  6. 在游戏内运行 /reload


合成网格

有序配方使用 3×3 网格加一个输出槽。图案会自动推导:相同物品共用同一个字母,空单元格变为空格。右键点击单元格可清空。


文件保存位置

每个模组一个文件夹,每种配方类型一个文件,因此一个坏文件只会影响它自己。保存是合并操作:先解析已有文件,跳过重复项,然后重写。不会清空任何内容。

kubejs/server_scripts/visual/mekanism/crushing.js
kubejs/server_scripts/visual/create/mixing.js
kubejs/server_scripts/visual/minecraft/shaped.js
kubejs/server_scripts/visual/removals.js      ← 所有删除操作集中在这里

删除配方

选择配方类型,填入输入物品,点击“删除配方”并保存。它会将 event.remove({ type: '...', input: '...' }) 写入 visual/removals.js。


注册物品

  1. 点击顶部的“新建物品”

  2. 填写命名空间、物品名称、显示名称

  3. 将 PNG 放入 kubejs_editor/imports/,然后通过“选择 PNG”选择它

  4. 保存会写入 kubejs/startup_scripts/editor_items.js,并将图片复制到 kubejs/assets/<ns>/textures/item/<name>.png

  5. 重启游戏 —— 启动脚本不会被 /reload 重新加载

客户端以无头模式运行,因此没有系统文件对话框;纹理从文件夹中选择。


更改面板

左下角的“更改”会列出每个被修改的脚本,包括手写脚本。它们右侧都有删除 ×。按文本范围删除会保留你的注释和格式。顶部有一个搜索框。

颜色 来源 可删除
绿色 由本模组生成 ✓
蓝色 你手写的脚本 ✓(只删除该文本范围,保留注释和格式)
黄色 已注册物品 ✓
灰色 我们无法建模的调用(event.custom 等) ✓

支持的模组

12 组,86 种配方类型:原版、Mekanism、Create、AE2、Modern Industrialization、Evolved Mekanism、Mekanism Sun、MekMM、Occultism、EnderIO、Powah、Oritech。


添加你自己的模组

将 JSON 放入 config/kubejs_editor/,在其他模组内附带 resources/kubejs_editor/recipes.json,或从 KubeJS 脚本调用 KubeJSEditorApi。格式见 README。文件始终以英文 ID 命名,绝不要使用翻译后的 UI 标签。


疑难解答

配方不生效

  • 是否安装了对应的 KubeJS 附属模组?

  • 检查 logs/latest.log 中是否有 Unknown recipe type

  • 运行 /reload 并观察聊天栏是否有错误

JEI 面板缺失

  • 必须安装 JEI 且未被其他界面遮挡

  • 第一次打开编辑器时可能不会显示;打开一次物品选择器再返回即可刷新

UI 是英文

  • 跟随游戏语言;提供了 zh_cn 和 en_us