HealthScale

插件

· 作者 misty4119

HealthScale 是一款轻量级、原生支持 Folia 的 Minecraft 插件,它通过将庞大的生命值条压缩为可自定义的用户界面来清理高生命值的 RPG 服务器,且不会改变游戏玩法机制。

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

最新 2.1.1 · 26.2 · Folia / Paper

一键开服(送7天)

HealthScale

一款轻量级的 Paper/Folia 插件,用于缩放玩家 HUD 中的血量显示——无论玩家实际拥有多少生命值,心形血条始终渲染为配置的值。 专为高血量 RPG 服务器设计,并完全兼容 Folia 的多线程区域调度。


功能特性

  • 全局血量缩放 — 为所有世界设置一个统一的显示值
  • 按世界覆盖 — 每个世界使用不同的缩放比例(例如:RPG 世界中为 80 颗心,竞技场中为 20 颗)
  • 热重载 — /healthscale reload 会重新加载 config.yml 并立即应用到所有在线玩家,无需重启服务器
  • 运行时设置 — /healthscale set <value> 可在不修改配置文件的情况下动态更改全局缩放值
  • 原生支持 Folia — 所有玩家状态变更均通过 EntityScheduler 分发;批量操作通过 GlobalRegionScheduler 执行
  • MiniMessage 消息格式 — 所有消息均完全支持 MiniMessage 格式化
  • 可配置的数值边界 — min-scale / max-scale 防止输入无意义的数值;无效输入会自动回退到默认值

依赖要求

依赖项 版本
Java 25+
Paper / Folia 1.21 (API),已在 26.1.2 上测试
Minecraft 1.21+

该插件基于 Paper API 编译,并声明了 folia-supported: true,因此它可以在 Paper 和 Folia 上运行。


安装步骤

  1. 从 Releases 下载最新的 HealthScale-x.x.x.jar。
  2. 将其放入服务器的 plugins/ 文件夹中。
  3. (重新)启动服务器 —— 将自动生成默认的 config.yml。
  4. 根据需要编辑 plugins/HealthScale/config.yml。
  5. 运行 /healthscale reload 以应用更改,无需重启服务器。

指令

指令 描述 权限节点
/healthscale info 显示当前插件版本及激活的血量缩放值 healthscale.use
/healthscale reload 重新加载 config.yml 并应用到所有在线玩家 healthscale.admin
/healthscale set <value> 在运行时更改全局血量缩放值 healthscale.admin

别名: /hs, /hscale


权限节点

节点 默认权限 描述
healthscale.use everyone 访问 /healthscale info
healthscale.admin OP 访问 reload 和 set 子指令
healthscale.* OP 授予上述所有权限

配置说明

# plugins/HealthScale/config.yml

# 启用或禁用整体血量缩放功能
enabled: true

# 所有世界的默认显示缩放值 (20.0 = 10 颗心)
# 无论玩家实际最大 HP 是多少,HUD 始终显示这么多颗心
health-scale: 20.0

# 允许的健康缩放数值范围
min-scale: 2.0
max-scale: 2048.0

# 按世界覆盖 — 列出的世界将使用其自身的缩放值
# 未列出的世界将回退到上方定义的 health-scale
world-overrides:
  # rpg_world:
  #   health-scale: 80.0   # 你的 RPG 世界中为 40 颗心
  # arena_world:
  #   health-scale: 20.0   # 竞技场中为标准 10 颗心

# 所有消息均支持 MiniMessage 格式化
# 可用的占位符如下文注释所示
messages:
  no-permission: "<red>你沒有權限執行此指令!</red>"
  reload-start: "<yellow>正在重載 HealthScale 設定...</yellow>"
  reload-success: "<green>設定重載完成!全域血量縮放: <white><scale></white></green>"   # {scale}
  reload-invalid-scale: "<red>health-scale 數值無效(必須介於 <min> ~ <max>),已還原預設值。</red>"  # {min} {max}
  set-success: "<green>已將血量顯示縮放設為 <white><scale></white> 顆心。</green>"   # {scale}
  set-invalid: "<red>無效數值。請輸入介於 <min> ~ <max> 之間的數字。</red>"   # {min} {max}
  usage: "<red>用法:<white>/healthscale <reload|set <數值>|info></white></red>"
  info: "<aqua>HealthScale v<version> | 全域縮放: <white><scale></white> | 世界覆蓋: <white><overrides></white> 個</aqua>"  # {version} {scale} {overrides}

缩放数值参考

health-scale 显示的爱心数量
20.0 10 颗心(原版默认值)
40.0 20 颗心
80.0 40 颗心
200.0 100 颗心

玩家的真实最大生命值不会受到影响 —— 仅改变视觉表现。


工作原理

Minecraft 的 Player#setHealthScaled 和 Player#setHealthScale 方法控制客户端如何渲染心形血条。 当设置为 80.0 时,拥有 2000 最大生命值的玩家仍会看到满格的 40 颗心 —— 他们的生命值只是映射到了这个显示范围内。

HealthScale 挂钩了 PlayerJoinEvent、PlayerRespawnEvent 和 PlayerChangedWorldEvent,以便在每个相关时刻正确地(重新)应用缩放值。 在 Folia 上,所有状态变更都通过 EntityScheduler 分发到所属的区域线程,以确保线程安全。


从源代码构建

git clone https://github.com/Misty4119/HealthScale.git
cd healthscale
./gradlew shadowJar

输出的 jar 包位于 build/libs/HealthScale-2.0.0.jar。


许可证

本项目为开源项目。详情请参阅 LICENSE。


作者

由 Misty4119 制作 (Misty4119)

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源