安装与快速开始

安装

1. 下载 AreaModule 插件 jar 文件
2. 将 jar 文件放入服务器的 plugins/ 目录
3. 确保已安装所需的依赖插件（见介绍）
4. 启动或重启服务器

插件首次启动时会自动在 plugins/AreaModule/ 下生成示例配置：

plugins/AreaModule/
├── level/              # 主关卡配置
│   └── 野外区域.yml
└── sublevels/          # 子关卡配置
    └── 野外区域/
        ├── 野外区域第一关.yml
        ├── 野外区域第二关.yml
        └── 野外区域第三关.yml

创建你的第一个关卡

第 1 步：使用选点工具选择区域

/am tool

手持工具后，左键点击设置位置 1，右键点击设置位置 2，框选出关卡的生效范围。

第 2 步：创建关卡配置

/am create 我的关卡

这会根据你选择的区域自动生成关卡配置模板文件。

第 3 步：编辑主关卡配置

编辑 plugins/AreaModule/level/我的关卡.yml：

id: 我的关卡
type: default
trigger:
  type: move-prob
  prob: 0.1          # 10% 概率触发
cooldown: 120         # 冷却 120 秒
time-limit: 0         # 0 表示不限时
region:
  type: cube
  pos-A: [100, 64, 200]
  pos-B: [150, 80, 250]
  world: world
sub-levels:
  第一关:
    priority: 1
  第二关:
    priority: 2

第 4 步：创建子关卡配置

在 plugins/AreaModule/sublevels/我的关卡/ 下创建子关卡文件。

第一关.yml：

id: 第一关
on-start: |-
  title color "&a&l第一关开始！" by 0 20 10
on-exit: |-
  title color "&e&l第一关完成！" by 0 20 10
modules:
  刷怪点1:
    type: spawner
    async: false
    pos: [125, 65, 225]
    period: 100
    times: 2
    distance: 15
    mobs:
      - mob: SkeletalKnight
        amount: 3
  区域标记:
    type: landmark
    hologram: guide_hologram
    pos: [120, 68, 220]

第 5 步：重载配置

/am reload

第 6 步：手动测试

/am start 我的关卡
/am next 我的关卡      # 推进到下一个子关卡
/am stop 我的关卡      # 停止关卡

关卡生命周期

触发器条件满足 → 关卡启动 → 子关卡 1 开始
                                ↓
                         子关卡 1 完成 (advance)
                                ↓
                         子关卡 2 开始
                                ↓
                              ...
                                ↓
                         所有子关卡完成 → 关卡结束

关卡启动后，区域内的玩家会被自动记录为参与者。如果配置了 time-limit，超时后关卡会自动失败。