Endurance - Endurance

你是否梦想过为服务器上的玩家添加体力系统？那么，这款插件正是为你准备的！它设计简洁，非常易于上手，其灵感来源于游戏《塞尔达传说：旷野之息》中的耐力设定。

💡核心功能

• 为玩家添加可消耗的耐力值，用于奔跑、跳跃、游泳和战斗等动作。
• 耐力耗尽时，玩家会进入疲劳状态，获得负面效果。
• 支持通过升级系统永久提升耐力效率。
• 提供可自定义的BossBar视觉显示。
• 兼容PlaceholderAPI，支持在菜单、记分板等处显示耐力信息。

🎮配置详解 (`config.yml`)

主要配置选项如下

基础设置

• endurance: 默认最大耐力值（默认：200）
• regen_rate: 耐力自然恢复速度（默认：9.0）
• sprint_drain_rate: 奔跑时耐力消耗速率（默认：0.5）

BossBar 设置

• bossbar: 是否启用BossBar显示（默认：true）
• bossbar-color: BossBar颜色（例如：GREEN）

升级系统

• enable_upgrade_system: 是否启用耐力升级系统（默认：true）
• upgrade_value: 每次升级减少的奔跑消耗速率（默认：0.1）
• upgrade_cost: 每次升级所需费用（默认：1000）
• minimum_sprint_drain_rate: 奔跑消耗速率的最小值（默认：0.1，不可低于此值）

行为与效果

• glow-berries-effect: 食用发光浆果是否获得10秒无限耐力（默认：true）
• EnduranceEatingEnable: 进食是否恢复20点耐力（默认：true）
• Fatigue: 耐力耗尽时是否施加缓慢效果（默认：true）
• FatigueDuration: 疲劳效果持续时间（秒，默认：5）
• JumpDrain: 跳跃是否消耗耐力（默认：true）
• JumpDrainRate: 单次跳跃消耗量（默认：2）

战斗相关

• EnduranceCombat: 攻击挥动是否消耗耐力（默认：false）
• DrainStamina_onPlayerAttacked: 受到攻击时是否消耗耐力（默认：false）
• CombatFatigue: 启用战斗疲劳（视觉上的挖掘疲劳效果）（默认：true）

杂项

• flight_drain: 飞行（创造/旁观模式）是否消耗耐力（默认：false）
• creativemode_drain: 创造模式是否消耗耐力（默认：false）

🔧命令与权限

主要命令为 /staminagui，用于打开耐力升级界面。此命令需要升级系统已启用 (enable_upgrade_system: true)。

✨软依赖（可选）

以下插件可增强功能，但非必需

• PlaceholderAPI: 用于显示耐力相关的占位符。
• Vault: 为升级系统提供经济支持。
• WorldGuard: 允许添加自定义区域标志以控制耐力消耗。

❓常见问题与说明

• 兼容性：本插件已在 PaperMC 和 Purpur 服务端核心上测试。其他服务端核心可能无法保证运行。
• 问题反馈：如发现漏洞或错误，请勿在评论区内报告。请通过 Discord 社区联系开发者。
• 语言文件：所有提示信息可在 language.yml 文件中自定义，包括GUI标题、升级提示等。
• 占位符：如需显示最大耐力值，建议直接使用固定值（如100），无需专用占位符。

⭐链接与支持

• Discord 社区: https://discord.gg/QngnS3mjxd （欢迎反馈建议）
• 捐赠支持 (PayPal): https://www.paypal.com/paypalme/PhilippeCloutier266

💡使用条款

下载并使用本插件即表示您同意以下条款

• 未经作者许可，不得反编译本插件。
• 不得声称本插件为您所有。
• 未经询问，不得在其他网站发布本插件（YouTube视频需注明来源）。
• 仅限在您自己的服务器/网络中使用。
• 不得窃取插件代码。
• 本条款可能随时更新。

耐力系统插件为玩家引入了体力值机制，使其在奔跑时消耗体力，从而为服务器增添了新的策略维度。玩家可以通过升级系统提升体力恢复速度，并利用发光浆果等物品获得增益效果。

💡命令与权限

• /staminareload - 重载插件配置与语言文件。

- 所需权限：`stamina.reload`

• /staminagui - 打开升级界面。

- 所需权限：`stamina.gui`

• /staminaedit <玩家> <数值> - 编辑指定玩家的体力消耗速率。

- 所需权限：`stamina.edit`

• /staminarefill - 立即补满体力。

- 所需权限：`stamina.refill`

• /staminaupgrade - 为玩家升级体力消耗速率（需金钱）。

- 所需权限：`stamina.upgrade`

🎮升级系统 (3.0.0+)

从 3.0.0 版本开始，插件引入了升级系统。此系统不再提升最大耐力值，而是专注于降低玩家的奔跑体力消耗速率。

系统运作方式

• 玩家可使用 /staminaupgrade 或 /staminagui 命令来消耗游戏内金钱进行升级。
• 每位玩家的体力消耗速率数据都存储在 playerdata.yml 文件中。
• 新玩家的默认体力消耗速率为 0.5，你可以在 config.yml 中修改此默认值。

管理功能

• 管理员可以使用 /staminaedit <玩家> <数值> 命令直接修改任何玩家的体力消耗速率。
• 此系统目前处于测试阶段。你可以通过移除 stamina.upgrade 权限来为特定玩家禁用升级功能。

⭐占位符

插件提供了以下 PlaceholderAPI 占位符，可用于在聊天、计分板或其他支持 PlaceholderAPI 的插件中显示体力信息：

• %stamina_stamina% - 显示当前体力值。
• %stamina_stamina_200% - 显示当前体力值（基于200为满值）。
• %stamina_short_stamina_bar% - 显示简洁体力条。
• %stamina_stamina_bar% - 显示标准体力条。
• %stamina_custom_stamina_bar% - 显示自定义体力条。

> 提示：如果需要显示最大体力值，可以直接使用数字 100，无需专门的占位符。

✨发光浆果特性

插件包含一个可选的增益特性：食用发光浆果。

• 当玩家食用发光浆果后，将获得 10 秒钟的无限体力 效果。
• 此特性默认启用，但你可以在 config.yml 配置文件中将其关闭。