ValheimLoading...StructureHealth1.4.0

You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

last month

Downloads

248

Size

14KB

Dependency string

lubert_team-StructureHealth-1.4.0

Download

Details Required (1)Versions

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.

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

License

MIT.

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.

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.

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