Valheim Floor Plan

Build complete multi-level structures in Valheim from pre-designed floor plans.

Anyone who has spent time building in Valheim knows the real effort starts before the first wall goes up — clearing uneven ground, wrestling with terrain spikes, and nudging pieces into alignment one agonising centimetre at a time. Valheim Floor Plan takes all of that away. Design your layout in the included browser-based Designer, save it as a .vfp plan file, and the mod handles the rest: it levels and blends the terrain, captures a snapshot for instant undo, and places the entire foundation in seconds.

The Designer supports up to three in-memory level layouts with quick switching, per-level overlay rendering, and cross-level clash hints so you can plan multi-storey builds before committing a single piece. Orientation-sensitive tools — including Beds, Workbenches, and Staircases — show directional arrows so what you see in the Designer matches exactly what gets built in-game.

Once you're happy with the design, press the build hotkey, position the preview in-world, and confirm. The mod levels the terrain, places every piece in the right order, and handles scaffold framing for upper floors automatically. For multi-level builds, additional red floating rectangles appear in the preview at each upper-floor height so you can see the full vertical footprint before committing. If something is off, undo restores both pieces and terrain in one keypress — or use the keep-terrain undo (Ctrl+F9) to remove pieces while leaving the leveled ground intact.

This package includes two components:

1. ValheimFloorPlan mod — a BepInEx plugin that reads .vfp plan files and builds them in-game.
2. Valheim Floor Plan Designer — a browser-based app (included) for creating and editing .vfp plan files.

Demo video: https://youtu.be/jz39KSSfhJ0

Included in this package:

• The mod DLL (installed automatically under BepInEx/plugins)
• The Designer web app (BepInEx/plugins/ValheimFloorPlan/Designer/)
• Sample .vfp plans to get started immediately

Creating Floor Plans

1. Open the Designer to create or edit a plan. It is a local web page installed by Thunderstore Mod Manager. Copy the path below and paste it into your browser address bar to open it :

   %APPDATA%\Thunderstore Mod Manager\DataFolder\Valheim\profiles\Default\BepInEx\plugins\RetiredCoders-ValheimFloorPlan\ValheimFloorPlan\Designer\index.html
   
   e.g.    C:\Users\{Username}\AppData\Roaming\Thunderstore Mod Manager\DataFolder\Valheim\profiles\Default\BepInEx\plugins\RetiredCoders-ValheimFloorPlan\ValheimFloorPlan\Designer\index.html
   

2. Save/export a .vfp file.

3. Point the mod config FloorPlanFile to that .vfp file.

4. In game, press the build hotkey (default F8) and place the design. A terrain snapshot is taken automatically before placement.

   While the preview is active, use these keys to adjust placement:

   Key	Action
   ↑ ↓ ← →	Move the plan forward / backward / left / right
   Q	Rotate left (default coarse step: 90°)
   G	Rotate right (default coarse step: 90°)
   Left Shift (hold)	Fine-adjust mode — smaller move/rotate steps
   E	Confirm and build at current position
   RMB / Escape	Cancel placement

   Note: All keys are configurable in the BepInEx config file.

   Rotation note: confirmed builds snap to BuildRotationSnapDegrees (default 90°) so the finished structure stays aligned to angles that still work with Valheim's normal manual piece snapping. Fine preview rotation uses 22.5° steps by default.

   The rotation-related config entries live together in the Preview - Rotation section.

   While positioning the plan, watch for these visual markers in the world:

   • White rectangle — the inner leveled pad: the exact area of ground that will be raised and flattened to sit your foundation on.
   • Green rectangle — the outer terrain-change boundary: terrain blending extends to this edge, giving a smooth transition rather than a hard cliff.
   • Red floating rectangle(s) — upper-floor level bands (multi-level builds only). One red band appears per upper floor at its expected scaffold height, so you can see the full vertical footprint before confirming. Only shown when FloorPlanLevels is 2 or 3.
   • Tall yellow flagpole — the exact placement origin point at the centre of the plan. The pole rises 10 m above the terrain surface so it remains visible even when the ground is underwater or underground.
   • Orange diamond markers — terrain edge risk warnings. These appear when the surrounding terrain is uneven enough that the leveled edge may produce visible tears or spikes. Move or rotate the plan until they disappear (or reduce) for the cleanest result. Markers turn red when risk is high.

   Note: A HUD message also reports the current risk level (LOW / MEDIUM / HIGH) along with step (the steepest cross-edge height jump) and relief (total height range around the footprint) to help you judge whether to nudge the plan before building.

5. To undo, press the undo hotkey (default F9). A 5-second confirmation window opens showing:

   • Red rings around every VFP piece within the search radius so you can see exactly what will be removed.
   • Orange boundary circle on the ground marking the edge of the search radius.

   Optional mode: press Ctrl+F9 (configurable via UndoKeepTerrainHotkey) to start piece-only undo that keeps the leveled terrain. In this mode the terrain snapshot is discarded instead of restored.

   During the confirmation window you can:

   Key	Action
   ↑ ↓ ← →	Move the search circle centre to target different pieces. Movement respects camera angle. Hold Left Shift for fine movement.
   + / - (or numpad)	Increase / decrease the search radius by 5 m. The new radius is saved to config.
   F9 (undo hotkey again)	Confirm normal undo — removes all marked pieces and restores terrain.
   Ctrl+F9 (UndoKeepTerrainHotkey)	Start or confirm keep-terrain undo — removes marked pieces and discards the current terrain snapshot. If started with Ctrl+F9, confirmation can be done with either Ctrl+F9 or F9.
   RMB / Escape	Cancel — clears all highlights without removing anything.

   The HUD message shows the current radius and remaining time throughout the window. All adjustments (movement or radius) restart the 5-second confirmation timer.

IMPORTANT: Terrain can only be restored within the current session — if you leave the area or reload, the terrain snapshot is lost. Building pieces can be undone across sessions because they are tagged as built by Valheim Floor Plan.

Tip — keep the leveled terrain: if you want to remove your build but keep the flat ground (e.g. to iterate on a design), use Ctrl+F9 (UndoKeepTerrainHotkey) instead of F9. Pieces are removed as normal, but the terrain snapshot is discarded rather than restored.

Preset Bundle Workflow (In Game)

Preset bundles let you share/reload a complete setup: Level 1/2/3 .vfp files plus non-key build/config values.

• Bundle format: .vpfset (zip container)
• Bundle output folder: BepInEx/plugins/RetiredCoders-ValheimFloorPlan/ValheimFloorPlan/PresetBundles/ by default. If FloorPlanDirectory is set, bundles are exported to and imported from that folder instead.
• Key mappings are intentionally not included in exported/imported bundle settings.

Note: when a bundle is imported, the extracted .vfp files are written into a subfolder named after the bundle inside the bundle output folder, and FloorPlanFile/FloorPlanFileLevel2/FloorPlanFileLevel3 are updated to those full extracted paths. If you are using FloorPlanDirectory, you may want to move the extracted files into your directory and update the file fields to bare filenames afterwards.

Default controls:

While import selection is active, the HUD shows:

• Selected bundle name
• Current position as bundle X of N
• Control hints (Right, Left, Enter, Escape)
• Remaining time

If the timer expires, import selection is canceled automatically.

After a successful import, BundleName is automatically normalized to the imported preset prefix (timestamp suffix removed).

How Multi-Level Builds Work (Plain Language)

When FloorPlanLevels is set to 2 or 3, the mod builds one level at a time.

For each upper level, it follows this order:

1. Place route-critical pieces first (staircases and hearths).
2. Cut/preserve needed vertical paths (stair shafts and chimney shafts).
3. Place the rest of that level's pieces around those paths.

This helps avoid the "nothing gets built" situation where pieces can block each other if placed in the wrong order.

What gets blocked

• Higher-level pieces are blocked from occupying protected stair/chimney shaft space.
• Clash checks are primarily local to the current level, but shaft routes are kept clear across levels.
• Upper-level duplicate floor tiles from plan files are skipped where scaffold decks already provide flooring.

If something is skipped

• You get HUD/log warning categories that explain why.
• If a level has clashes, the build creates a clash signpost for that level with detail signs (plus log details for overflow).

Config Options

Config file path:

• BepInEx/config/com.alexdroz.valheimfloorplan.cfg

All values below are configurable in that file.

General

Building

Scaffolding

Preview

Preview Keys

Preview - Rotation

Terrain

Sample Plans

The samples/ folder contains ready-to-use .vfp examples:

• samples/myfloorplan4x4.vfp
• samples/myfloorplan8x8.vfp
• samples/myfloorplan12x12.vfp
• samples/myfloorplan16x16.vfp
• samples/myfloorplan16x20.vfp
• samples/myfloorplan20x20.vfp
• samples/myfloorplan20x20_double.vfp
• samples/myfloorplan24x24.vfp
• samples/myfloorplan28x28.vfp
• samples/StarBase20x20.vfp
• samples/ThreeFloorBuild_Level_1_16x20.vfp
• samples/ThreeFloorBuild_Level_2_16x20.vfp
• samples/ThreeFloorBuild_Level_3_16x20.vfp
• samples/Workbenches_16x20.vfp
• samples/Workbenches_and_Staircase_16x20.vfp
• samples/Workbenches_and_Staircase_ALT_16x20.vfp

Tips

• Test away from world spawn. Terrain levelling and piece placement both depend on world-space coordinates. Builds near the origin (0, 0) can mask position-dependent bugs — always test in a realistic location.
• Building on already-levelled terrain is much quicker. Create a simple floor plan covering the area you want to build on. Run it once to level the ground, then portal away and back (this clears the terrain snapshot). Press F9 to remove the temporary build — the levelled terrain stays. Subsequent builds in the same area skip most of the levelling work and place pieces much faster.
• Watch the edge risk markers before confirming. Orange/red diamond markers appear when surrounding terrain is steep enough to cause tears or spikes. Nudging or rotating the plan a few metres is often enough to clear them.
• Rotate to align with the terrain slope. If one side of the pad is significantly higher, try rotating so the plan runs along the contour rather than across it — this reduces the height range the leveller has to span.
• Use the overlay in the Designer before building. Enable L2/L3 overlays to check for piece clashes across levels before saving any of the .vfp files. Red dashed outlines flag conflicts, with directional rules for Staircases and Hearths.
• Bed orientation matters. The arrow shown on a Bed in the Designer points toward the head. The in-game placement will match — players sleep with their head toward the arrow.
• Undo is session-only for terrain. The terrain snapshot is held in memory. Move to a different area or reload the world and it is gone. Piece removal still works across sessions because pieces are tagged.
• Use Ctrl+F9 to keep your leveled ground. If you want to remove the build and try again without re-leveling, press Ctrl+F9 instead of F9 to start undo. Pieces are removed but the leveled terrain stays. This is especially useful when iterating on a design in the same spot.
• The preview shows all floor levels. When FloorPlanLevels is 2 or 3, floating red bands appear during preview at the height of each upper floor. Use them to check clearance and surroundings before confirming.
• Adjust the undo radius before confirming. During the undo confirmation window, +/- resizes the search circle and arrow keys reposition it. This is useful when two builds are close together and you only want to remove one.
• Multi-level plans must nest. Level 2 and Level 3 footprints must fit within the Level 1 footprint. If a level file is rejected at build time, check that all its pieces fall inside the Level 1 grid boundary.
• Scaffolding settings are forced on for multi-level builds. When FloorPlanLevels > 1, RoofScaffolding, ScaffoldingFloors, TransverseScaffoldingBeams, and LongitudinalScaffoldingBeams are all automatically enabled. You do not need to set them manually.

Feature Highlights

Spiral Staircase Showcase

Example Layouts

Three Level Floor Plan

Starbase

Package contents include:

• BepInEx/plugins/ValheimFloorPlan/ValheimFloorPlan.dll
• BepInEx/plugins/ValheimFloorPlan/Designer/...
• images/... (included in the package archive)
• samples/... (example .vfp plans)

Notes

• .vfp is the contract between the Designer and the mod.
• Keep the format stable when changing either project.
• If you evolve the format, update both parser and exporter together.

Acknowledgements

Development of the Valheim Floor Plan mod and the Valheim Floor Plan Designer web app used:

• Visual Studio Code
• GitHub Copilot
• Various auto-selected AI models during implementation and refinement