messages.yml

messages.yml 管的是 AchieveMaster 的聊天提示、帮助文本、任务提示、奖励提示和一部分 GUI 文案。

如果你想统一服里的措辞、颜色、前缀、提醒强度，优先改这里。

主要分组

分组	用途
prefix	消息前缀
general	无权限、仅玩家、玩家不存在、重载成功这类通用提示
help	/ach help 的帮助文本
usage	参数不足时的用法提示
list / info / progress	成就列表、详情、进度提示
points	成就分提示
leaderboard	排行榜文本
admin	管理员操作结果
quest	任务接取、提交、取消、状态提示
reward	奖励列表与领取结果
achievement	成就完成提示
gui	GUI 按钮和状态文案

prefix

prefix: "&6[成就] "

这类前缀适合统一全服的成就系统风格。

如果你已经有统一消息格式，也可以把这里改短，甚至只保留一个颜色标签。

占位符替换

消息里的占位符是按命令调用时传进去的，最常见的是这些：

• {player}
• {achievement}
• {name}
• {id}
• {category}
• {progress}
• {target}
• {points}
• {rank}
• {flag}

例如：

admin:
  give-success: "&a已给予 &e{player} &a成就 &e{achievement}&a！"

这类替换只对当前这条消息定义好的参数生效，不是任意字段都能随便写。

颜色和格式

按当前实现，messages.yml 支持常见 Bukkit 颜色码：

• &0 到 &f
• &l
• &m
• &n
• &o
• &k
• &r

所以你可以直接这样写：

achievement:
  unlock-title: "&6成就达成！"
  unlock-subtitle: "&e{name}"

最值得先改的几块

help

这块会直接影响 /ach help 给玩家和管理员的第一印象。

如果你服里只开放部分子命令，建议连帮助文本一起裁掉，别让玩家看到一堆不会开放的命令。

quest

任务系统最容易被玩家频繁看到的就是这一组：

• 接取成功
• 未完成
• 已完成待提交
• 取消失败

这块文案写清楚，能少很多“我明明做完了为什么不能交”的问答。

reward

成就分奖励的领取提示、分数不足提示、已领取提示，建议尽量写得直接一点。

gui

虽然 GUI 的结构在 gui.yml，但很多按钮提示、状态文字、奖励状态文字实际在这里。

使用建议

• 文案层的调整尽量只放在 messages.yml，不要和 gui.yml、成就描述一起混改。
• 管理提示和玩家提示尽量分得明显一点，尤其是 admin 和 quest。
• 帮助文本如果和你实际开放的命令不一致，玩家会直接以帮助页为准。

常见问题

改了消息没有生效

先确认：

• 改的是 plugins/AchieveMaster/messages.yml
• 改完后是否执行了 /ach reload
• 你看到的那条文本到底来自 messages.yml，还是来自成就描述 / gui.yml

某个占位符没替换

先检查这两件事：

• 占位符名字是不是和源码传入的一致
• 这条消息在当前命令路径里是不是真的传了这个参数

如果你写了一个消息里根本没有被传入的占位符，它就只会原样显示。