StatusHud

StatusHUD is a lightweight client-side mod for Minecraft (NeoForge) that enhances the in-game HUD with clean and useful real-time indicators. It is designed to give you essential gameplay information at a glance without cluttering your screen or breaking immersion.

Features

• Damage Indicator

Displays the health of the entity you are currently looking at, including a visual bar and icon. Inspired by the classic Damage Indicators mod.

• Durability Indicator

Shows durability of your equipped armor, main-hand tools, and shield, helping you avoid unexpected breaks during combat or exploration.

• Status Indicator

Displays whatever you want, in config file you can specify any custom text and some in-game variables like coordinates, player name, real time spent in game, in-game daylight cycle time and more. Supports ARGB color codes via &AARRGGBB; tabs and line-breaks via \\n perfect for streamers and time management.

Configuration

All features are fully configurable:

• Enable or disable each indicator independently
• Adjust behavior via config file
• Designed to be minimal, flexible, and unobtrusive

General Options

| Option | Type | Default | Description |
|——–|——|———|————-|
| bEnableDamageIndicator | Boolean | true | Enables or disables the damage indicator on the HUD. |
| bEnableDurabilityIndicator | Boolean | true | Enables or disables the display of all durability indicators together. |
| bEnableArmorDurabilityIndicator | Boolean | true | Enables or disables the display of the currently equipped armor’s remaining durability. |
| bEnableShieldDurabilityIndicator | Boolean | true | Enables or disables the display of the currently equipped shield’s remaining durability. |
| bEnableToolDurabilityIndicator | Boolean | true | Enables or disables the display of the currently equipped tool’s remaining durability. |
| bEnableStatusIndicator | Boolean | true | Enables or disables the display of the upper status line on the HUD. |

Damage Indicator

| Option | Type | Default | Description |
|——–|——|———|————-|
| fDamageIndicatorRaycastDistance | Float | 30.0 | Sets the maximum distance (in blocks) at which the damage indicator can detect entities. Vanilla distance is 3. |

Status Indicator Format

| Option | Type | Default | Description |
|———————————–|——|——————————————————————————————————|————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————-|
| sStatusIndicatorFormat | String | $sGameTime24 \| &FF00FF00;$sPlayerName&FFFFFFFF; \| $sPlayTime \| &FFFFFF00;$sTargetsChunkPosition | Custom format for the upper HUD line. Supports new lines (\n), ARGB color codes (&AARRGGBB;) and variables:
• $sGameTime24 → in-game time (24h)
• $sGameTime12 → in-game time (12h)
• $sPlayerName → player’s name
• $sPlayTime → real time played in world
• $sTargetsChunkPosition → position the block you are looking at in chunk coordinates |

Durability Indicator Format

| Option | Type | Default | Description |
|——–|——|———|————-|
| sDurabilityIndicatorFormat | String | $iCurrentDurability/$iMaxDurability ($fCurrentDurabilityPercent%) | Custom format for armor, shield, and tool durability. Supports variables:
• $iCurrentDurability → current durability
• $iMaxDurability → maximum durability
• $fCurrentDurabilityPercent → durability percentage |

Inspiration

This mod is originally inspired by classic mods like Damage Indicators and Armor Status HUD, bringing their core functionality to modern Minecraft versions.

At the same time, StatusHUD is planned to evolve into a unified solution that combines the functionality of many different HUD-related mods into a single cohesive and consistent project.