Building Inspector 0.3.0

A minimal BepInEx plugin for Valheim that adds six free inspection flags to Hammer → Inspection:

• 🔴 Problem — marks an issue
• 🟡 Review — marks something that needs review
• 🟢 Verified — marks an inspected area
• 🔵 Other — marks another category
• 🟣 Structural — marks structural work that needs attention
• ⚪ Finish — marks finishing work that needs attention

You can customize each flag's label, description, and color in the mod configuration. Flags align to the surface you are aiming at, with the pole base anchored at the surface. Use the mouse wheel to rotate around the surface normal.

Flag tilt

While a flag placement ghost is active:

• I / K — tilt forward or backward
• J / L — tilt sideways
• Insert — reset the tilt

Each key press applies the configured tilt step, up to the configured maximum angle.

Flag notes

Aim at a placed flag and press N to add or edit its note. Notes are saved with the flag and appear when you look at it. Only the player who placed the flag can edit its note.

Placement and support

Flags follow Valheim's building support system and collapse when unsupported. The six standard flags block one another within the configured spacing(0.2m by default). The optional test flag does not affect their placement spacing.

Configuration

Key bindings and tilt angles are in BepInEx/config/Lanoz.BuildingInspector.cfg, under [Flag Rotation]. Flag labels, descriptions, and colors are under [Flag Labels], in slots 1–6. Colors use hex notation, such as #FF0000. Restart the game after changing labels.

To test label settings separately, enable [Test Flag] and edit its name, description, and color. Restart the game to apply the changes. Remove any placed test flags before disabling the test flag.

The mod does not automatically scan or analyze buildings.

Icon

The mod icon was generated using AI.

Changelog

All notable changes to Building Inspector are documented here.

[0.3.1]

Added

• Added Valheim-style hover highlighting to category buttons in the Inspection Flag Editor, including the selected category. The gold selection marker remains visible, and hovering does not change the selection.
• Added optional diagnostic logging for editor and multiplayer editing events through [Debug] Enabled, disabled by default. Logs do not include note contents or player names.
• Added AdvancedUI configuration options under the [Flag Editor] section, allowing players to customize the Inspection Flag Editor UI.

Changed

• Moved all optional test-flag settings from [Test Flag] to [Debug]: TestFlagEnabled, TestFlagName, TestFlagDescription, and TestFlagColor. The test flag remains disabled by default and independent of diagnostic logging.
• Kept [Debug] as the final configuration section after saving.
• Reorganized the plugin into focused modules while preserving existing placement, editor, note-limit, and support behavior.

Fixed

• Fixed legitimate creators being unable to save multiplayer notes or category changes when another client owns the flag's network object.
• Tightened editing permissions to the placing character; network ownership or another character on the same account does not grant editing rights.
• Improved handling of delayed character/flag synchronization after reconnecting and changes of network ownership, using limited retries.

Compatibility

• Existing test-flag names, descriptions, and colors are automatically carried over unless the new settings already exist. The old enable switch is removed; use TestFlagEnabled to enable the test flag again.
• Existing flag IDs, legacy compatibility, and saved notes, categories, and creator data are unchanged.
• Multiplayer note and category editing now requires the updated mod's authorization handlers on the host or dedicated server, as well as the clients using the flags.

[0.2.7 - 0.3.0]

Added

• Added the new UI - Inspection Flag Editor, allowing players to edit placed inspection flags.
• Added editable notes to inspection flags with new UI.
• Added in Inspection Flag Editor six flag categories(by default):
  • Problem
  • Review
  • Verified
  • Other
  • Structural
  • Finish
• Added category selection directly from the Flag Editor.
• Added multiplayer synchronization for flag notes and categories.
• Added creator-only editing for placed flags.
• Added a 160-character note limit.
• Added a maximum of 5 visual lines for notes.
• Added automatic text wrapping in the Flag Editor.
• Added LegacyMigration to automatically migrate flag names from older versions.
• Added improved inspection information when hovering over flags.

Changed

• Improved the Flag Editor layout and UI alignment.
• Improved note input and validation.
• Improved cursor and player input handling while the editor is open.
• Improved flag placement and surface alignment.
• Improved flag rotation and tilt controls.
• Improved multiplayer handling for inspection flags.
• Improved customization of inspection flag categories.

Fixed

• Fixed notes losing the last character when reaching the character limit.
• Fixed note line counting when manual line breaks are used.
• Fixed various Flag Editor UI alignment issues.
• Fixed flag note and category synchronization issues.
• Improved compatibility with flag names from older versions through the legacy migration system.

Compatibility

• Existing inspection flags from older versions are migrated automatically to the current flag categories and names.
• Existing worlds and placed inspection flags should remain compatible when updating from previous versions.