Skip to content

AchieveMaster - 成就大师

AchieveMaster 是一套由触发器、成就文件、任务模式和脚本驱动的成就内容框架。

AchieveMaster 专门用来做 Minecraft 服务器里的成就、任务、收集、探索、排行榜和积分奖励体系。它不只是“玩家完成后亮一下图标”这么简单,而是把触发器、分类、GUI、成就分、可领取奖励、任务接取提交、PAPI 展示、自定义区域、脚本命令和自定义函数都放进了同一套框架里。

如果你要做的是“击杀多少怪、进入哪些区域、拥有哪些物品、完成哪些任务、满足哪些脚本条件后给玩家进度、积分、奖励、称号或后续玩法入口”,AchieveMaster 很适合这类内容。

你可以用它做什么

  • 做原版击杀、MM 击杀、CustomNPCs 击杀、背包收集、区域探索、聊天、指令、定时检测等常规成就
  • 把成就做成任务模式,让玩家手动接取、手动提交、交物品、付金币、限次数、可取消
  • points-rewards.yml 把成就分做成第二层奖励线,适合兑换、阶段奖励、成长线
  • commands.yml 动态注册签到、兑换、查询积分这类脚本命令,不用重启就能热重载
  • regions/ 自定义区域,或者直接接 WorldGuard 区域做区域型成就
  • scripts/functions/ 写自己的 YML、TQS、Java、JS/AV 函数,把整套成就逻辑继续扩展
  • 把 PAPI 数据接进计分板、菜单、龙核界面、全息、聊天前缀和别的插件里

推荐阅读顺序

  1. 安装与启动
  2. 命令与权限
  3. 配置总览
  4. 成就文件结构
  5. 触发器与任务
  6. 脚本概览
  7. PAPI 占位符

新手最快上手路径

如果你是第一次接触 AchieveMaster,建议按下面的顺序做:

  1. 装好插件并确认 /ach/achievement 可以使用。
  2. 打开 plugins/AchieveMaster/achievements/examples.yml,先保留一个最小示例。
  3. 先改 categories.yml,做出你自己的分类和图标。
  4. 再做一个最简单的触发器成就,例如击杀、聊天或进入区域。
  5. 确认 /ach list/ach progress、GUI 和描述占位符都能正常显示。
  6. 最后再接入任务模式、积分奖励、动态命令、自定义函数和外部插件联动。

这套插件主要由哪些目录组成

  • config.yml:总控配置,管存储、同步、扫描频率、默认奖励、GUI 默认值、自定义区域兼容段
  • messages.yml:命令提示、任务提示、奖励提示、GUI 文案
  • commands.yml:动态脚本命令注册表
  • gui.yml:主界面、分类页、详情页、进度条和状态文案
  • points-rewards.yml:总成就分奖励和分类成就分奖励
  • achievements/:真正的成就内容目录,递归加载所有 .yml
  • regions/:自定义区域目录,给 REGION_ENTER / REGION_LEAVE
  • scripts/functions/:可复用自定义函数目录,支持 ymltqsjavajs

使用建议

  • 第一个版本一定先做“最小闭环”:一个分类、一个成就、一个触发器、一个奖励。
  • 简单条件优先用 条件 + 进度,复杂逻辑再上脚本,不要一上来把每个成就都写成大段脚本。
  • 任务模式、成就模式、积分奖励是三层东西,建议分开设计,不要混成一团。
  • commands.yml 更适合做签到、兑换、查询这类主动入口;事件成就还是回到 achievements/ 里维护。
  • 公共逻辑尽量抽到 scripts/functions/,后面改平衡和改联动会轻松很多。

常见文档入口

TQ Minecraft Server Plugin Docs