mc_mod-hp-output
by yomo407325
HP Output sends a player's health, damage, healing and death events from the Minecraft client to other programs over local UDP packets in JSON format.
What it does
Once the client runs HP Output, each health change becomes a JSON packet sent to 127.0.0.1. Packets report current health, maximum health and health percentage, along with damage amounts and sources, healing amounts, and death events where a source is available. The port used for output can be changed in the in-game configuration.
External integrations that track a player's health state in real time, including hardware controllers, on-screen overlays, automation scripts, stream tools and custom dashboards, are the intended audience for this mod. Because the data leaves through UDP, the game itself is not modified beyond the client mod. HP Output is a client-side only mod, so servers do not need it and players join without installing it.
Installation requires Mod Menu on the client. Builds exist for Fabric and Forge across 53 release versions, 1.12 – 26.2, and the code is open source under the MIT License. Files for 26.2 on Fabric and 1.20.6 on Forge were published on 2026-08-07.
Key features
Real-time health output
Packets carry current health, maximum health and the health percentage, refreshed as the value changes.
Damage events
Each damage event reports the amount lost and the source that caused it.
Healing events
Health recovery is reported with the amount healed, so external software can follow regeneration.
Death events
A death is detected and reported, with its source included when the game provides one.
UDP JSON packets
Events are sent as structured JSON to 127.0.0.1, a format most external software can read without a custom parser.
Configurable output port
The UDP port is changed in the in-game configuration, which avoids clashes with other local services.
Compatibility
Latest build for each game version and loader.
26.x4 of 4 versions with builds
1.21.x12 of 12 versions with builds
1.20.x7 of 7 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
1.17.x2 of 2 versions with builds
1.16.x6 of 6 versions with builds
1.15.x3 of 3 versions with builds
1.14.x5 of 5 versions with builds
1.13.x1 of 1 version with builds
Only full game releases are shown. This mod publishes no snapshot builds.
5 older game versions (1.12 – 1.13.1) not shown. All files on Modrinth
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Who it’s for: Players who run external tools next to the game, such as stream overlays, hardware controllers or automation software, and developers who want a simple local feed of a player's health state.
Questions
Does HP Output need to be installed on the server?
Which loaders and versions does HP Output support?
Does HP Output require another mod?
Can the UDP port be changed?
In the catalog
mc_mod-hp-output is one of 8,499 Technology mods on ModsFinder, and one of 4,201 Technology mods for Fabric. 13,894 mods support Minecraft 26.2.
Similar mods
What the author says
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…
Official listing
- Modrinth page
- modrinth.com/mod/mc_mod-hp-output
- Owner
- yomo407325
- Published
- 2026-08-07
- Updated on Modrinth
- 2026-08-07
- Facts verified
- 2026-10-15