Stamina Attributes

耐力属性

此 API 添加了一个由实体属性控制的耐力系统。

默认实现

LivingEntities 的耐力上限为 generic.max_stamina。每经过 generic.stamina_tick_threshold 个刻，耐力会恢复 generic.stamina_regeneration。

耐力减少时，耐力恢复会暂停 generic.stamina_regeneration_delay_threshold 个刻。

当耐力 <= 0 时，耐力恢复会暂停 generic.depleted_stamina_regeneration_delay_threshold 个刻。

generic.reserved_stamina 表示当前不可用的最大耐力百分比。

generic.item_use_stamina_cost 表示使用带有耐力消耗的物品时减少的耐力值。

为物品设置耐力消耗有两种方式：

1. 位于 "staminaattributes:using_costs_stamina" 物品标签中的物品，每使用一次都会消耗 generic.item_use_stamina_cost 点耐力。当耐力 < 0 时，不会执行使用动作。在这种情况下，物品会进入冷却，冷却时间由服务器配置决定。
2. 位于 "staminaattributes:continuous_using_costs_stamina" 物品标签中的物品，在使用期间每刻都会消耗 generic.item_use_stamina_cost 点耐力。当耐力 < 0 时，使用动作会被取消。在这种情况下，物品会进入冷却，冷却时间由服务器配置决定。

默认属性值

• generic.max_stamina：10
• generic.stamina_regeneration：0
• generic.stamina_tick_threshold：20
• generic.stamina_regeneration_delay_threshold：20
• generic.depleted_stamina_regeneration_delay_threshold：60
• generic.reserved_stamina：0
• generic.item_use_stamina_cost：0

默认物品标签

"staminaattributes:using_costs_stamina"：

{
   "values": [
      "minecraft:snowball"
   ]
}

"staminaattributes:continuous_using_costs_stamina"：

{
   "values": [
      "minecraft:bow",
      "minecraft:crossbow",
      "minecraft:shield"
   ]
}

自定义

当游戏规则 "naturalStaminaRegeneration" 为 true 时，玩家的耐力恢复值至少为 1。

客户端配置允许自定义 HUD 元素。详情请参阅这篇 Wiki 文章。

服务器配置控制与游戏机制的集成，例如跳跃等各种动作的耐力消耗。

API

将 "LivingEntity" 转换为 "StaminaUsingEntity" 接口即可访问所有相关方法。