【BossBarHealth】 - 最佳RPG血条插件

还在寻找一款能按你心意显示玩家血量的 Boss 血条插件吗？这正是你所需要的！

BossBarHealth 是一款高度可定制的 Boss 血条插件，能够同时显示玩家自身和敌人的生命值、方向等信息，并提供丰富的自定义选项与多款流行插件兼容。

💡核心特性

• 双血条显示：可完全自定义并独立开关的自身血条与敌人血条。
• 视觉自定义：

- 支持多种 Boss 血条颜色。

- 支持多种 Boss 血条分段样式。

- 可按比例缩放血条显示的生命值（例如，用于显示护盾值等）。

• 智能显示：

- 可设置仅在玩家攻击敌人时才显示敌人血条。

- 可为没有自定义名称的生物设置显示名称（见 `lang.yml`）。

- 可设置实体类型黑名单，屏蔽特定类型实体的血条显示。

• 丰富信息：

- 在血条上显示玩家及敌人的面向方向与角度。

- 提供大量占位符（详见 `config.yml`）。

• 插件兼容：

- 支持 PlaceholderAPI（自 v3.1.0 起）。

- 支持 WorldGuard（自 v4.0.0 起）。可在进入/离开特定区域时改变血条颜色与样式（需在配置中启用）。

- 支持 Citizens（自 v4.1.4-SNAPSHOT 起）。可正确显示 Citizens NPC 的名称（需在配置中启用）。

- 支持 MythicMobs（自 v4.1.7-SNAPSHOT 起）。可正确显示 MythicMobs 实体的名称（需在配置中启用）。

- 支持 Adventure API 颜色代码（自 4.1.15-SNAPSHOT 起）。可使用 MiniMessage 格式实现颜色与渐变效果。

🎮命令与权限

**主命令**

• /BossBarHealth
• /bbh

**命令列表**

• /bbh Show：向玩家显示 Boss 血条。
• /bbh Hide：对玩家隐藏 Boss 血条。
• /bbh Help：显示帮助页面。

**权限节点**

• BossBarHealth.Admin：授予使用所有 BossBarHealth 命令的权限。（默认：管理员）
• BossBarHealth.Hide：授予使用 /bbh Hide 命令的权限。（默认：所有人）
• BossBarHealth.Show：授予使用 /bbh Show 命令的权限。（默认：所有人）

🔧配置详解 (YAML)

以下是 config.yml 的核心配置结构说明：

BossBarHealth:
  # 所有数字（当前生命、最大生命、失去/获得的生命值）显示的小数位数
  Decimal: 2
  # 在这些世界中隐藏 Boss 血条
  WorldsHidden:
    - dungeon

  Self:
    Enabled: true # 是否始终显示自身血条
    Color: GREEN # 血条颜色 (BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW)
    Style: SEGMENTED_20 # 血条样式 (SEGMENTED_10, SEGMENTED_12, SEGMENTED_20, SEGMENTED_6, SOLID)
    Scale: 1.0 # 生命值显示比例
    Format: # 显示格式
      Normal: '%direction_cardinal% %displayname% %hp%/%max%' # 常态显示
      Dead: '%direction_cardinal% %displayname% Dead &7(&c-%change%&7)' # 死亡时
      HpLost: '%direction_cardinal% %displayname% %hp%/%max% &7(&c-%change%&7)' # 失去生命时
      HpGain: '%direction_cardinal% %displayname% %hp%/%max% &7(&a+%change%&7)' # 获得生命时
    Duration: # 各状态显示时长（单位：游戏刻）
      Normal: 40
      Zero: 10
    Facing:
      Refresh: 20 # 面向方向改变时，血条信息更新的频率

  Enemy:
    Enabled: true # 攻击时是否显示敌人血条
    Color: GREEN
    Style: SEGMENTED_20
    Scale: 1.0
    Override: false # 敌人血条激活时，是否覆盖自身血条
    Format: # 显示格式（可使用所有自身血条的占位符，以及以下敌人专属占位符）
      Dead: '%e_name% Dead &7(&c-%e_change%&7)'
      SelfDead: '%e_name% %e_hp%/%e_max% &7(&c-%e_change%&7)' # 玩家死亡时
      HpLost: '%e_name% %e_hp%/%e_max% &7(&c-%e_change%&7)'
      HpGain: '%e_name% %e_hp%/%e_max% &7(&a+%e_change%&7)'
    Duration:
      Normal: 40
      Zero: 10
    Facing:
      Refresh: 20
    Blacklist: [ ] # 实体类型黑名单，列出的实体将不显示血条，例如：- COW

  DamageCause: # 玩家受到特定类型伤害时，自身血条的显示样式
    Default: # 未在下文指定的伤害类型
      Color: RED
      Style: SEGMENTED_20
    FALL: # 例如：摔落伤害
      Color: WHITE
      Style: SOLID

  Direction: # 方向显示的翻译文本
    Ordinal:
      Full:
        East: East
        South: South
        West: West
        North: North
      Short:
        East: E
        South: S
        West: W
        North: N
    Cardinal:
      Full:
        NorthEast: NorthEast
        SouthEast: SouthEast
        SouthWest: SouthWest
        NorthWest: NorthWest
      Short:
        NorthEast: NE
        SouthEast: SE
        SouthWest: SW
        NorthWest: NW

  Hooks: # 兼容插件设置
    Citizens:
      Enabled: true
    MythicMobs:
      Enabled: true
    WorldGuard:
      Enabled: true
      Regions:
        'spawn': # 区域名称
          Color: BLUE
          Style: SOLID
        # 'shop':
        #   Color: PURPLE
        #   Style: SEGMENTED_6

可用占位符摘要

自身血条 (Self.Format)：

• %name%, %displayname%：玩家名称/显示名。
• %hp%, %max%：当前/最大生命值。
• %hp_percent%, %max_percent%：生命值百分比。
• %hp_int%, %max_int%：整数生命值。
• %direction_cardinal% 等：玩家面向方向。
• %change%, %change_percent%：生命值变化量。

敌人血条 (Enemy.Format)：

• 包含所有自身血条占位符（除 %change% 和 %change_percent%）。
• %e_name%, %e_displayname%：敌人名称/显示名。
• %e_type%：实体类型。
• %e_hp%, %e_max%：敌人当前/最大生命值。
• %e_hp_int%, %e_max_int%：整数生命值。
• %e_hp_percent%, %e_max_percent%：生命值百分比。
• %e_change%：敌人生命值变化量。
• %e_direction_cardinal% 等：敌人面向方向。

✨安装与需求

**前置需求**

• (可选) PlaceholderAPI：用于使用额外的占位符。
• (可选) WorldGuard 及 WorldGuard Events：用于在进入/离开特定区域时自定义血条颜色与样式。

**安装步骤**

• 点击页面上的“立即下载”按钮下载本插件。
• 下载上述所有所需的前置插件。
• 将本插件及所有前置插件放入服务器文件夹的 plugins 目录中。
• 重启服务器。
• 如有需要，修改配置文件。

❓常见问题

Q. 我发现了漏洞 / 控制台报错。

A. 在寻求帮助前，请尝试重新下载插件。如果你能提供足够的信息（如错误日志、复现步骤），我会尽力协助。请私信我或在讨论区留言。否则我可能无法处理。

Q. 输入命令后没有任何反应。

A. 请确保你按照正确格式输入命令，错误的参数可能导致无反应。同时，请确认插件已成功加载且未与其他插件冲突。你可以寻求帮助，但如果错误并非由本插件引起，我可能无法修复。

Q. 这个插件支持 xxx 平台 / xxx 服务端 / xxx Minecraft 版本吗？

A. 很抱歉，我无法在所有平台、服务端和 Minecraft 版本上进行测试。如果你在特定环境遇到问题，请私信我或在讨论区留言，我会尽力尝试修复。

⭐注意事项

• 你不被允许以任何形式重新分发本资源的任何部分。
• 你不被允许将本资源作为自己的作品进行分发。
• 你不被允许修改本资源的代码。
• 不建议仅就遇到的漏洞、错误或配置问题发表评价。
• “使用条款”修改时，你将不会收到通知。
• 欢迎你提出改进建议或提供技术支持，以帮助提升资源质量。
• 本资源通过 bStats 收集匿名的服务器统计数据。如需禁用，可在 plugins/bStats/config.yml 中修改设置。

仍有疑问？ 请私信我或在讨论区留言，我会尽快回复。