Buildheim

Plan it. Gather it. Build it.

A client-only blueprint mod for Valheim, inspired by Litematica. Load or capture a building, position a private hologram, and build it with your normal hammer.

Only you need the mod. The server and other players do not need Buildheim. Your blueprint stays local; the pieces you build become ordinary world objects. Building uses materials from your inventory.

Installation

In your r2modman profile:

1. Install BepInExPack Valheim 5.4.2333 or newer and Jötunn 2.30.0 or newer.
2. Copy this project's Buildheim.dll into a folder under BepInEx/plugins. Remove the previous PlanBuild DLL when upgrading. Keep only one Buildheim DLL in the profile.
3. Launch with Start modded, join a world, and press End.

Download a ZIP from Releases or Actions, or build the DLL using the development instructions. Use this project's build: the original PlanBuild package has a different workflow. Restart Valheim after replacing the DLL.

Compatibility: compilation and automated checks pass against Valheim 1.0.7, BepInExPack 5.4.2350, and Jötunn 2.30.0. This is a development build. The new UI, targeting, and reconnect workflow still need in-game validation; multiplayer compatibility is not yet fully verified.

Your first build

1. Press End, open Blueprints, and click Open folder to open your configured blueprint directory. Put .blueprint or .vbuild files there. Extract downloaded ZIPs first. Subfolders work too. Fresh installs use BepInEx/config/Buildheim/blueprints inside your profile.
2. Return to the Blueprints tab and click Refresh. Choose a building to load its hologram and open the Build tab.
3. Close the planner and position the hologram with the shortcuts below. Loading or moving a hologram does not spend materials.
4. Open Materials to see what you need. Gather supplies and carry the materials for the pieces you want to place.
5. Select Click to build, close the planner, and equip your normal hammer. Aim at a missing hologram piece and click. Buildheim selects its recipe, position, and rotation, then Valheim checks and places it.

Completed pieces disappear from the hologram as they are detected in the loaded world.

To make your own blueprint, use New blueprint in the Blueprints tab or open Capture.

Capture a building

1. Enter a blueprint name and choose Select / edit box.
2. Aim at a surface and left-click to set corner A (cyan). Right-click sets opposite corner B (orange). A visible box shows the capture area.
3. Adjust the last corner you clicked with Ctrl + wheel (forward/back), Ctrl + X + wheel (sideways), or Alt + wheel (height). Steps are 0.1 m; hold Shift for 1 m. Middle-click switches which corner you adjust. Click either mouse button again to reposition that corner at your aim point.
4. Enclose the whole building, including its foundation and roof. If both corners are at ground level, raise B with Alt + wheel. The box needs width, height and depth.
5. Press End to review the corners, box dimensions and piece count, then choose Save blueprint. Use Select / edit box again to refine it.

Capture includes loaded, player-built pieces whose placement points lie inside the box. Pieces may extend beyond those points, so leave room around the building. Corner A becomes the blueprint origin. Existing files are never overwritten.

While selecting, mouse clicks pick corners without attacking, placing or removing pieces. Your loaded placement is temporarily hidden and autobuild is turned off. Opening the planner ends selection mode; Clear selection removes the box. Selection corners last for the current world session.

Positioning controls

Use these with a hologram loaded and the planner closed. Movement follows your camera's horizontal facing direction.

| Control | Action | | --- | --- | | End | Open or close the planner | | Ctrl + wheel | Move forward or backward | | Ctrl + X + wheel | Move sideways | | Alt + wheel | Raise or lower the hologram | | Ctrl + Alt + wheel | Rotate the hologram | | Shift with a positioning shortcut | Use larger steps | | Home | Toggle autobuild while the planner is closed | | F7 | Enable or disable the current placement while the planner is closed | | F8 | Show or hide Buildheim's HUD while the planner is closed |

Normal steps are 0.1 m and 22.5°. Hold Shift for 1 m and 90°. Rotation lands on the normal hammer's angle grid, so blueprints whose pieces use standard angles remain compatible with ordinary hammer replacements. Existing saved placements keep their exact angles until you explicitly rotate them. Imported blueprints can still contain nonstandard piece angles.

Building pauses while positioning modifiers are held, and the wheel does not also zoom the camera or rotate the hammer piece. These shortcuts take priority over crouching and sitting while positioning.

The planner slides open and closed with Valheim's inventory timing and uses its opening and closing sounds. Closing releases controls immediately; toggling again during the slide reverses its direction.

Move to my feet in the Build tab relocates the blueprint origin to your character. Positioning shortcuts appear while you hold a positioning modifier, unless you hide the HUD.

Choose how to build