KubeJS:自定义配方和脚本
无需编程即可更改整合包配方和机制:KubeJS 脚本结构、重载和常见错误。
更新于 2026年8月13日
KubeJS 让您可以通过脚本修改整合包:删除和添加配方、更改掉落物、挂钩事件。这是平衡整合包的标准做法。
结构
kubejs/
server_scripts/ recipes, drops, server events
client_scripts/ tooltips, interface
startup_scripts/ item and block registration
在托管服务器上,您需要的是服务端脚本。
示例
ServerEvents.recipes(event => {
event.remove({ output: 'minecraft:diamond_block' })
event.shaped('4x minecraft:stick', [
'P',
'P'
], { P: 'minecraft:oak_planks' })
})
重载
/kubejs reload server_scripts
配方无需重启即可生效。启动脚本需要完全重启。
错误
脚本错误会写入 logs/kubejs/server.txt,而不只是写入通用日志。请优先查看这里:服务器仍会启动,但您的更改根本不会生效。
注意
- 脚本以完整权限在服务器上运行——不要不看内容就照搬别人的脚本。
- 删除整合包任务链中用到的配方会破坏玩家进度。
- 每刻或每方块触发的事件很容易拖垮 TPS——模组服务器优化。
Minecraft 托管您离线时服务器仍在运行创建服务器
