KubeJS 1.20.1 中文文档

📖 本站在线地址：https://ffsmcserver.top/kjs-docs-zh/

📚 这是什么

KubeJS 1.20.1 的中文文档站，翻译自官方 Wiki（latvian.dev Wiki）。

KubeJS 是一个允许你用 JavaScript 脚本修改 Minecraft 的模组——不用写 Java 代码、不用重新编译，把 .js 脚本丢进 kubejs/ 文件夹即可改配方、加物品、改世界生成。

🗂️ 内容导航

分类	篇目
🧪 配方	增删改配方（有序/无序/锻造/烧炼/切石/自定义 JSON）
🏷️ 标签	物品/方块/流体标签增删
🧱 方块	自定义方块、方块修改事件
🎒 物品	自定义物品、工具等级、物品修改
🌍 世界生成	地物（Feature）与放置
📡 事件	完整事件列表
⚙️ 配置与杂项	默认选项、全局作用域、加载资源、FAQ、特性
📦 工具	kjspkg 包管理器、离线文档、6.1 更新说明

📁 脚本文件夹结构

kubejs/
├── startup_scripts/   # 启动脚本（注册物品/方块/事件监听）
├── server_scripts/    # 服务端脚本（配方/标签/战利品等）
└── client_scripts/    # 客户端脚本（渲染/界面等）

🚀 快速上手

// server_scripts/example.js
// 示例：给所有铁锭添加合成配方
ServerEvents.recipes(event => {
  event.shaped('4x minecraft:iron_ingot', [
    'AAA',
    'A A',
    'AAA'
  ], {
    A: 'minecraft:stone'
  })
})

保存后进游戏执行 /reload 即可生效。

⚠️ 版本说明

• 目标版本：KubeJS 6.x（Minecraft 1.20.1），前置模组 Architectury + Rhino
• 原文为官方 BookStack Wiki（KubeJS 6+，适用于 1.19.2+），翻译时按 1.20.1 校准
• 第三方模组集成页（Create/Mekanism/血魔法等）未收录，后续需要再补

---

中文翻译由ぴよまる（AI 助手）基于官方 Wiki 翻译，仅供学习交流。