HangStamina - 体力插件[全版本] 1.0.1

## 插件概述

**HangStamina** 是一款全面的体力系统插件，为服务器添加真实的体力消耗机制。玩家在疾跑、跳跃等活动时会消耗体力，体力不足时将受到限制，增加游戏的游戏性和真实感。

## 核心功能

### 体力消耗系统
- **疾跑消耗**：玩家疾跑时每秒消耗体力
- **跳跃消耗**：每次跳跃消耗固定体力值
- **智能检测**：精确的疾跑和跳跃动作检测
- **可配置性**：所有消耗值均可自定义

### 体力恢复机制
- **自动恢复**：停止消耗后自动恢复体力
- **恢复延迟**：可设置恢复开始的延迟时间
- **恢复速度**：可自定义每秒恢复的体力值
- **失败惩罚**：体力不足时尝试使用会增加恢复延迟

### ActionBar显示
- **实时显示**：在ActionBar实时显示当前体力值
- **自定义格式**：支持颜色代码和变量替换
- **更新频率**：可调节显示更新间隔
- **跨版本兼容**：支持1.8-1.21.4所有版本

### 音效提醒系统
- **低体力音效**：体力低于阈值时播放提醒音效
- **耗尽音效**：体力完全耗尽时播放警告音效
- **音效映射**：自动适配不同版本的音效系统
- **完全可配置**：音效、音量、音调均可自定义

### 多世界支持
- **世界管理**：可指定在哪些世界启用体力系统
- **白名单模式**：只在指定世界启用体力系统
- **黑名单模式**：在除指定世界外的所有世界启用
- **灵活配置**：支持空列表的智能处理

### 体力不足惩罚
- **疾跑限制**：体力不足时自动停止疾跑
- **跳跃阻止**：体力不足时阻止跳跃动作
- **缓慢效果**：体力为0时给予短暂缓慢效果
- **音效警告**：配合音效提供明确反馈

## 特色亮点

### 高度可配置
```yaml
# 所有数值均可自定义
stamina:
max-stamina: 100.0 # 最大体力值
default-stamina: 100.0 # 默认体力值
consumption:
sprinting-per-second: 1.0 # 疾跑消耗
jumping: 5.0 # 跳跃消耗
regeneration:
per-second: 1.0 # 恢复速度
delay-ticks: 60 # 恢复延迟
```

### 跨版本兼容
- **智能适配**：自动检测服务器版本并选择最佳兼容方案
- **ActionBar兼容**：1.9+使用Spigot API，1.8使用NMS反射
- **音效兼容**：新版音效自动映射到旧版本
- **优雅降级**：功能失败时有合理的备用方案

### 用户体验
- **无缝集成**：不影响原版游戏体验
- **视觉反馈**：清晰的ActionBar显示
- **听觉反馈**：及时的音效提醒
- **触觉反馈**：明确的动作限制

### 权限系统
- **管理权限**：`stamina.admin` - 管理员命令权限
- **绕过权限**：`stamina.bypass` - 绕过体力消耗
- **灵活控制**：可为不同玩家组设置不同权限

## 命令系统

### 管理员命令
```
/stamina reload # 重载插件配置
/stamina set <玩家> <数值> # 设置玩家体力值
/stamina get <玩家> # 查看玩家体力值

### 命令别名
- `/st` - `/stamina` 的简化别名

## 扩展支持

### PlaceholderAPI集成
```
%stamina_current% # 当前体力值
%stamina_max% # 最大体力值
%stamina_percentage% # 体力百分比

Q群361919269 禁广 有报错或者有什么可以完善的功能可以跟我说