Skip to content

函数总览

AchieveMaster 的读取型函数、计算型函数和一部分桥接函数,最终都会注册进同一个 FunctionRegistry
只要函数注册成功,AST、script-js、自定义函数都能调用到它。

当前总量

按当前源码统计:

  • builtin 注册调用次数:241
  • 最终唯一函数名:238
  • 已确认重名冲突:3

当前文档已经不再把函数塞进几张超长表里,而是按主题拆成独立分类页,阅读方式和 DungeonMaster 的脚本函数页保持一致。

阅读顺序

  1. 数学与随机
  2. 文本与数组
  3. 时间、逻辑与类型
  4. 玩家与世界
  5. 物品与方块
  6. 成就、变量与标记
  7. 集成与外部能力

这一层的定位

  • 普通函数适合做计算、判断、拼文本、取状态。
  • 带副作用但仍走函数入口的桥接能力,也统一放在函数分类里说明。
  • 真正以“发效果、改进度、执行流程”为主的内容,统一看 动作总览

运行时查看方式

如果你要确认服务器当前真正注册了哪些函数,最稳的是直接看命令输出:

text
/ach functions
/ach functions 数学
/ach functions 获取成就
/ach functions 发送消息

重要规则

  • 注册顺序是“先注册保留,后注册跳过”,不是后者覆盖前者。
  • 取玩家变量设置玩家变量获取成就目标进度 这三个名字存在重名注册,文档已按最终生效实现来写。
  • 自定义函数和 script-js 也会共享这套注册表,不需要把它们当成完全独立的第二套 API。

TQ Minecraft Server Plugin Docs