Hyper Heartrate
一个 Minecraft Fabric Mod,用于读取全世界心率广播设备的实时心率并显示到游戏内 HUD。支持华为/苹果/三星/佳明/卡西欧等 80+ 品牌 GATT 心率设备。功能特性
- 实时心率显示:通过 BLE 连接心率广播设备,实时读取心率数据并在游戏 HUD 中显示
- 联机心率同步:服务端可广播心率给附近玩家,在玩家 NameTag 上方/内部/下方显示心率,TAB 列表同步显示
- 模块化 HUD:支持模块化模式,可独立调整心率图标、心率数值、设备名称的位置
- HUD 总开关:主界面右下角一键控制游戏内心率显示,关闭后未连接时不显示灰色心率
- HUD 背景板:游戏内心率显示可开启圆角半透明背景板,支持透明度调节
- 字体大小调节:心率文字、设备名称、GUI 面板、心率图标均可独立调节大小
- 心跳模式:根据实时心率自动变色(蓝→绿→黄→红),并支持子菜单独立控制图标/心率/BPM 各自是否变色
- 设备品牌识别:自动识别 80+ 全球品牌设备并分类显示(如 [华为设备]、[苹果设备]、[佳明设备])
- HTTP API:本地 HTTP 服务,支持 OBS 浏览器源接入,含专用 /obs 跳动心脏动画接口
- RGB 颜色自定义:支持 RGBA 四通道颜色调节与实时预览
- 进程安全管理:PID 记录 + 启动清理 + taskkill 进程树,防止 .NET Host 残留
环境要求
- .NET 10(BLE 功能依赖)
- Windows 系统(BLE 通过 WinRT 实现)
- 小米设备需在设置中开启「心率广播」;其他品牌设备需开启心率广播或 GATT 心率服务(0x180D / 0x2A37)
使用说明
按键
H— 打开/关闭主界面
主界面按钮
| 按钮 | 功能 |
|---|---|
| 连接设备 | 打开设备扫描界面 |
| 断开连接 | 断开当前设备 |
| 模组设置 | 打开子菜单(GUI设置 / 心率设置 / API设置) |
| 联机功能 | 联机心率同步设置(NameTag位置、显示元素、TAB列表) |
| B站主页 | 打开 Bilibili 空间页 |
| 项目主页 | 打开 GitHub 仓库 |
| HUD 开关 | 右下角总开关,控制游戏内心率 HUD 显隐 |
联机功能
- NameTag 显示位置:上方(心率在名字上方)/ 内部(同名同行)/ 下方(心率在名字下方)
- 显示元素:独立控制心率图标、BPM 后缀的显隐
- 心动模式:远程玩家心率也可独立变色,支持子菜单自定义
- TAB 列表:TAB 键打开玩家列表后,在名字旁显示心率
GUI 设置
- 心率显示位置:点击进入拖动模式,可切换模块化模式独立调整各模块位置
- 字体大小:各模块独立调节大小(心率文字/设备名称/GUI 面板/心率图标)
- RGB 颜色:四通道滑块 + 实时预览
- HUD 背景板:开关 + 透明度滑块,为游戏内心率显示添加圆角半透明背景
- 心动模式:主开关 + 自定义子菜单(独立控制心率图标/心率数值/BPM 后缀是否变色)
- 显示图标/设备名/BPM后缀:独立开关
心跳模式颜色对照
| 心率范围 | 颜色 | 含义 |
|---|---|---|
| < 60 BPM | 蓝色 | 平静 |
| 60-100 BPM | 绿色 | 正常 |
| 100-140 BPM | 黄色 | 偏高 |
| > 140 BPM | 红色 | 过高 |
HTTP API
启用后可通过以下端点获取心率数据,适用于 OBS 浏览器源接入:| 端点 | 说明 |
|---|---|
http://127.0.0.1:端口/ | 原始心率数据接口 |
http://127.0.0.1:端口/obs | OBS 专用接口:左侧跳动心脏动画 + 右侧心率数值,跳动频率跟随实时心率 |
http://127.0.0.1:端口/heart | 心率 JSON 数据 |
http://127.0.0.1:端口/status | 设备连接状态 |
http://127.0.0.1:端口/graph | 心率图表 |