Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
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.
| Last updated | 5 days ago |
| Total downloads | 81 |
| Total rating | 1 |
| Categories | Mods Client-side Utility Building |
| Dependency string | lubert_team-StructureHealth-1.5.1 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2333README
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 / YandStability: A / Bnext 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 / Thunderstore 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.
