StructureHealth

StructureHealth

A small Valheim mod that adds numeric health and predicted stability to the hammer's hover label — so you stop guessing whether the green cube means "98%" or "31%".

Features

• Repair mode — hover any built piece, see Health: X / Y and Stability: A / B next to the Repair label.
• Build mode — select a piece, see the ghost's max health and predicted stability for the current placement spot before you click.
• Native HUD — writes into Valheim's own hover label. Same font, no extra panels.
• Colour-coded — values tint green / yellow / red as health and stability drop.
• Optional IMGUI overlay — toggle a top-left panel with F8.
• Independent toggles — turn repair or build info off separately.

Install

Requires BepInEx for Valheim.

Via r2modman Mod Manager — subscribe to StructureHealth and launch the game through the manager.

Manual — drop StructureHealth.dll into Valheim/BepInEx/plugins/StructureHealth. Launch the game once to generate the config file.

Configuration

Edit BepInEx/config/com.lubert.valheim.structurehealth.cfg directly, or use ConfigurationManager in-game.

| Setting | Default | What it does |

| --- | --- | --- |

| EnableRepairInfo | true | Show stats of the hovered piece in Repair mode. |

| EnableBuildInfo | true | Show predicted stats for the placement ghost. |

| ShowOverlayPanel | false | Also draw a parallel IMGUI panel in the top-left corner. |

| UseRichText | true | Rich-text colouring in the hover label. |

| HoverFontSize | 18 | Font size for the hover info (0 = inherit Valheim's default). |

| OverlayFontSize | 16 | Font size for the IMGUI overlay. |

| ToggleOverlayKey | F8 | Hotkey to toggle the overlay panel. |

How the prediction works

For real placed pieces, the mod reads WearNTear.GetSupport() directly — the same number Valheim uses internally.

The placement ghost has no valid ZNetView, so UpdateSupport() would NRE and GetSupport() would short-circuit to GetMaxSupport(). A Harmony transpiler null-safes the ZNetView accesses inside UpdateSupport and bypasses an early-exit that fires when the support-scan loop hits a non-WearNTear collider — letting the native algorithm produce the same number you'd see right after placing the piece. A directional physics-scan heuristic stays in as a fallback if anything ever blows up unexpectedly.

Build from source

dotnet build StructureHealth.csproj -c Release

Requires.NET SDK 9, Valheim installed at the default Steam path, and BepInEx already deployed there. The post-build step copies the DLL into BepInEx/plugins/StructureHealth/ automatically.

Project layout:

src/

├── Plugin.cs # plugin entry + config bindings

├── Helpers.cs # TextStyle, PieceNames, cached reflection, SafeNView

├── Strings.cs # localised labels (English, Ukrainian)

├── Inspection.cs # WearNTearInfo, GhostSupport, HoverFormatter

├── Patches.cs # Harmony patches (Highlight, UpdateCrosshair, UpdateSupport)

└── OverlayRenderer.cs # optional IMGUI panel

License

MIT.