HP Output

English

HP Output is a lightweight client-side Minecraft mod that sends player health-related events to external applications through local UDP messages.

It is designed for integrations such as hardware controllers, overlays, automation tools, stream utilities, custom dashboards, and other applications that need real-time access to the player's health state.

Features

• Real-time health output — Reports current health, maximum health, and health percentage.
• Damage events — Detects player damage and reports the damage amount and source.
• Healing events — Reports health recovery and the amount healed.
• Death events — Detects player death and reports the death source when available.
• UDP JSON output — Sends structured JSON packets to 127.0.0.1.
• Configurable port — Change the UDP output port through the in-game configuration.
• Client-side only — No server-side installation is required.
• Fabric and Forge support — Available for a wide range of Minecraft versions.
• Lightweight — Focused only on health/event monitoring and external data output.

Supported Versions

Fabric Loader is only available for Minecraft 1.14 and newer. Minecraft 1.12–1.13 users should use the Forge version.

Data Output

By default, HP Output sends JSON-formatted UDP packets to:

127.0.0.1:39571

Example health packet:

{
  "alive": true,
  "health": 18.0,
  "maxHealth": 20.0,
  "percentage": 0.9
}

Example damage event:

{
  "alive": true,
  "health": 17.0,
  "maxHealth": 20.0,
  "percentage": 0.85,
  "damage": 3.0,
  "source": "mob:Zombie"
}

This makes HP Output suitable for connecting Minecraft with external software without modifying the game server.

中文

HP Output 是一个轻量级的 Minecraft 客户端 Mod，可将玩家的血量以及受伤、治疗和死亡等事件通过本地 UDP 实时发送给外部程序。

它适用于硬件控制器、直播工具、状态面板、自动化程序、Overlay 以及其他需要获取 Minecraft 玩家实时生命状态的应用。

主要功能

• 实时血量输出 — 输出当前血量、最大血量以及血量百分比。
• 受伤事件 — 检测玩家受到的伤害，并输出伤害值和伤害来源。
• 治疗事件 — 检测玩家生命恢复并输出治疗量。
• 死亡事件 — 检测玩家死亡，并在可用时输出死亡来源。
• UDP JSON 输出 — 使用结构化 JSON 数据包向 127.0.0.1 发送数据。
• 端口可配置 — 可通过游戏内配置修改 UDP 输出端口。
• 纯客户端 Mod — 无需在 Minecraft 服务器上安装。
• 支持 Fabric 与 Forge — 覆盖多个 Minecraft 版本。
• 轻量设计 — 专注于生命状态监听和外部数据输出，不加入额外游戏内容。

支持版本

Fabric Loader 仅支持 Minecraft 1.14 及以上版本，因此 Minecraft 1.12–1.13 请使用 Forge 版本。

数据输出

默认情况下，HP Output 会将 JSON 格式的 UDP 数据包发送至：

127.0.0.1:39571

血量状态示例：

{
  "alive": true,
  "health": 18.0,
  "maxHealth": 20.0,
  "percentage": 0.9
}

受伤事件示例：

{
  "alive": true,
  "health": 17.0,
  "maxHealth": 20.0,
  "percentage": 0.85,
  "damage": 3.0,
  "source": "mob:Zombie"
}

HP Output 可以让外部程序方便地获取 Minecraft 玩家生命状态，而无需修改或安装任何服务端组件。