简介这份资源是面向 Mindustry 6.0 模组开发者的 JavaScript 脚本工具核心解决多配方合成逻辑的快速搭建问题。开发者只需在模组 main.js 中引入 multi-crafter 模块即可通过 newCrafter 声明式地定义多输入、多产出的合成配方省去重复编写复杂逻辑的麻烦适合已掌握 Mindustry 模组基础、希望提升开发效率的中阶玩家。压缩包共 2 个文件包含 1 个 js 脚本与 1 个 md 说明文档前者是可直接引入的功能实现后者提供用法示例与参数注释整体仅 4KB轻量易读。资源中给出了从 this.window 挂载到 require 引入、再到 newCrafter 传参的完整调用链并附有含 rdminput、input 等字段的配方案例便于读者对照理解输入物品、液体与数量的配置方式。目前已有 171 人学习适合作为模组多配方系统的参考脚本快速上手。1. 从一份 JS 脚本说起MultiCrafter 到底解决了 Mindustry 6.0 mod 的什么痛点如果你在 Mindustry 6.0 里写过 mod大概率遇到过这种场景想加一种新工厂能根据输入物品自动切换产出配方原版逻辑要么写一堆ConsumeItems和OutputItems硬编码要么得靠多个方块拼凑维护起来像一团乱麻。MultiCrafter 就是冲这个来的——它用一份 JavaScript 脚本把「多配方合成」这件事从方块定义里抽出来交给脚本层动态处理。你不需要重新编译 Java 源码也不用碰mod.hjson里那些嵌套到眼花的配方字段改一行 JS 就能让同一个工厂吃不同原料、出不同产物。这份资源适合两类人一是想快速验证多配方玩法的 mod 作者二是已经会用 Mindustry 脚本但被原版配方系统卡住的老手。它不教你 JavaScript 基础也不替代官方文档它是一份能直接塞进 mod 目录跑起来的实战脚本包。2. MultiCrafter 的脚本结构拆解从 mod.hjson 到 JS 入口2.1 先看清文件布局别急着改代码拿到这份资源第一件事不是打开 JS 文件猛改而是把目录结构理清楚。Mindustry 6.0 的 mod 加载机制对文件位置很敏感放错一层目录游戏连报错都不给直接当你不存在。常见做法是先把压缩包解压到一个临时目录确认里面至少包含这几个东西一个mod.hjson或者mod.json6.0 两者都认但 hjson 更常见、一个scripts文件夹、以及scripts下面至少一个.js文件。MultiCrafter 的核心逻辑就在这个 JS 文件里它通过 Mindustry 的脚本接口注册方块行为。我一般会先用tree或者文件管理器看一眼层级确保scripts和mod.hjson是平级的。如果解压出来多了一层同名文件夹比如MultiCrafter/MultiCrafter/mod.hjson那得把内层内容提上来否则游戏扫描不到。这一步看着傻但血泪经验告诉我至少三成「mod 不生效」的问题都出在目录层级上。# 查看解压后的目录结构确认 mod.hjson 和 scripts 同级 find . -maxdepth 2 -type f | sort # 期望输出类似 # ./mod.hjson # ./scripts/multicrafter.js # ./sprites/block-multicrafter.png上面这条命令只是帮你确认文件位置不涉及任何构建工具。-maxdepth 2限制只看到两层避免刷屏-type f只看文件不看目录。如果输出里mod.hjson前面带了额外路径那就需要调整。2.2 mod.hjson 里必须对齐的三个字段MultiCrafter 能不能被游戏识别取决于mod.hjson里几个关键字段有没有和 JS 脚本对上。常见做法是打开mod.hjson找到name、displayName、author这些基础信息然后重点看scripts数组和blocks定义。6.0 的脚本加载规则是mod.hjson里声明的脚本文件路径必须和实际文件名完全一致大小写敏感。如果你把multicrafter.js写成MultiCrafter.js在 Windows 上可能没事到了 Linux 或者 Android 上直接翻车。// mod.hjson 片段确保 scripts 路径和实际文件名一致 name: multi-crafter displayName: MultiCrafter author: your-name description: 多配方合成工厂脚本 version: 1.0 minGameVersion: 6.0 scripts: [ scripts/multicrafter.js // 这里必须和实际文件路径完全匹配 ]这段配置里minGameVersion写6.0是底线写高了低版本游戏不认写低了可能遇到 API 不兼容。scripts数组里可以放多个 JS 文件但 MultiCrafter 通常只需要一个入口。如果你后续想拆成多个模块按加载顺序排列即可但要注意后加载的脚本能覆盖先加载的同名函数。2.3 JS 入口里注册方块行为的两个关键调用打开multicrafter.js你会看到它主要做两件事定义方块的合成逻辑以及把逻辑挂到游戏事件上。Mindustry 6.0 的脚本 API 里Blocks和extend是两个高频词。常见写法是先拿到一个已有方块作为模板然后扩展它的update或者acceptItem方法。MultiCrafter 的思路更直接它监听物品进入工厂的事件根据当前库存动态决定产出什么。// multicrafter.js 核心逻辑示意根据输入物品切换产出 const multiCrafter extend(GenericCrafter, multi-crafter, { // 定义多个配方每个配方有输入和输出 recipes: [ { input: [Items.copper, 2], output: Items.lead, time: 60 }, { input: [Items.lead, 2], output: Items.titanium, time: 90 } ], // 每次更新时检查当前库存匹配配方 update(tile) { const entity tile.ent(); this.recipes.forEach(recipe { if (this.hasItems(entity, recipe.input)) { this.consumeItems(entity, recipe.input); this.produceOutput(entity, recipe.output, recipe.time); } }); } });这段代码不是让你照抄而是让你看懂 MultiCrafter 的运作方式recipes数组里每个对象描述一条配方input是消耗的物品和数量output是产出time是生产周期。update方法每帧被调用检查库存是否满足某条配方满足就扣原料、加产物。参数怎么改想加新配方就往recipes里 push 一个对象想调整速度就改time数值越小越快。注意Items.copper这些是 Mindustry 内置的物品常量别自己造字符串否则运行时报undefined。3. 把脚本跑起来从本地测试到游戏内验证的完整流程3.1 本地环境准备JDK 和 Mindustry 版本对齐在把 MultiCrafter 丢进游戏之前先确认你的本地环境能跑 Mindustry 6.0。这听起来像废话但我见过太多人用着 7.0 的客户端去加载 6.0 的 mod然后抱怨脚本不生效。Mindustry 6.0 需要 Java 8 或更高版本如果你打算在桌面端测试直接装一个 6.0 的客户端最省事。常见做法是从官方渠道下载 6.0 的 jar 包然后用java -jar启动。别用最新版客户端去兼容旧 modAPI 变动很大extend的参数列表可能都对不上。# 检查本地 Java 版本确保 8 java -version # 启动 Mindustry 6.0 客户端假设 jar 包在当前目录 java -jar Mindustry-6.0.jarjava -version的输出里如果看到1.8.0或者11、17都行但别用21以上6.0 的某些反射调用在新版 JVM 上会报模块访问错误。启动客户端后先别急着装 mod进游戏看一眼版本号是不是 6.0确认无误再继续。3.2 把 mod 放进正确目录并触发加载Mindustry 的 mod 目录位置因平台而异。桌面端通常在~/.local/share/Mindustry/modsLinux或者%APPDATA%/Mindustry/modsWindows。Android 端在Android/data/io.anuke.mindustry/files/mods。把整个 MultiCrafter 文件夹不是压缩包复制进去然后重启游戏。注意是重启不是切出去再切回来Mindustry 只在启动时扫描 mod 目录。# Linux 下复制 mod 到正确位置 cp -r ./MultiCrafter ~/.local/share/Mindustry/mods/ # 确认目录内容 ls ~/.local/share/Mindustry/mods/MultiCrafter/ # 应该看到 mod.hjson 和 scripts 文件夹复制完别急着开游戏先用ls确认一下mod.hjson在根目录scripts文件夹也在。如果mod.hjson藏在子目录里游戏会直接忽略整个 mod。重启客户端后进主菜单看「Mods」列表里有没有 MultiCrafter有的话点开看有没有报错信息。如果列表里没有九成是目录层级问题如果有但显示红色错误那就是 JS 语法或者 API 调用有问题看日志。3.3 游戏内验证放下方块喂料看产出mod 加载成功后进沙盒模式或者自定义地图在方块列表里找 MultiCrafter。找到后放下去用物品源或者传送带喂入配方里定义的原料比如铜。观察工厂是否开始工作产出是否变成铅。如果方块放下去是灰色的说明mod.hjson里blocks定义有问题如果放下去能亮但没反应说明 JS 里的update逻辑没触发。// 调试用在 update 里加一行打印确认脚本被执行 update(tile) { const entity tile.ent(); print(MultiCrafter update called, copper: entity.items.get(Items.copper)); // ... 原有逻辑 }print是 Mindustry 脚本里的日志输出会打到控制台或者日志文件里。加这行之后重启游戏喂料时看日志有没有刷屏。如果有说明脚本在跑问题出在配方匹配上如果没有说明update根本没被调用回去检查extend的方块类型对不对。验证通过后记得把这行删掉不然日志会被刷爆。4. 避坑与排查MultiCrafter 脚本最常见的五类翻车4.1 现象mod 列表里看不到 MultiCrafter原因目录层级不对mod.hjson不在 mod 文件夹的根目录。常见情况是解压时多套了一层文件夹或者把压缩包直接丢进 mods 目录没解压。解决进 mods 目录确认MultiCrafter/mod.hjson这个路径存在而不是MultiCrafter/MultiCrafter/mod.hjson。如果是后者把内层文件夹里的内容全部移到外层。4.2 现象游戏启动时报脚本语法错误原因JS 文件里有拼写错误、缺少括号、或者用了 6.0 不支持的语法比如可选链?.在某些旧版 Rhino 引擎里不认。解决看日志里报的行号定位到具体代码。常见做法是把?.改成判断把let/const改成var试试。Mindustry 6.0 的脚本引擎基于 Rhino对 ES6 支持不完整别写太新的语法。4.3 现象方块能放但一直不生产原因配方匹配逻辑有问题比如hasItems检查的物品数量和实际喂入的不一致或者time设成了 0 导致除零。解决在update里加print输出当前库存和配方匹配结果看是哪一步断了。另外检查consumeItems和produceOutput的参数顺序别把输入输出写反。4.4 现象产出物品直接消失或者堆在地上原因produceOutput调用的目标容器不对或者工厂没有设置outputItem容量。MultiCrafter 默认可能把产物塞进工厂自己的库存但如果你没在mod.hjson里给方块配置itemCapacity产物就会溢出。解决在方块定义里加上itemCapacity: 20之类的字段或者在 JS 里手动调用entity.items.add(output, amount)并检查上限。4.5 现象多个配方同时触发原料被重复扣除原因update每帧遍历所有配方如果两条配方的输入有重叠可能会在同一帧内多次匹配。解决在forEach里加return或者break确保一帧只执行一条配方。或者给配方加优先级字段按顺序匹配匹配到就停。5. 进阶玩法用 JS 动态生成配方表与热重载技巧5.1 从硬编码配方到外部 JSON 驱动MultiCrafter 默认把配方写在 JS 数组里改一次就得重启游戏。如果你在调数值阶段这种节奏很折磨。我一般会改成从外部 JSON 文件读配方JS 只负责解析和注册。Mindustry 6.0 的脚本 API 里没有直接的readFile但可以通过Vars或者Core的接口间接拿到资源。更实际的做法是把配方表写成一个单独的 JS 文件用require或者直接include进来这样改配方只需要替换那个文件主逻辑不动。// recipes.js单独存放配方数据 module.exports [ { input: [Items.copper, 2], output: Items.lead, time: 60 }, { input: [Items.lead, 2], output: Items.titanium, time: 90 }, { input: [Items.titanium, 2], output: Items.thorium, time: 120 } ]; // multicrafter.js引入配方表 const recipes require(recipes); // 后续逻辑不变遍历 recipes 即可require在 Mindustry 脚本环境里不一定原生支持常见替代方案是用eval读取文件内容或者干脆把配方表定义成全局变量在mod.hjson的scripts数组里按顺序加载。这样recipes.js先执行把数组挂到global.recipes上主脚本再读。参数方面time的单位是 tick60 tick 大约等于 1 秒Mindustry 默认 60 FPS所以 60 就是每秒一次。5.2 热重载不重启游戏刷新脚本逻辑Mindustry 6.0 没有官方的热重载按钮但你可以利用脚本的reload机制。常见做法是在 JS 里监听某个聊天命令比如输入/reload-multicrafter时重新执行配方注册逻辑。这需要把初始化代码包成一个函数启动时调一次收到命令时再调一次。注意重载时要先清理旧的方块定义否则会重复注册导致内存泄漏。// 把初始化逻辑包成函数方便重载 function initMultiCrafter() { // 先移除旧方块如果存在 if (Blocks.get(multi-crafter)) { Blocks.remove(multi-crafter); } // 重新注册方块和配方 extend(GenericCrafter, multi-crafter, { /* ... */ }); } // 启动时初始化 initMultiCrafter(); // 监听聊天事件输入 /reload-mc 时重载 Events.on(EventType.PlayerChatEvent, e { if (e.message /reload-mc) { initMultiCrafter(); e.player.sendMessage(MultiCrafter reloaded); } });这段代码的关键是Blocks.remove和Blocks.get它们让你在运行时动态增删方块。PlayerChatEvent是 6.0 里监听聊天消息的入口e.message是玩家输入的内容。重载成功后给玩家发个提示确认生效。注意Blocks.remove可能不会立刻回收所有资源频繁重载可能导致卡顿建议只在开发阶段用。5.3 验证脚本是否真正生效的三个检查点改完脚本别急着开一局新游戏先做三个快速检查。第一看日志里有没有MultiCrafter loaded之类的自定义输出确认脚本被执行。第二在游戏里放下方块用print看update是否每帧触发。第三喂入配方里没有的原料确认工厂不会误触发其他配方。这三个检查点花不了两分钟但能帮你把大部分低级错误挡在开局之前。检查点操作预期结果脚本加载重启游戏看日志出现自定义加载提示方块注册方块列表搜索 MultiCrafter能找到且可放置配方匹配喂入铜观察产出按配方表产出铅从那以后我每次改完 MultiCrafter 的配方逻辑都强制走一遍「日志→放置→喂料」这三步不再凭感觉直接开新档。希望帮到你。本文还有配套的精品资源点击获取