StructureHealth
Adds numeric health and predicted stability to the hammer's hover label. Works for the hovered piece in Repair mode and for the placement ghost in Build mode.
About this mod Author’s original text
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.
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.
Install these first, or the mod will not work: