⚡ 快速上手
QCL 装好后，本页带你用 5 步把它跑通、看懂、改动一次。每步都有命令和预期结果，照着做即可。
📌 前提：你已经按 安装 装好 QCL，服务端正常启动。
🎯 新手 5 步清单
| 步骤 | 你要做的 | 命令 |
|---|---|---|
| 1️⃣ | 看懂生态状态 | /qcl status |
| 2️⃣ | 看详细诊断 | /qcl status detail |
| 3️⃣ | 打开内置示例 GUI | /qcl gui example |
| 4️⃣ | 改一次配置并重载 | 改 config.yml → /qcl reload |
| 5️⃣ | 引用一个物品源测试 | 用物品源引用字符串 |
1️⃣ 跑 /qcl status，看懂输出
第一件事，永远是先体检：
/qcl status权限：
qcl.status· 别名：/qcl probe
它会输出一份生态状态摘要，典型内容包括：
| 输出项 | 含义 |
|---|---|
| 平台状态 | 正常 / 异常 |
| 健康码 | 整体健康编码（异常时按码排查） |
| 模块健康 | 22 个核心模块的总体状态 |
| 脚本桥 / 已加载脚本数 | 脚本子系统是否就绪 |
| 经济桥 / PAPI / 数据库 / PDC 健康码 | 各子系统健康码 |
| QI / QS / QF / QSt 是否可用 | 玩法插件是否被识别到 |
| 配置诊断 / API 边界 | 配置与 API 状态 |
| 公开 API 数 / apiJar 包数 / 内部包数 | API 边界统计 |
| 启动诊断 / 物品引用诊断 | 启动期与物品源诊断 |
✅ 预期结果：平台状态显示「正常」，各健康码无异常。若有异常，记下健康码去 诊断码 查。
2️⃣ 用 /qcl status detail 看逐项细节
摘要看完想深挖，用 detail 模式：
/qcl status detail权限：
qcl.status· 别名：/qcl status full
它在摘要基础上额外逐行列出每个模块、每个桥的状态，并执行脚本 global:qcl_status.js:formatStatus 追加自定义诊断行（脚本扩展行）。
✅ 预期结果：能看到 22 个模块逐行状态、各桥逐行状态、脚本扩展行。这是排查「到底哪个模块/桥挂了」的利器。
3️⃣ 打开内置示例 GUI
QCL 启动时会加载 guis/ 目录下所有 GUI。试着打开示例：
/qcl gui example权限：
qcl.gui· 仅玩家可用
✅ 预期结果：弹出一个示例 GUI 界面。 ❌ 若提示「找不到GUI: example」，说明
guis/下没有该 id 的 GUI 文件——可以照着 自定义GUI 自己建一个。
4️⃣ 改一次配置并 /qcl reload
打开 plugins/QinhCoreLib/config.yml，随便改一个值（比如 modules: 段里某个模块的开关），保存后执行：
/qcl reload权限：
qcl.admin· 别名：/qcl rl
/qcl reload 会一次性完成：
- 重新读取
config.yml（reloadConfig） - 重新初始化经济桥（
EconomyBridge.init） - 重载脚本桥（
QinhScriptBridge.reload） - 重载外部物品模块（Groovy）
- 重载所有 GUI
✅ 预期结果：配置即时生效，无需重启服务端。 ⚠️ 注意：
modules:段的启用/禁用属于模块级开关，部分深层改动仍以重启为准——拿不准就重启。
5️⃣ 引用一个物品源测试
QCL 把 10 种来源的物品统一成一套引用字符串。任何走 ItemSourceManager 的子插件都能用。常见写法：
| 写法 | 含义 |
|---|---|
vanilla:DIAMOND 或 DIAMOND | 原版物品 |
mm-龙剑 | MythicMobs 物品 |
mi-SWORD-烈焰剑 | MMOItems 物品 |
qi:神剑 | QinhItems 物品 |
ia-包名_物品 | ItemsAdder 物品 |
nx-枪 | Nexo 物品 |
试着在任何支持物品源的地方（如 GUI 图标、动作给物品）填一个引用，例如先用最稳的原版：
# 在某个支持物品源的配置项里
item: "vanilla:DIAMOND"✅ 预期结果：对应物品被正确解析出来。 📖 完整 10 种来源对照表见 物品源引用。
🧾 命令速查
| 命令 | 权限 | 作用 |
|---|---|---|
/qcl | — | 显示帮助 |
/qcl status（probe） | qcl.status | 生态状态摘要 |
/qcl status detail（full） | qcl.status | 详细状态（逐模块/逐桥/脚本扩展行） |
/qcl reload（rl） | qcl.admin | 重载配置、经济、脚本、物品模块、GUI |
/qcl gui <id> | qcl.gui | 打开指定 GUI（仅玩家） |
根命令
/qcl别名/qinhcorelib。完整命令与权限见 命令与权限。