安装与启动

本页面面向服主和管理员，说明 DungeonMaster 的基础部署流程，以及首次启动后应该检查什么。

安装前确认

服务端核心建议使用 Paper 或兼容的 Spigot 生态核心。
Java 版本、Minecraft 版本、依赖插件版本要先和你的整服环境统一。
如果副本要用到 MythicMobs、PlaceholderAPI、Vault、NeigeItems 一类联动，先把这些前置插件装好。
第一次部署时建议在测试服完成，不要直接在正式服热更。

安装步骤

停止服务器。
将 DungeonMaster 的插件文件放入 plugins/ 目录。
启动服务器，等待插件自动生成默认配置与示例文件。
检查控制台，确认没有缺依赖、版本不兼容或配置读取失败的报错。
关闭服务器后再修改配置，首次建议优先确认 config.yml、消息.yml、组队.yml、活力值.yml 是否已正常生成。

首次启动后会生成什么

通常会生成这些内容：

plugins/DungeonMaster/config.yml
plugins/DungeonMaster/消息.yml
plugins/DungeonMaster/组队.yml
plugins/DungeonMaster/活力值.yml
plugins/DungeonMaster/地牢/ 下的示例副本
plugins/DungeonMaster/世界/、词缀/、掉落方案/ 等资源目录

如果这些目录没有生成，优先检查：

插件是否真的启用成功
文件权限是否足够
编码或路径中是否有异常字符

建议的开服顺序

推荐按下面的顺序完成部署：

先确认全局配置可以正常加载。
导入或准备副本世界模板。
复制示例副本，改成你自己的副本 ID。
先做一个最小可运行副本，再逐步补充阶段、怪物组、奖励、模块。
最后再接入 PAPI、经济、外部物品与怪物系统。

首次检查清单

/dm 命令可以正常使用。
/dm list 能列出副本模板。
世界模板可以成功扫描或导入。
玩家进入副本后能正确传送到出生点。
副本结束后能正常传回原世界。
需要联动的外部插件已经被识别。

常见问题

启动后没有生成目录

先看控制台报错。常见原因是：

插件包损坏
服务端核心版本不兼容
依赖插件缺失
目录无写入权限

配置改了没有生效

先确认你改的是正确目录下的文件。修改后按文档要求重启服务器或执行重载命令，不要把“已运行中的旧实例”当成新配置结果。

插件装了但命令不可用

优先检查：

插件是否启用成功
玩家或管理员是否有对应权限
是否和其他插件命令冲突

下一步阅读