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 / 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.

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
├── Inspection.cs       # WearNTearInfo, GhostSupport, HoverFormatter
├── Patches.cs          # Harmony patches (Highlight, UpdateCrosshair, UpdateSupport)
└── OverlayRenderer.cs  # optional IMGUI panel

License

MIT.

Changelog

All notable changes to this mod are documented here. Format loosely follows Keep a Changelog; versions follow Semantic Versioning.

[1.5.1] — 2026-05-13

Changed

• Trimmed the README to keep only the install + configuration reference.

[1.5.0] — 2026-05-13

Added

• Localised hover and overlay labels for Ukrainian, German, French, and Spanish. The labels follow Valheim's selected language automatically; switching language in-game updates them without a restart.
• New languages can be added by extending the table in src/Strings.cs.

Changed

• The mod version is now sourced from manifest.json at build time and stamped into the DLL's AssemblyVersion / FileVersion / InformationalVersion.
• A build-time check fails the build if PluginVersion in src/Plugin.cs falls out of sync with manifest.json, so the BepInEx-reported version and the Thunderstore version can't drift apart.

[1.4.0] — 2026-05-13

Initial release.

Features

• Repair mode — when the Repair tool is selected, the cursor hover label (next to "Лагодження") gets two extra lines: Health: X / Y and Stability: A / B for the piece under the crosshair.
• Build mode — when a build piece is selected, the same label shows the ghost's Placing: <name>, Max Health, and predicted Stability for the current placement spot, computed by running Valheim's native WearNTear.UpdateSupport algorithm against the placement ghost.
• Native HUD integration — writes into Valheim's own TMP hover label; same font, no extra panels.
• Rich-text colouring — values tint green / yellow / red as health and stability drop.
• Optional IMGUI overlay — togglable top-left panel (default hotkey F8).
• Independent toggles — repair info and build info can each be disabled via config.
• ConfigurationManager-friendly — font sizes are sliders with sensible ranges.