Valheim Floor Plan

Build structures in Valheim from pre-designed floor plans.

Anyone who has spent time building in Valheim knows the real work starts before the first wall goes up — clearing uneven ground, wrestling with terrain, nudging pieces into alignment one agonising centimetre at a time. Valheim Floor Plan takes that grind away. Design your layout once in the included browser-based Designer, save it as a .vfp plan file, and the mod handles the rest: it levels the terrain, snaps a snapshot for easy undo, and constructs your entire foundation in seconds. No more tedious ground prep or painstaking piece-by-piece placement — just load your plan, pick your spot, and build.

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.

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 (replace v1.0.3 if a newer version is installed):

   %APPDATA%\Thunderstore Mod Manager\DataFolder\Valheim\cache\RetiredCoders-ValheimFloorPlan\v1.0.3\BepInEx\plugins\ValheimFloorPlan\Designer\index.html
   
   e.g. C:\Users\{Username}\AppData\Roaming\Thunderstore Mod Manager\DataFolder\Valheim\cache\RetiredCoders-ValheimFloorPlan\v1.0.3\BepInEx\plugins\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 (45°)
   R	Rotate right (45°)
   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.

   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.
   • 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.

   During the confirmation window you can:

   Key	Action
   + / - (or numpad)	Increase / decrease the search radius by 5 m. The new radius is saved to config.
   F9 (undo hotkey again)	Confirm — removes all marked pieces and restores terrain.
   RMB / Escape	Cancel — clears all highlights without removing anything.

   The HUD message shows the current radius and remaining time throughout the window.

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.

Config Options

Config file path:

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

All values below are configurable in that file.

General

Terrain

Building

Preview Movement/Rotation

Preview Keys

Sample Plans

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

• samples/myfloorplan4x4.vfp
• samples/myfloorplan8x8.vfp
• samples/myfloorplan12x12.vfp
• samples/myfloorplan16x16.vfp
• samples/myfloorplan20x20.vfp
• samples/myfloorplan24x24.vfp
• samples/myfloorplan28x28.vfp

Examples

Screenshots

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

Changelog

1.0.5

• Undo confirmation circle is now movable: During the undo confirmation window, press arrow keys (configurable preview move keys) to move the search circle centre and reselect which pieces to target for removal.
• Arrow key movement in undo confirmation respects camera angle (like preview mode) and supports fine-adjust modifier (default LeftShift) for precise positioning.
• All undo adjustments (radius or circle centre movement) now restart the 5-second confirmation timer, giving the player a full window after each change.
• Updated undo confirmation HUD message to indicate "Arrow keys to move circle center" as a control hint.
• Documentation: correction to Desiger path
• New user guide and example images

1.0.4

• Replaced the flat X origin marker with a tall vertical flagpole (10 m, bright yellow) so the build origin is visible above terrain, water, and underground surfaces during preview.
• Undo confirmation now shows per-piece red highlight rings around every VFP piece within the undo radius so the player can see exactly what will be removed.
• Undo confirmation now shows an orange boundary circle on the terrain at the full undo search radius edge.
• Reduced the default undo search radius from 75 m to 15 m.
• Added UndoRadius config option (range 5–150 m, default 15 m) to control the undo search radius.
• During the undo confirmation window, pressing +/- (or numpad equivalents) adjusts the radius by 5 m; the new value is saved to config and highlights/boundary circle refresh immediately.
• Pressing RMB or Escape during the undo confirmation window cancels the undo and clears all highlights.
• Undo confirmation HUD message now shows the current radius, +/- adjustment hint, and RMB/Esc cancel reminder.
• Added ValheimFloorPlanPlugin.Instance static property and SetUndoRadius() helper to support live config write-back from FloorPlanBuilder.

1.0.3

• Bumped mod, manifest, and Designer app version numbers from 1.0.2 to 1.0.3.
• Updated Thunderstore dependency to denikson-BepInExPack_Valheim-5.4.2333.
• Added a comprehensive README Config Options section documenting all BepInEx settings, defaults, ranges, and preview keybinds.
• Updated README callout formatting by replacing blockquote notes (>) with plain bold "Note/IMPORTANT" lines for better Thunderstore dark-theme readability.
• Rebuilt and repackaged Thunderstore release (ValheimFloorPlan-1.0.3.zip) including mod DLL + Designer app.

1.0.2

• Expanded the README package description/introduction for clearer context and feature overview.
• Added additional README notes for in-game build placement controls (preview movement/rotation/confirm/cancel keys).
• Updated README with a new Examples section using three new screenshots from images/.
• Fixed Designer Shell layout generation so doorways are placed first and walls no longer overlap doorway footprints.
• Improved Shell edge placement behavior on odd-sized grids by skipping wall segments that intersect doorway area.
• Rebuilt and repackaged Thunderstore release (ValheimFloorPlan-1.0.2.zip) including mod DLL + Designer app.

1.0.1

• Documentation change only; fixed broken README image links.

1.0.0

• First stable release.
• Added configurable terrain target offset: TerrainHighPointDelta (Highest + Delta, 0.0 to 4.0).
• Preview walls and risk markers now reflect adjusted target height.
• Undo confirmation feedback now appears immediately on first key press.
• Finalized stable plugin GUID: com.alexdroz.valheimfloorplan.
• Added and documented partner Designer app workflow.
• Included Designer app in Thunderstore package contents.
• Development used Visual Studio Code, GitHub Copilot, and various auto-selected AI models.