Building Inspector 0.3.1

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 standard flag's label, description, and color in the mod configuration. Flags align to the surface you are aiming at, including walls and sloped roofs. The pole base stays anchored at the surface while the pole and cloth rotate together. Use the mouse wheel to rotate around the surface normal. Place or dismantle flags with the regular Hammer.

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. The bindings, tilt step, and maximum angle are configurable. Insert resets tilt without resetting mouse-wheel rotation.

Flag Notes and Editor

Aim at a placed flag and press N to open the Inspection Flag Editor. Notes are saved with the flag and appear when you look at it. Only the character who placed the flag can edit its note or category.

Notes allow up to 160 characters, excluding line breaks, and the editor limits input to five visible lines.

Category buttons highlight when hovered, while the selected category remains marked in gold. Click to select a category, then use Save to apply changes or Cancel / Esc to discard them. Your character cannot move or attack while editing.

The editor's advanced UI options can be configured under [Flag Editor] → AdvancedUI in the mod configuration, allowing you to customize the Inspection Flag Editor interface.

In worlds opened through Start Server, flags also show Inspected by with the placing character's name. This remains visible when the world is later played locally.

Placement and Support

Flags follow Valheim's building support system and collapse when unsupported. They do not support other pieces, and players can walk through them without standing on them.

The six standard flags block one another within the configured spacing (0.2 m by default). The optional test flag does not affect their placement spacing.

Configuration

Settings are stored in:

BepInEx/config/Lanoz.BuildingInspector.cfg

• [Flag Rotation] - tilt bindings and angles.
• [Flag Notes] - editor key binding.
• [Flag Placement] - flag spacing.
• [Flag Labels] - standard flag labels, descriptions, and colors in slots 1-6.
• [Flag Editor] - Inspection Flag Editor options, including AdvancedUI.
• [Debug] - optional diagnostic logging and test-flag settings.

Colors use hexadecimal notation, such as #FF0000.

Restart the game after changing labels, colors, or spacing.

The optional test flag is disabled by default and intended for testing label appearance. Under [Debug], TestFlagEnabled turns it on or off, while TestFlagName, TestFlagDescription, and TestFlagColor customize it. Existing test-flag names, descriptions, and colors migrate automatically. Restart the game to apply changes, and remove placed test flags before disabling it.

Multiplayer

Multiplayer note and category editing requires the updated mod's authorization handlers on the host or dedicated server, as well as the clients using the flags. Only the character who placed a flag can edit its note or category.

Important Notes

Building Inspector is a manual inspection and marking tool. It 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.