Runic Precision Build Tool 2.0.1

Runic Precision Build Tool extends Valheim's hammer preview with exact six-degree-of-freedom control while preserving Valheim's normal placement validation and commit path.

The mod is independently installable. Its only runtime requirement is BepInExPack Valheim 5.4.2333; it has no Runic Core, Persistence, Transactions, Permissions, Inventory, or shared-library dependency.

Precision placement

Equip the Hammer, enter its build mode, select a build piece, and press P to enter precision mode for the current placement session. P is ignored everywhere else, including ordinary gameplay and other tools' placement modes. Press P again or leave Hammer placement to restore ordinary controls. When precision mode is off, the mod does not change the placement transform.

Normal rotation is 22.5 degrees and fine rotation is 1 degree by default. Every yaw, pitch, and roll increment uses the pending piece's current local Y, X, or Z axis. Thus Alt + Wheel pitches a yawed beam around the beam's own X axis. Normal movement is 0.25 m and fine movement is 0.05 m. Movement.ReferenceFrame=World keeps new movement steps on world axes; Local rotates each new movement step by the pending piece orientation. Earlier movement never orbits when the piece rotates later.

An untouched preview follows Valheim's candidate and surface orientation. An explicit Runic rotation or rotation match holds the resulting world rotation. Valheim's ordinary yaw input still composes from that held orientation.

Match, repeat, search, and readout

Matching copies coordinates and rotation only. It never copies prefab, creator, ownership, scale, health, access, or structural state. Exact position may skip automatic snapping, but every later native collision, ward, location, resource, station, support, and placement check still runs.

While the piece menu is open, F6 selects the next unlocked search result, F7 toggles a favorite, F8 selects the next unlocked favorite, and F9 selects the next unlocked recent piece. When Build Catalog.SearchQuery is empty, F6 cycles all currently unlocked pieces instead of showing an error. Catalog work is bounded to 256 available entries, 1,024 inspections, 64 favorites, 16 recents, and a 64-character query. It cannot unlock a piece.

The selected-piece panel adds Runic world position, movement delta/reference frame, pitch/roll/yaw, increment, target distance, snap host, and short match feedback. Its own rows hide while the piece menu is open; Valheim retains its normal panel and lifecycle.

Native-owner undo and area repair

F11 and F12 are available only while precision mode is active and the piece menu is closed.

F11 keeps one in-memory record of the most recent eligible placement in the current hammer session. It removes the piece once only when the local player is still its creator, its loaded ZNetView is currently locally owned, its position and rotation are unchanged, it is full-health and inert, no loaded structure depends on it, and fresh ward, range, no-build, and native removal checks pass. The record is cleared before native removal begins, preventing a second key press from duplicating drops after a partial callback failure.

F12 uses a fixed 256-collider discovery buffer and aborts without changes if that buffer saturates. It retains at most 64 deterministic candidates and repairs at most the configured count (16 by default). Every candidate is reread immediately before repair and must be created by the local player, in native range, permitted by the current ward/no-build checks, eligible under the native hammer policy, and currently owned by the local peer. Hammer durability is charged once per successful WearNTear.Repair() call and the inventory change notification is sent once at the end.

These paths work in solo, a listen host, or on a dedicated-server client whenever Valheim has given the local peer current ownership of the exact loaded piece. If another peer or the server currently owns it, that candidate is skipped. The mod never calls SetOwner or ClaimOwnership and sends no undo or repair RPC. There are no gameplay journals, durable roots, recovery loops, inventory locks, grave custody, or quarantine states; failure releases only the current key action.

Multiplayer and compatibility

Placement transforms remain client-side preview state and use Valheim's normal networked placement commit. The plugin does not add a protocol handshake or require other gameplay mods to load.

Harmony ordering remains explicit where preview responsibilities overlap: Precision reads after Runic Build Camera, begins placement capture before Runic Crafting, and finalizes its ghost before Runic Agriculture observes it. Those mods are optional. If PerfectPlacement free rotation is enabled, or the installed Valheim 0.221.12 method/IL contract does not match the audited seams, Precision disables its hooks and leaves vanilla building available.

Performance and installation

Ordinary input and pose composition are allocation-free in the focused tests. Catalog, target, repair, and structural scans are bounded and occur only at their documented sampling rate or on an explicit action. Relative history stores two transforms and undo stores one session-only record. Favorites and recents are bounded configuration strings; safe utilities create no persistent data.

Install BepInExPack Valheim 5.4.2333, then place RunicPrecisionBuildTool.dll under BepInEx/plugins/RunicPrecisionBuildTool/. Configuration is generated at BepInEx/config/chazman.RunicPrecisionBuildTool.cfg. Version 2.0.1 supports keyboard and mouse; it does not promise controller bindings.

Community: https://discord.gg/7HKHTCdFqY

Runic Precision Build Tool is an independent mod and is not affiliated with Iron Gate Studio.

Changelog

2.0.1 - 2026-08-29

• Made the plugin independently installable with BepInEx as its only runtime dependency.
• Removed Core registry/capability registration, Persistence networking, Transactions composites, remote mutation protocols, world journals, recovery, reconciliation, custody, and quarantine.
• Moved F11 undo and F12 area repair to Valheim's native loaded local-owner path for solo, listen host, and dedicated-client play without ownership claiming or mutation RPCs.
• Kept conservative fresh creator, ward, range, no-build, pose, health, structural, tool, and native policy checks; undo clears its one in-memory receipt before native removal starts.
• Kept fixed-capacity deterministic repair discovery and one hammer durability charge per successful repair, with no inventory-wide lock or gameplay journal.
• Changed precision yaw, pitch, and roll increments to the pending piece's current local axes, so pitch follows a yawed beam's own X axis and the visual guides rotate with the piece. The resulting quaternion remains locked against later candidate-surface drift.
• Restricted P to the exact equipped Hammer build mode, so ordinary gameplay and cultivator or other tool placement modes cannot activate Precision.
• Made F6 cycle every currently unlocked build piece when the catalog search query is empty instead of displaying the missing-query error.
• Kept the explicit P precision mode, same-frame rotation input, six-axis movement/reset controls, transform and snap-side matching, two-placement repeat history, bounded search/favorites/recents, readout, and axis guides.
• Kept optional Harmony ordering with Build Camera, Crafting, and Agriculture plus PerfectPlacement conflict detection and exact Valheim 0.221.12 seam verification.
• Replaced obsolete durable/dedicated protocol tests with focused native-ownership and standalone architecture assertions.

2.0.0

• Rebuilt the tool as a compact six-degree-of-freedom extension of Valheim's ordinary hammer placement workflow.
• Added configurable quaternion rotation, local/world translation, matching, native snap composition, readout, and fail-closed adapter verification.