KubeJS-1.20.1
当前文档主要维护中的版本。当前目录默认围绕 Minecraft 1.20.1、Forge 与 KubeJS 6 展开。
在开始之前，需要先接受什么
如果你想真正接触 KubeJS，而不是只停留在复制几段脚本的阶段，那么至少应先接受下面几件事：
- 这不是一套完全现代、完全稳定、完全统一的脚本环境。
Rhino、KubeJS 本体、Forge 与各类附属模组的历史遗留问题，会直接影响脚本表现。 - 你需要频繁进入世界测试、查看日志、确认脚本所在侧别，并通过类型与运行结果不断修正认识；很多实现不是因为写法高级,而是Debug流程做得很清晰。
- 社区示例往往来自不同版本、不同作者与不同历史阶段。能参考，但不能默认它们可以直接照抄。
- 你会不断遇到 Java 类名、事件签名、方法重载、脚本侧别与版本差异；这不是附带成本，而是使用 KubeJS 开发方式正常的一环。
- 你需要具备基础的 JavaScript 理解，或至少做好逐步学习的准备。KubeJS 并不会替你屏蔽语言本身的复杂性，对函数、对象、作用域等概念的理解，往往直接影响脚本能否正确运行。
这些是使用 KubeJS 进行开发时不可避免的一部分。
关于提问、求助与 AI
KubeJS 的很多问题，更适合先整理清楚再去社区提问，而不是直接把问题丢给 AI。真正有价值的问题，重点不在“会不会问”，而在“有没有把上下文讲明白”。
如果你准备去社区求助，至少先整理这些信息：
Minecraft / Loader / KubeJS / ProbeJS版本。- 脚本所在位置，例如
startup_scripts、server_scripts或client_scripts。 - 你想实现什么，实际发生了什么。
- 最小可复现的代码片段，而不是整个脚本目录。
- 报错、日志、
console输出，或你已经确认过的关键类型信息。 - 你已经试过哪些排查步骤，例如重新
/probejs dump、切换脚本侧别、打印对象内容。
社区提问示例
提问收到回答后记得说谢谢。比了解一万个函数更有用的进步秘诀
当前的 AI 在 KubeJS 开发上幻觉和误差都很大，不推荐依赖。 但可以适当使用。 它可以帮你解释术语、整理问题、列排查顺序，但不能代替日志、类型文件、源码、实际测试，也不能代替社区里基于经验给出的修正。
如果一段回答对不上具体版本、具体事件并不能判断可能的运行结果或者可能的报错，那它最多只是线索，不是答案。