跳到主要内容

快速上手

目标：把示例地牢 map1 的配置放进数据目录，在副本中手动启动模块系统，并看到标题/消息/触发行为生效。

前置条件​

  • 运行端：Bukkit/Paper（KModule 使用 TabooLib 的 Bukkit 环境）
  • 副本端：已安装 DungeonPlus，且存在名为 map1 的地牢

步骤​

1）准备依赖​

最少需要：

  • DungeonPlus
  • KModule

建议先暂时不要启用带外部依赖的模块（例如刷怪/宝箱/全息），先把“关卡流程 + 简单交互”跑通。

2）放入示例配置​

本仓库自带示例配置：src/main/resources/modules/map1/。
把它复制到插件数据目录的 modules/map1/（数据目录通常为 plugins/KModule/）。

你最终会看到类似结构：

plugins/KModule/
  modules/
    map1/
      level.yml
      sub-levels.yml

3）进入副本并启动模块​

  1. 进入 DungeonPlus 的 map1 副本
  2. 以玩家身份执行：
/km start

4）成功标志（你应该看到什么）​

  • 进入第 1/2/3 关时出现标题（start-kether）
  • 走到范围/交互点时触发消息或脚本
  • 控制台出现 KModule 的模块加载与启动日志

如果没有触发：

  • 确认你真的在 DungeonPlus 地牢里（/km start 会提示）
  • 确认 modules/map1/ 的文件内容能被加载（见「故障排查」）