玩家能力

玩家能力是一个为玩家添加能力的框架。它支持玩家按需使用的主动能力、始终生效的被动能力，以及在满足条件时自动触发的触发式能力。能力拥有等级、冷却时间和可选要求，一切都可以通过数据包进行调整。此外还提供了许多配置选项。

请查看网站以获取关于如何使用此模组的详细说明。你也可以看看 Player Abilities: Reverie 模组来了解一些实现案例。

此模组不添加任何能力，它只提供创建和将能力添加到游戏中的 API 和框架。它的目的是让你为自己制作专属的能力。如果你想尝试一些能力，你可以下载我为我的整合包实现能力的配套模组：Player Abilities: Reverie。

三种能力类型

主动能力由玩家选择和施放。一个能力可以立即释放、蓄力施放（按住蓄力，然后松开释放），或引导施放（在持续维持时效果运行）。使用能力时可能需要保持站立不动，并且可能被伤害打断，屏幕上会显示进度条和倒计时。

当前选择的能力会显示在 HUD 上。

要选择新能力，你可以打开能力环（默认键：'z'）。它会显示你拥有的每一个能力。如果你拥有超过10个能力（或者配置设置了按类型区分能力），你可以在打开能力环后使用鼠标滚轮在不同的能力环页面之间切换。

被动能力在你拥有它们时持续生效。它们可以提供属性加成，如生命值、速度、触及距离或跳跃强度，或者运行自定义的持续行为。被动能力可以在能力书中开关。

触发式能力会在满足条件时自动触发。例如：在受到本应致命的攻击时幸存下来、在受到伤害后获得速度等。触发条件包括击杀、死亡、暴击、盾牌格挡、坠落、跳跃、进食、睡眠、获得经验值、重生、生命值低于阈值等等。每个触发式能力都有自己的冷却时间，并在触发时和再次准备好时显示通知。

这些都是测试能力，不包含在模组中。

核心系统

• 能力等级。能力的效果、冷却时间和蓄力时间可以随等级缩放。
• 冷却时间与要求。一个能力可以有冷却时间，以及诸如击杀数或受到伤害值之类的要求。所有条件都必须满足才能再次使用。
• 效果。能力在使用时可以施加计时效果，可以是标准的药水效果，也可以是由开发者编写的完全自定义的持续行为。
• 冷却缩减属性，可以通过装备和效果进行修改。

能力卷轴

每一个已注册的能力，包括其他模组添加的能力，都会自动获得一个对应的能力卷轴物品。使用卷轴会让玩家学会该能力。卷轴按能力类型进行颜色编码，并被收集在它们自己的创造模式物品标签中。它们非常适合用于战利品表和任务奖励。

操作控制

四个按键绑定，均可在控制菜单中重新绑定。默认按键不与任何原版键位冲突：

• Z：能力环（打开径向选择器；滚动鼠标滚轮可在类别页面间切换）。
• X：使用当前选择的能力。
• C：切换当前选择的能力。
• N：查看能力（打开能力书）。

用户界面

• 一个用于选择主动能力的径向环，按类别分组到多个页面中。
• 一本能力书，列出你所掌握的所有能力，按类型分页，工具提示显示描述、冷却时间、等级和要求。被动能力在此处进行开关。
• 一个 HUD 部件，显示当前选择的能力、其冷却时间、生效效果计时器和就绪通知。它有四种显示模式（始终、情境、最小化、隐藏），并且可以放置在屏幕的任意角落。

数据包配置

每个游戏内的数值都可以通过数据包按能力进行覆盖：冷却时间、蓄力时间、要求、最大等级、效果持续时间、属性和效果赋予、类别以及下面的模组兼容配置。任何能力都不需要配置文件。数据包中的值会覆盖默认值。

模组兼容性（全部可选）

• Project MMO：根据技能等级限制能力使用，并根据技能进度授予能力/能力等级。
• Pufferfish's Skills：技能树节点可以授予和提升能力等级。授予状态与技能树保持同步，包括重置。
• Iron's Spells 'n Spellbooks：能力消耗魔法值（计划中）。

该模组可以独立运行。当安装了其他相关模组时，兼容性会自动激活。

面向开发者

玩家能力是作为 API 构建的。能力通过注册表进行注册。属性和效果赋予在单一方法中声明。触发式能力会订阅内置的触发点，模组也可以定义并触发自己的触发点。该框架处理赋予、等级、冷却时间、要求、持久化、同步和用户界面。可取消的事件允许其他模组限制或观察能力的使用。

开发路线图

• 原型：自定义种族和职业（或你为某个能力组配置的任何内容），定义为等级化的能力包，并作为一个整体授予。
• Iron's Spellbooks 魔法值集成。
• 更多的触发点和要求类型。

需要 NeoForge 运行于 Minecraft 1.21.1。