能力API

AbilityAPI

AbilityAPI 是一个用于 Hytale 的库模组，它添加了一套共享的玩家能力，并为服务器管理员和其他模组提供了一种简单的方式来授予和管理这些能力。

你能获得什么

• 开箱即用数十种能力：创造飞行、水下呼吸、额外氧气、摔落伤害免疫、移动速度、游泳速度、攀墙、拳击伤害、力量、按类型划分的伤害抗性、第二次机会、黑暗视觉、挖掘加速、挖掘时运、物品磁铁等等。
• 所有能力数据都会按玩家保存，并在他们重新加入或服务器重启时重新应用。
• 可选的条件，使能力仅在特定区域、阳光下、生命值低时或目标生命值低时生效。非常适合种族模组或自定义特权。

命令

所有操作都位于 /ability 下：

• /ability add – 授予一项能力。你可以添加条件，使其仅在特定情况下生效。
• /ability remove – 移除一项能力。
• /ability list – 查看你（或其他玩家）当前拥有的能力。
• /ability available – 列出所有能力 ID 和简短描述。

示例

• /ability add creative_flight – 开启创造模式飞行。
• /ability add waterbreathing – 获得水下呼吸能力。
• /ability add stamina_regen 2.0 zone 12 13 14 15 16 17 18 19 20 – 体力恢复速度翻倍，但仅在 12 到 20 区域生效。

你可以在数值后添加的其他条件选项：sunlight，health_below 50，health_above 80，target_health_below 30，target_health_above 50。对于基于区域的能力，使用 zone 后跟区域 ID 列表。

对于服务器管理员

将 AbilityAPI 的 JAR 文件放入服务器的 mods 文件夹并重启。无需配置。使用 /ability add 和 /ability remove 来授予或剥夺能力。能力存储在模组的数据文件夹中（例如 player_abilities.json），并在重启后持续存在。

对于玩家

如果你的服务器运行了 AbilityAPI，管理员或其他模组（如 Orbis Origins）可以授予你能力，例如在特定区域更快的体力恢复、水下呼吸、攀墙，或在你或你的目标生命值低时造成额外伤害。使用 /ability list 查看你拥有哪些能力，使用 /ability available 查看存在哪些能力。

其他模组

像 Orbis Origins 这样的模组可以依赖 AbilityAPI，并在你选择某个种族或完成某个任务时授予能力。AbilityAPI 是统一实现行为（飞行、抗性、移动等）的地方，因此许多模组可以重复使用相同的能力，而无需重复编写代码。

完整文档

有关完整的使用指南（所有命令、能力列表、条件和模组集成），请查看 GitHub 上的 AbilityAPI 用户与模组制作者指南。

支持

如需帮助、提供功能想法或分享你如何使用该模组，请加入 AbilityAPI 支持 Discord。