完美工具 - 开发者的可复用系统

Perfect Utils

一个为 Hytale 设计的小型库模组，供其他模组在其基础上构建。它本身不添加任何命令、物品或配置——它安静地在后台运行，让你真正关心的模组能够做更有趣的事情。

为什么安装它？

仅当其他模组要求安装 Perfect Utils 时才安装它。如果某个模组的描述中写明"需要 Perfect Utils"，请将该 jar 文件放入你的 mods 文件夹，然后即可完成。

目前提供的功能

生物眩晕基础功能

模组可以请求 Perfect Utils 在可配置的持续时间内眩晕一个生物。在被眩晕时，生物：

• 停止移动（移动速度被限定为零）
• 停止攻击（当前攻击动作被中断，AI 被抑制）
• 无法使用技能或进行交互（在持续时间内被锁定）
• 播放一个短暂的眩晕视觉效果

当眩晕效果结束时，生物会摆脱它并恢复之前的行动。

这与 narwhals 的 Perfect Parries 中实现格挡眩晕的基础功能相同，被提取为一个独立库，以便任何模组都可以使用它——技能模组可以构建"命中即眩晕"效果，武器模组可以附带暴击眩晕，Boss 模组可以在阶段中应用长时间封禁，等等。

生物仇恨 / 嘲讽基础功能

模组可以请求 Perfect Utils 控制生物关注哪个目标。在相同的底层状态下有三种形式：

• 丢弃仇恨 —— 一次性重置。在可配置半径内追踪的玩家会失去对玩家的追踪，并从其目标记忆中忘记该玩家。如果玩家仍在检测范围内，生物可能在下一个 AI 周期中重新锁定该玩家——适用于"闪现逃离追踪"，而非永久隐形。
• 抑制 —— 一段持续的"忽略我"窗口。在可配置持续时间内，半径内的生物将玩家视为非敌对状态，其目标记忆会被持续清除。适用于潜行技能和短暂的无敌阶段。
• 嘲讽 —— 相反方向。丢弃附近所有生物（盟友、嘲讽者、它们正在追踪的任何目标）的仇恨，并将它们锁定在嘲讽者身上，持续一段可配置时间。适用于坦克式"看这边"技能，可将生物从队友身上拉走。

这三种模式对世界上的任何生物都有效——Boss、敌对生物、召唤生物——无需按生物进行单独配置。

兼容性

• 可在任何 Hytale 服务器上运行。
• 与 Perfect Parries 完美配合——它们各自追踪自己的眩晕状态，不会相互冲突。
• 仇恨和嘲讽窗口按玩家追踪，因此模组不会意外重复应用；最新的请求会覆盖之前的请求。
• 无需管理配置；使用 Perfect Utils 的模组会自行设置持续时间和半径。

致谢

• narwhals —— 在 Perfect Parries 中引入原始生物眩晕；在 Zephyr 中引入生物仇恨 / 可见性清除。这两个基础功能均从其作品中提取，并在此处变为可复用。
• ziggfreed —— 将这两者提取为 Perfect Utils 独立库，并在现有的一次性丢弃功能基础上添加了持续抑制和嘲讽模式。