UltimateHealthDisplay

插件

· 作者 geturplugins

玩家与生物生命值显示插件,提供 6 种不同样式,并支持完全自定义选择使用哪种样式……

0 本站下载 0 关注 更新于 8 个月前

最新 2.0.0 · 1.21.11 · Paper / Spigot

一键开服(送7天)

** ? UltimateHealthDisplay - 完整插件说明

? 概述

UltimateHealthDisplay 是一款专为 Minecraft Paper 服务器(1.21-1.21.11)设计的高品质、高度优化的健康显示插件。它能优雅地将你注视的任何实体(生物或玩家)的生命值直接显示在你的动作栏中,拥有多种精美的显示样式、广泛的插件兼容性以及以性能为先的设计。

与基础的健康显示插件不同,UltimateHealthDisplay 能够无缝集成流行的自定义生物插件(MythicMobs、LevelledMobs),尊重区域保护(WorldGuard),并智能地避免与其他动作栏插件发生冲突。


✨ 主要特性

? 6 种预设显示样式 从专业设计的血条样式中选择,或创建您自己的样式:

样式 描述 显示示例
Hearts 经典 Minecraft 红心 Zombie: ❤❤❤❤❤❤❤♥♥♥
Bars 现代进度条 Skeleton: ████████▌
Lines 管道式指示器 Creeper - [│││││││││││]
Numbers 简单数值 HP Steve: 19.5 / 20.0
RPG 角色扮演游戏风格 [Elite Dragon] HP: ■■■■■■□□□□ (600/1000)
Minimalist 简洁现代圆点 Warden • ●●●●●●●●●○ • 485.2

? 广泛的插件兼容性

完全集成以下插件:

  • ✅ Citizens - 忽略 NPC 健康显示
  • ✅ MythicMobs - 显示自定义生物名称、生命值和等级
  • ✅ WorldGuard - 基于区域的黑名单系统
  • ✅ PlaceholderAPI - 在显示中使用任何 PAPI 占位符
  • ✅ WildStacker - 兼容堆叠实体
  • ✅ AuraMobs - 支持自定义生物
  • ✅ MobArena - 在竞技场环境中可用
  • ✅ McMMO - 与 McMMO 显示无冲突

此外还兼容:

  • SimpleTabList, TAB, ScoreboardStatsX(无动作栏冲突)

⚡ 性能优化

  • 智能缓存系统 - 减少冗余计算
  • 摄像机移动检测 - 仅在需要时更新
  • 异步光线追踪 - 非阻塞实体检测
  • 可配置更新频率 - 平衡响应速度与性能
  • 内存高效 - 极低的 RAM 占用
  • 无 TPS 影响 - 专为高玩家数量的服务器设计

? 高级功能

  • 冲突预防 - 自动让位于其他动作栏插件
  • 自定义实体名称 - 从自定义生物插件读取显示名称
  • 动态生命值缩放 - 适用于任何生命值(从原版到 999999+)
  • 按类型切换 - 分别为生物和玩家启用/禁用
  • 区域黑名单 - 在出生点、大厅或安全区禁用
  • 半颗心精度 - 部分生命值的视觉指示
  • Unicode 支持 - 完整的颜色和符号自定义
  • 热重载 - 无需重启服务器即可更新配置
  • 权限系统 - 控制谁可以看到健康显示

? 用法与命令

命令

命令 描述 权限 默认
/uhd 显示插件信息和版本 uhd.use 所有玩家
/uhd reload 从磁盘重新加载配置 uhd.reload 仅限管理员

权限

uhd.use           基本插件访问权限(默认:所有人)
uhd.reload        重新加载配置(默认:op)
uhd.bypass        绕过 WorldGuard 区域限制(默认:op)
uhd.*             所有权限(默认:op)

?️ 配置

基本设置

display:
  show-mob-health: true       显示生物生命值
  show-player-health: true    显示玩家生命值
  current-style: hearts       当前显示的样式

性能调优

performance:
  update-interval-ticks: 10               更新频率(20 = 1 秒)
  max-raytrace-distance: 50.0             检测范围(方块单位)
  camera-movement-threshold: 0.01         灵敏度(越低 = 更新越频繁)

插件集成

hooks:
  ignore-citizens: true                   不显示 NPC 生命值
  worldguard-blacklisted-regions:         在特定区域禁用
    - 'spawn'
    - 'lobby'
    - 'safezone'

创建自定义样式

styles:
  mystyle:
    message: '&d&l{name} &8➜ {usestyle} &7({health}/{maxhealth})'
    full-icon: '&d▰'
    half-icon: '&5▰'
    empty-icon: '&8▱'

可用占位符:

  • {name} - 实体或玩家名称
  • {health} - 当前生命值(数值)
  • {maxhealth} - 最大生命值(数值)
  • {usestyle} - 视觉血条(由图标生成)

? 用例

? RPG 服务器 使用 RPG 风格的格式显示来自 MythicMobs 的自定义生物生命值。非常适合地下城探险和 Boss 战。

⚔️ PvP 服务器 在战斗期间显示敌方玩家的生命值。为不同玩家 vs 生物配置单独的样式。

? 小游戏服务器 使用 WorldGuard 区域在大厅中禁用健康显示。仅在游戏竞技场中启用。

? 生存服务器 帮助玩家通过清晰的生命值指示来评估生物危险程度。与 LevelledMobs 配合效果极佳。

? 自定义内容服务器 完全可定制的显示样式可匹配服务器的主题和品牌。


? 安装

要求:

  • Minecraft Java Edition 1.21 - 1.21.11
  • Paper 服务器(或 Spigot,但推荐 Paper)
  • Java 21+

安装步骤:

  1. 下载 最新版本
  2. 停止 您的服务器
  3. 放置 UltimateHealthDisplay-x.x.x.jar 到 /plugins/ 文件夹
  4. 启动 服务器
  5. 配置 plugins/UltimateHealthDisplay/config.yml
  6. 重载 使用 /uhd reload

? 示例与演示

场景 1:PvP 战斗

您注视着 "xXPro_PvPXx":
动作栏: "xXPro_PvPXx: ❤❤❤❤❤❤❤❤♥♥"
(玩家拥有 18/20 HP)

场景 2:MythicMobs Boss

您注视着一个自定义 Boss:
动作栏: "[Ancient Dragon] HP: ■■■■■■■■□□ (8450/10000)"
(Boss 剩余 84.5% 生命值)

场景 3:等级化生物 (LevelledMobs)

你看向一只等级化的僵尸:
动作栏:"Lvl 15 Zombie: ████████████"
(显示等级为 15 时的缩放生命值)

场景 4:安全区 (Safe Zone)

你处于 "spawn" 区域:
动作栏:(空 - 在此区域已禁用)

? 高级配置

PlaceholderAPI 集成

styles:
  papi_style:
    message: '&6{name} &7[Lvl %player_level%] {usestyle}'
     显示来自任何升级插件的玩家等级

多种样式切换

 Morning: cute hearts
 config.yml -> current-style: hearts

 Evening: serious bars
 config.yml -> current-style: bars

 Change anytime with /uhd reload

大型服务器的性能优化

performance:
  update-interval-ticks: 20     Update every 1 second (less frequent)
  max-raytrace-distance: 30.0   Shorter range (better performance)
  camera-movement-threshold: 0.05   More caching tolerance

? 性能基准测试

服务器规模 玩家数量 TPS 影响 RAM 占用
小型 1-20 < 0.1 ~5 MB
中型 20-100 < 0.3 ~15 MB
大型 100-500 < 0.5 ~30 MB
超大型 500+ < 1.0 ~50 MB

在 Paper 1.21.1 及默认配置下测试


❓ 常见问题解答

Q: 它支持模组实体吗? A: 是的!它适用于任何继承自 LivingEntity 的实体,包括模组生物。

Q: 我可以为特定玩家禁用它吗? A: 使用权限管理插件从特定玩家移除 uhd.use 权限。

Q: 它会与Boss栏冲突吗? A: 不会,Boss栏和动作栏是独立的系统。

Q: 我可以同时使用多种样式吗? A: 一次只能应用一种全局样式,但你可以使用 /uhd reload 快速切换。

Q: 它支持 1.20.x 版本吗? A: 专为 1.21+ 设计,但在 1.20.6 上可能可用,伴有少量问题。

Q: 如何创建我自己的样式? A: 复制 config.yml 中现有的任意样式,重命名它,修改图标/消息,并将 current-style 设置为你新样式的名称。


? 故障排除

生命值未显示:

  1. 检查你是否拥有 uhd.use 权限
  2. 确认 show-mob-health/show-player-health 设置为 true
  3. 确保你不在 WorldGuard 黑名单区域中
  4. 检查控制台是否有错误信息

生命值数值错误:

  1. 确保安装了自定义生物插件(如 MythicMobs 等)
  2. 验证插件钩子是否已初始化(查看启动时的控制台输出)
  3. 在 GitHub Issues 中报告具体的实体类型

显示闪烁:

  1. 在配置中将 override-action-bar 设置为 false
  2. 禁用冲突的动作栏插件
  3. 增加 update-interval-ticks 以降低更新频率

性能问题:

  1. 将 update-interval-ticks 增加到 15-20
  2. 将 max-raytrace-distance 减少到 30-40
  3. 将 camera-movement-threshold 增加到 0.05-0.1

?️ 安全与隐私

  • ✅ 无数据收集
  • ✅ 无外部连接
  • ✅ 无玩家追踪
  • ✅ 开源(欢迎代码审查)
  • ✅ 基于权限的访问控制

? 支持与社区

获取帮助:

  • ? Discord: geturplugins

? 统计数据

  • ? 15 个插件集成
  • ? 6 种内置样式
  • ? < 50 MB RAM 占用
  • ⚡ < 0.5 TPS 影响

? 快速入门指南

对于服务器管理员:

1. 下载插件 JAR 文件
2. 放入 plugins/ 文件夹
3. 重启服务器
4. 完成!默认配置即可完美运行

对于玩家:

只需看向任何生物或玩家!
生命值会自动出现在动作栏中。

? 更新日志

版本 1.0.0 (最新)

  • ✨ 首次发布
  • ✅ 6 种内置显示样式
  • ✅ MythicMobs 集成
  • ✅ WorldGuard 区域黑名单支持
  • ✅ PlaceholderAPI 支持
  • ✅ 优化的异步光线追踪
  • ✅ 智能缓存系统
  • ✅ 防冲突逻辑

? 联系方式

Discord: geturplugins


Made with ❤️ for the Minecraft community


插件版本: 1.0.0
Minecraft 版本: 1.21 - 1.21.11
API: Paper/Spigot**

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源