Abyss 地牢副本

模块简介

Abyss 是 Suite 的地牢副本模块，提供「模板定义 → 独立实例 → 脚本化流程 → 结算」的完整副本生命周期。管理员在 abysses/<地牢ID>/ 目录下用 YAML 定义副本（世界来源、怪物波次、任务、交互点、脚本、奖励），玩家通过 /abyss 浏览器或命令进入，每个副本实例运行在独立的隔离世界中，结束后自动回收。

副本世界支持三种来源：虚空世界（运行时生成全空世界，脚本自行搭建场景）、世界文件夹（整个存档目录复制为实例世界）、WorldEdit/FAWE schematic（粘贴到虚空世界）。怪物支持原版实体与 MythicMobs Boss，副本内可跑 NPC 对话、任务接取、交互点、障碍物、定时任务与生命周期脚本。

功能特性

依赖

副本核心流程（世界生成/怪物/脚本/结算）只依赖 Bukkit API + PlaceholderAPI，Spigot/Paper/Mohist 均可运行。

运行机制

副本生命周期

玩家请求进本 ──→ 条件检查(体力/冷却/货币/物品/权限/等级) ──→ 创建实例 ──→ 加载世界 ──→ 区块预载
                                                                              │
              ┌── world-init 脚本(建场景) ──→ 传送玩家 ──→ init ──→ start ──→ 怪物组/任务/交互点激活 ──┤
              │                                                               │
   通关 complete ──→ 发奖励+烟花 ──→ exit_dungeon 传送回 ──→ 世界卸载删除        │
   失败 fail/all-death ──→ exit_dungeon ──→ 世界卸载删除                        │
   超时 timeout ──→ FAIL 判负 / KICK 踢出                                       │
              └───────────────────────────────────────────────────────────────┘

世界隔离

每个实例生成 axs_abyss_<实例ID> 世界，玩家进本前记录原位置与游戏模式，出本时恢复。实例无人或超时后世界自动卸载删除（instance-cleanup-timeout 控制），磁盘不残留。

怪物刷怪路由

快速开始

1. 服务端启用 abyss 模块（宿主 config.yml → modules.abyss.enabled: true）
2. 首次启动自动导出示例地牢 abysses/example/（虚空世界，无需任何外部依赖即可跑通）
3. 玩家执行 /abyss 打开浏览器，或 /abyss enter example 直接进本
4. 写自己的地牢：复制 abysses/example/ 为 abysses/<你的ID>/，改 config.yml 等文件，/axs abyss reload 生效

详见 地牢模板编写 与 配置。