安装与启动
本页面面向服主和管理员，说明 AchieveMaster 的基础部署流程，以及首次启动后应该检查什么。
安装前确认
- 服务端核心建议使用
Paper或兼容的Spigot生态核心。 - Java 编译基线是
Java 8，当前实现按Java 8+环境兼容设计。 - 如果你要用到
Vault、PlaceholderAPI、MythicMobs、Chemdah、AttributePlus、DragonCore、CustomNPCs、NeigeItems、LyItemSave联动，先把这些前置插件装好。 - 第一次部署建议先在测试服跑通，再上正式服。
安装步骤
- 停止服务器。
- 将
AchieveMaster的插件文件放入plugins/目录。 - 启动服务器，等待插件自动生成默认配置、示例成就、区域示例和函数目录。
- 检查控制台，确认没有缺依赖、版本不兼容、资源写入失败或脚本初始化失败的报错。
- 首次建议优先确认
/ach可用，再关闭服务器修改配置。
首次启动后会生成什么
通常会生成这些内容：
text
plugins/AchieveMaster/
├── config.yml
├── messages.yml
├── commands.yml
├── gui.yml
├── points-rewards.yml
├── achievements/
│ ├── categories.yml
│ ├── examples.yml
│ └── 脚本语法说明.yml
├── regions/
│ ├── _示例区域.yml
│ └── _多区域示例.yml
└── scripts/
└── functions/
├── yml/
│ └── example_functions.yml
├── tqs/
│ └── example_functions.tqs
├── java/
│ └── ExampleFunctions.java
└── js/其中有几件事要特别注意：
achievements/会递归加载，子目录里的成就文件同样会生效。regions/不存在时会自动创建，并顺手写入示例区域文件。scripts/functions/js/目录会创建，但默认不一定自动写入示例文件。- 安装了
PlaceholderAPI后，插件会在启动时直接注册%achievemaster_*%扩展。
建议的接入顺序
推荐按下面的顺序完成接入：
- 先让主命令和 GUI 能正常打开。
- 先改
categories.yml和一个成就文件，跑通基础触发。 - 再接
points-rewards.yml做成就分奖励。 - 有任务需求时，再补
quest、reset、submit-conditions这些字段。 - 最后再接
commands.yml、regions/、scripts/functions/和外部联动。
首次检查清单
/ach help、/ach list、/ach triggers、/ach functions能正常使用。achievements/目录里的示例能正常加载出来。regions/目录已经生成，区域示例文件存在。- 装了
PlaceholderAPI时，控制台能看到扩展注册成功。 - 改完
commands.yml后执行/ach reload，自定义命令能即时注册。 - 背包扫描、定时器、排行榜、积分奖励没有持续报错。
常见启动问题
启动后没有生成目录
先看控制台报错。常见原因：
- 插件包损坏
- 服务端核心版本不兼容
- 数据目录无写入权限
- 路径或编码异常导致中文资源文件写入失败
/ach 能用，但自定义命令没生效
优先检查：
commands.yml是否真的在plugins/AchieveMaster/下- 改完后是否执行了
/ach reload - 命令是否配置了权限，执行者有没有该权限
- 该命令对应的成就是不是用的
COMMAND/指令触发器
区域触发器没有反应
先确认三件事：
regions/目录里的文件没有以下划线_开头- 你填的是自定义区域 ID，或者是
wg:区域名这种 WorldGuard 写法 - 玩家真的发生了“进入”或“离开”边界，不是一直站在区域里面
PAPI 占位符返回空
- 先确认服务器装了
PlaceholderAPI - 再确认控制台里有
PlaceholderAPI 扩展已注册 - 最后再检查你写的是
%achievemaster_*%，不是别的前缀