TrackerAPI

TrackerAPI

一个用于Hytale服务器的共享追踪器。一次挂接引擎,将每个方块、物品、战斗、移动和世界事件以类型化事件、按玩家计数器以及可搜索日志的形式交给其他插件。服务器端。

实用

遇到问题或有想法,请加入我的 Discord https://discord.gg/mKgxyk6qvb

每个统计、成就和地图插件都会各自挂接相同的引擎事件。安装四个这样的插件,服务器就会把每次方块破坏追踪四次,而且这四个插件对计数的结果仍然不一致。TrackerAPI 只追踪一次,其他插件从它那里读取。单独安装它不会向玩家显示任何内容。请将它和依赖它的插件一起安装,或基于它进行开发。

它记录的内容

62 种事件。包括方块被破坏、放置、使用和损坏,并记录该方块是否由玩家自己放置。物品合成、拾取、食用、丢弃和丢失,以及来自哪个箱子。每一次命中和死亡,记录参与者,包括在 Boss 死亡前攻击过它的所有人。加入、世界切换、传送、聊天、区域、坐骑、天气、月相、时钟和区块。每秒一次位置采样,记录行走、游泳、滑翔和骑乘的距离。

除此之外,它还会为每个曾经加入过的玩家保留终身计数器,按方块、物品和生物,按世界统计,排行榜每分钟重建一次。日志以每世界每小时为文件的形式在磁盘上保留 14 天的事件,因此 /trackerapi lookup here --radius 8 --hours 12 可以告诉你昨晚谁破坏了你周围的方块。

首次启动时,它会从服务器上已有的 Feats 和 Chronicle Stats 文件导入计数器,因此没有人从零开始。

与我的其他模组配合

全部为可选,且每个模组无需 TrackerAPI 也能运行。每个都有一个设置项,可选 auto、always 或 never,默认为 auto。

模组 与 TrackerAPI 配合时的作用
Feats 1.5.0+ 移除自己的挂接,改为接收 34 种事件用于其成就
Chronicle Stats 1.2.0+ 仪表盘上的所有统计和记录,以及 Dominion 各阵营的计数器
Atlas 1.6.0+ 活动热力图层和击杀信息流
Coinage 1.0.0+ 击杀和方块奖励,并将赚取和花费的金钱写回为带排行榜的计数器
Dominion Factions 0.5.1+ 采集任务,并写入 25 个阵营计数器,其中 23 个带排行榜
SocialBridge 0.2.0+ 在 Discord 中发布加入、离开、死亡和 Boss 击杀消息,以及 /profile 统计和 /top
RestAPI 0.2.0+ 在 /api/tracker 下提供计数器、排行榜、最近事件和日志查询

Lullaby 与它没有关联。TrackerAPI 自行统计睡眠次数。

Coinage、Dominion Factions、SocialBridge 和 RestAPI 尚未上架 CurseForge,因此这四个链接将在它们首次上传后生效。执行 /plugin reload Ryvrook:TrackerAPI 后,全部七个模组会自行恢复,每个仅恢复一次。

开销

一个无人需要的挂接只消耗一次易失读取。监听器在 TrackerAPI 自己的线程上运行,每批预算 50 毫秒,因此缓慢的插件会收到警告并被暂停,绝不会拖慢 tick。当我的全部七个模组都订阅时,一个方块事件在该线程上消耗 72 到 75 纳秒。/trackerapi perf 显示每个挂接在你的服务器上的开销。

命令

全部需要 trackerapi.admin 权限。/trackerapi status 显示哪些模组在哪个版本使用它、它们的订阅、队列和日志大小。perf、recent kind、lookup、counters player、top key、import 和 reload 按字面意思执行。设置位于 mods/Ryvrook_TrackerAPI/TrackerAPI.json,README 列出了每个键。

面向插件作者

将 Ryvrook:TrackerAPI 列为可选依赖,将其导入集中在一个类中,并在 TrackerApi.isPresent() 之后加载该类,然后从 TrackerApi.onEnable 进行订阅。记录只会增加字段。你的插件可以在自己的前缀下写入自己的计数器并获得排行榜。GitHub 上的 README 有示例。

限制

需要服务器 0.7.0 或更新版本以及 Java 25。它在我自己的服务器上与 Feats、Chronicle Stats 和 Atlas 一起运行,但我尚未在大量玩家的情况下进行测量。如果某个计数看起来不对,请在 Discord 上告诉我。

PREFAB_PASTED 存在于 API 中但从不发送,因为在 0.7 上挂接它会导致世界崩溃。

链接