StabilityView
Debug overlay for structure stability: support values on every piece, where support comes from, and how building or removing changes it.
About this mod Author’s original text
StabilityView
ai usage disclaimer
with the exception of this readme, everything in this repo is ai-generated.
description
this mod adds a detailed stability overlay to help plan structures or better understand how valheim's stability works.
usage
with a building tool (hammer, hoe, cultivator) out, press F7 to enable the overlay.
label colors
label colors follow the spirit of valheim's stability colors, but spread the gradient over the entire range (valheim shows bright green once a piece is > 50% stable, but this mod shows slightly more detail).
snapshots
immediately before placing or removing a piece, the mod takes a snapshot of every piece's stability. afterwards, labels are displayed under the stability value of each affected piece that indicate how the addition or removal changed that piece's stability. positive = stability improved, negative = stability got worse.
if you want to compare stability values across multiple changes, press F8 to take a manual stability snapshot. once you've done that, all snapshot labels will be anchored on your snapshot rather than the most recent change. you can press shift+F8 to clear the manual snapshot.
support lines
lines run from the piece back to its support(s) so that you can see how pieces are contributing to the overall structure health.
settings
settings are configurable via editing the settings file directly (BepInEx/config/s992.StabilityView.cfg) or via a configuration manager.
these are the default settings:
[Changes]
Take a snapshot automatically just before you place or remove a piece, so each change shows its effect.
Setting type: Boolean
Default value: true
AutoSnapshot = true
Tint pieces whose support changed since the snapshot (green = up, red = down).
Setting type: Boolean
Default value: true
HighlightChanges = true
Ignore changes smaller than this.
Setting type: Single
Default value: 0.5
Acceptable value range: From 0 to 100
ChangeThreshold = 0.5
Stop showing changes this many seconds after the snapshot. 0 = until the next snapshot.
Setting type: Single
Default value: 0
Acceptable value range: From 0 to 600
ChangeDuration = 0
[Display]
Only show the overlay while a building tool (hammer, hoe,...) is equipped.
Setting type: Boolean
Default value: true
OnlyInBuildMode = true
Show on-screen pieces within this many metres of the camera.
Setting type: Single
Default value: 30
Acceptable value range: From 2 to 150
Radius = 30
Show at most this many on-screen pieces (closest to the camera first).
Setting type: Int32
Default value: 200
Acceptable value range: From 1 to 1000
MaxPieces = 200
Show a status line with how many pieces are labelled and how many were left out.
Setting type: Boolean
Default value: true
ShowStatus = true
Label font size.
Setting type: Int32
Default value: 13
Acceptable value range: From 8 to 32
FontSize = 13
Prefix labels with the piece's material (Wood, Stone,...).
Setting type: Boolean
Default value: false
ShowMaterial = false
Show support as current/max instead of just current.
Setting type: Boolean
Default value: true
ShowMaxSupport = true
Show the support value below which the piece collapses.
Setting type: Boolean
Default value: false
ShowBreakThreshold = false
Skip labels for pieces at their material's maximum (grounded pieces).
Setting type: Boolean
Default value: false
HideFullySupported = false
[Keys]
Show or hide the stability overlay.
Setting type: KeyboardShortcut
Default value: F7
ToggleOverlay = F7
Show or hide the lines to where each piece gets its support.
Setting type: KeyboardShortcut
Default value: F9
ToggleSourceLines = F9
Record current support values; changes are then shown relative to them, and automatic snapshots pause until it's cleared.
Setting type: KeyboardShortcut
Default value: F8
TakeSnapshot = F8
Forget the snapshot and stop showing changes (resumes automatic snapshots).
Setting type: KeyboardShortcut
Default value: F8 + LeftShift
ClearSnapshot = F8 + LeftShift
[Support sources]
Draw a line from each piece to
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: