体力系统

体力系统为副本进入添加了能量消耗机制，支持自动恢复与离线补偿。

核心机制

1. 消耗：进入副本时扣除指定体力，不足则无法进入。
2. 恢复：每隔指定时间（默认60秒）自动恢复，支持离线时长补偿。
3. 独立：体力限制与副本冷却时间独立计算，需同时满足。

配置指南

全局配置 (config.yml)

stamina:
  enabled: true          # 开启系统
  max-stamina: 100       # 上限
  recovery-rate: 1       # 每次恢复量
  recovery-interval: 60  # 恢复间隔(秒)

副本配置 (dungeons/<ID>/config.yml)

要求:
  体力消耗: 20  # 进入该副本消耗20点

管理命令

命令	说明
/dga stamina <玩家>	查看体力
/dga stamina set <玩家> <值>	设置体力
/dga stamina add <玩家> <值>	增减体力
/dga stamina reset <玩家>	重置为满

PlaceholderAPI 变量

变量	说明
%quedp_stamina%	当前体力
%quedp_max_stamina%	最大体力
%quedp_stamina_percent%	百分比
%quedp_stamina_bar%	进度条
%quedp_next_recovery%	下次恢复倒计时(秒)
%quedp_dungeon_<ID>_cost%	指定副本消耗

常见问题

Q: 如何禁用体力系统？ A: 在 config.yml 设置 stamina.enabled: false。

Q: 离线会恢复体力吗？ A: 会。玩家上线时系统会自动计算离线时长并补发体力。

Q: 副本不消耗体力怎么设置？ A: 在副本配置中设置 体力消耗: 0 或省略该项。