KubeJS 开源项目教程
KubeJS项目地址:https://gitcode.com/gh_mirrors/ku/KubeJS
项目介绍
KubeJS 是一个 Minecraft 模组,允许用户使用 JavaScript 语言编写脚本,以管理服务器、添加新的方块和物品、更改配方、为任务模组添加自定义处理程序、更改世界生成器等。KubeJS 支持多种 Minecraft 版本,并且兼容 Forge、Fabric 和 NeoForge 等模组加载器。
项目快速启动
安装 KubeJS
- 下载并安装 Minecraft 对应版本的模组加载器(如 Forge 或 Fabric)。
- 下载 KubeJS 模组文件,并将其放入 Minecraft 的
mods
文件夹中。 - 启动 Minecraft,确保 KubeJS 模组已成功加载。
编写第一个脚本
在 Minecraft 目录中找到 kubejs
文件夹,创建一个新的 JavaScript 文件,例如 startup_scripts.js
,并添加以下代码:
ServerEvents.recipes(event => {
event.shaped('minecraft:diamond_pickaxe', [
'DDD',
' S ',
' S '
], {
D: 'minecraft:diamond',
S: 'minecraft:stick'
})
})
这段代码将修改钻石镐的合成配方。
重载脚本
在游戏中输入以下命令以重载脚本:
/kubejs reload startup_scripts
应用案例和最佳实践
修改配方
KubeJS 可以轻松修改现有配方或添加新配方。例如,修改铁剑的配方:
ServerEvents.recipes(event => {
event.remove({ output: 'minecraft:iron_sword' })
event.shaped('minecraft:iron_sword', [
' I ',
' I ',
' S '
], {
I: 'minecraft:iron_ingot',
S: 'minecraft:stick'
})
})
添加自定义物品
使用 KubeJS 添加自定义物品:
ItemEvents.register((event) => {
event.create('custom_item').displayName('Custom Item')
})
世界生成器修改
修改世界生成器以添加自定义结构:
WorldgenEvents.add(event => {
event.addStructure('custom_structure', 'minecraft:overworld', {
processor: 'minecraft:empty',
projection: 'rigid',
element: {
element_type: 'minecraft:single_pool_element',
location: 'custom_structure',
processors: 'minecraft:empty',
projection: 'rigid'
}
})
})
典型生态项目
KubeJS Tinkers Construct
KubeJS Tinkers Construct 是一个扩展模组,允许用户使用 KubeJS 脚本修改匠魂模组的配方和行为。
KubeJS Botania
KubeJS Botania 是一个扩展模组,允许用户使用 KubeJS 脚本修改植物魔法模组的配方和行为。
KubeJS Ars Nouveau
KubeJS Ars Nouveau 是一个扩展模组,允许用户使用 KubeJS 脚本修改 Ars Nouveau 模组的配方和行为。
通过这些扩展模组,用户可以更深入地定制和优化 Minecraft 游戏体验。