AchieveMaster - 成就大师
AchieveMaster 是一套由触发器、成就文件、任务模式和脚本驱动的成就内容框架。
AchieveMaster 专门用来做 Minecraft 服务器里的成就、任务、收集、探索、排行榜和积分奖励体系。它不只是“玩家完成后亮一下图标”这么简单,而是把触发器、分类、GUI、成就分、可领取奖励、任务接取提交、PAPI 展示、自定义区域、脚本命令和自定义函数都放进了同一套框架里。
如果你要做的是“击杀多少怪、进入哪些区域、拥有哪些物品、完成哪些任务、满足哪些脚本条件后给玩家进度、积分、奖励、称号或后续玩法入口”,AchieveMaster 很适合这类内容。
你可以用它做什么
- 做原版击杀、MM 击杀、CustomNPCs 击杀、背包收集、区域探索、聊天、指令、定时检测等常规成就
- 把成就做成任务模式,让玩家手动接取、手动提交、交物品、付金币、限次数、可取消
- 用
points-rewards.yml把成就分做成第二层奖励线,适合兑换、阶段奖励、成长线 - 用
commands.yml动态注册签到、兑换、查询积分这类脚本命令,不用重启就能热重载 - 用
regions/自定义区域,或者直接接 WorldGuard 区域做区域型成就 - 用
scripts/functions/写自己的 YML、TQS、Java、JS/AV 函数,把整套成就逻辑继续扩展 - 把 PAPI 数据接进计分板、菜单、龙核界面、全息、聊天前缀和别的插件里
推荐阅读顺序
新手最快上手路径
如果你是第一次接触 AchieveMaster,建议按下面的顺序做:
- 装好插件并确认
/ach或/achievement可以使用。 - 打开
plugins/AchieveMaster/achievements/examples.yml,先保留一个最小示例。 - 先改
categories.yml,做出你自己的分类和图标。 - 再做一个最简单的触发器成就,例如击杀、聊天或进入区域。
- 确认
/ach list、/ach progress、GUI 和描述占位符都能正常显示。 - 最后再接入任务模式、积分奖励、动态命令、自定义函数和外部插件联动。
这套插件主要由哪些目录组成
config.yml:总控配置,管存储、同步、扫描频率、默认奖励、GUI 默认值、自定义区域兼容段messages.yml:命令提示、任务提示、奖励提示、GUI 文案commands.yml:动态脚本命令注册表gui.yml:主界面、分类页、详情页、进度条和状态文案points-rewards.yml:总成就分奖励和分类成就分奖励achievements/:真正的成就内容目录,递归加载所有.ymlregions/:自定义区域目录,给REGION_ENTER/REGION_LEAVE用scripts/functions/:可复用自定义函数目录,支持yml、tqs、java、js
使用建议
- 第一个版本一定先做“最小闭环”:一个分类、一个成就、一个触发器、一个奖励。
- 简单条件优先用
条件 + 进度,复杂逻辑再上脚本,不要一上来把每个成就都写成大段脚本。 - 任务模式、成就模式、积分奖励是三层东西,建议分开设计,不要混成一团。
commands.yml更适合做签到、兑换、查询这类主动入口;事件成就还是回到achievements/里维护。- 公共逻辑尽量抽到
scripts/functions/,后面改平衡和改联动会轻松很多。