MustJS

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

MustJS 是一个 KubeJS 扩展模组，旨在通过一系列可复用的 JavaScript 函数，简化 Create 模组配方 的创建和管理。

该扩展为常见的 Create 加工配方、序列组装、流体操作和物品操作提供了开箱即用的函数，让你能够用更简洁、更有条理的脚本创建复杂的配方。

MustJS 旨在作为你的 KubeJS 脚本的库来使用。

📂 结构

MustJS 文件夹包含创建配方所需的所有函数。

你应该将此文件夹视为一个库，并在你的配方脚本中使用其中的函数。

⚠️ 请勿直接编辑 MustJS 文件。
该库会频繁更新，你的修改可能会在更新扩展时被覆盖。

🛠️ 创建配方

要使用 MustJS 创建配方，请在你的 KubeJS 配方脚本中新建一个 .js 文件，并使用以下方式注册配方：

ServerEvents.recipes(event => {
    // 在此处编写你的配方
})

所有 MustJS 配方生成函数都需要 event 参数。

示例

ServerEvents.recipes(event => {
    compacting(
        event,
        itemOutput('minecraft:diamond'),
        [itemInput('minecraft:coal'), itemInputTag('minecraft:logs')],
        'heated'
    )
})

📜 函数

CreateBaseFunctions

用于创建常见 Create 加工配方的函数。

函数	描述
`compacting(e, output, inputs, heat)`	创建一个压缩配方
`crushing(e, output, input, time)`	创建一个粉碎配方
`cutting(e, output, input, time)`	创建一个切割配方
`deploying(e, output, held, base, keep)`	创建一个部署配方
`emptying(e, output_item, output_fluid, input)`	创建一个排空配方
`filling(e, output, input, fluid)`	创建一个灌注配方
`haunting(e, output, input)`	创建一个缠魂配方
`item_application(e, output, input_block, input_item)`	创建一个物品应用配方
`mechanical_crafting(e, output, input, pattern)`	创建一个机械合成配方
`milling(e, output, input, time)`	创建一个研磨配方
`mixing(e, output, input, heat)`	创建一个混合配方
`pressing(e, output, input)`	创建一个压片配方
`polishing(e, output, input)`	创建一个抛光配方
`splashing(e, output, input)`	创建一个洗涤配方
`sequenced_assembly(e, output, input, transitional, loops, processing)`	创建一个序列组装配方

⚙️ 序列组装

MustJS 还提供了专门用于简化 Create 序列组装 配方创建的辅助函数。

辅助加工函数

cuttingS(output, input, time)
deployingS(output, held, base, keep)
fillingS(output, input, fluid)
pressingS(output, input)

这些函数可以在 sequenced_assembly() 中组合使用，以构建复杂的加工链。

💧 FluidManipulator

用于轻松定义流体输入和输出的函数。

函数

fluidOutput(fluid_id, fluid_amount)
fluidInput(fluid_id, fluid_amount)

示例

fluidInput('minecraft:water', 1000)

📦 ItemManipulator

用于定义物品输入和输出的函数。

输出函数

itemOutput(id)
itemOutputStack(id, count)
itemOutputChance(id, chance)
itemOutputChanceStack(id, chance, count)

输入函数

itemInput(item)
itemInputTag(tag)
itemInputKey(symbol, id)
itemInputTagKey(symbol, tag)

这些函数使定义普通物品、物品堆叠、物品标签以及带键原料变得更加容易，便于配方生成。

🔧 示例

一个基础的 MustJS 配方脚本可以像这样：

ServerEvents.recipes(event => {

    haunting(
        event,
        itemOutputStack('minecraft:iron_ingot', 12),
        itemInput('minecraft:iron_block')
    )

})

MustJS 负责管理配方结构，让你能够专注于配方应该产出什么，而不必手动编写完整的 Create 配方定义。所有函数都附带完善的文档和使用说明，以及错误处理，助你开发配方！

✨ 特性

🛠️ 简化的 Create 配方创建
📦 可复用的配方函数
⚙️ 序列组装支持
💧 流体输入和输出辅助
📋 物品操作工具
🧩 基于物品和标签的原料
🔄 专为与 KubeJS 直接配合而设计
🧹 更简洁、更有条理的配方脚本
🚀 减少重复的 Create 配方代码

📋 需求

KubeJS
Create

请确保这两个模组都已安装，并与你的 Minecraft 版本兼容。

📄 许可证

请查看仓库以获取许可证信息和更多细节。

MustJS —— 使用 KubeJS 简化 Create 配方开发。