跳到主要内容

故障排查

1）/km start 提示“在关卡内才能启动当前关卡的模块”​

原因：

  • 你不在 DungeonPlus 地牢里（DungeonPlus.dungeonManager.getDungeon(player) 返回空）

解决：

  • 先进入 DungeonPlus 的副本世界，再执行 /km start

验证：

  • /km start 提示“启动成功”

2）控制台报“没有找到 <type> 对应的 Activator”​

原因：

  • 模块 type 写错了
  • 使用了依赖外部插件的模块，但外部插件未安装（可能导致类加载失败，进而激活器未正常注册）

解决：

  • 对照「模块参考」确认 type 拼写
  • 安装对应依赖插件（例如 spawner 需要 MythicMobs）

3）控制台报“模块 XXX 缺少参数 YYY”​

原因：

  • params 缺少必填字段
  • 字段类型不对（例如把数字写成字符串）

解决：

  • 用「配置生成器」生成一份最小 params
  • 对照对应模块的 params 说明逐项补齐

4）模块不触发​

排查顺序：

  1. 子关卡是否真的在运行（/km debug modules 查看状态）
  2. 模块是否被标记 hidden: true（隐藏模块不会自动启动）
  3. 模块是否被 probability 概率跳过（查看是否有 failure-kether 输出）
  4. 触发条件是否满足（坐标是否正确、是否主手、是否右键等）

5）使用了 NeigeItems / DecentHolograms / Adyeshach / MythicMobs 相关模块后报类缺失​

原因：

  • 对应依赖插件缺失或版本不兼容

解决：

  • 安装对应依赖插件，或暂时移除该模块配置