ValheimLoading...ValheimFloorPlan1.1.0

You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

3 weeks ago

Downloads

887

Size

27MB

Dependency string

RetiredCoders-ValheimFloorPlan-1.1.0

Download

Details Required (1)Versions

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, and 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, captures a snapshot for easy undo, and builds the whole foundation in seconds. When something is off, you can even move the undo search circle with the arrow keys before confirming. 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:

ValheimFloorPlan mod — a BepInEx plugin that reads .vfp plan files and builds them in-game.
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

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

Save/export a .vfp file.
Point the mod config FloorPlanFile to that .vfp file.

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

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
`↑` `↓` `←` `→`	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 — 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. 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.

Config Options

Config file path:

BepInEx/config/com.alexdroz.valheimfloorplan.cfg

All values below are configurable in that file.

General

Option	Default	Allowed values	What it does
`FloorPlanFile`	(empty)	Any valid file path	Full path to the `.vfp` file exported by the Designer.
`BuildHotkey`	`F8`	Any valid `KeyboardShortcut`	Starts plan preview/build flow.
`UndoHotkey`	`F9`	Any valid `KeyboardShortcut`	Removes placed VFP-tagged pieces and restores terrain snapshot.
`UndoRadius`	`15`	`5` to `150`	Search radius in metres around the undo circle centre when scanning for VFP pieces to remove on Undo. Adjustable live during the confirmation window with `+`/`-`, and circle centre is adjustable with arrow keys.
`ProgressMessagePosition`	`CenterLeft`	Valheim `MessageHud` positions (`Center`, `TopLeft`, `TopRight`, etc.)	HUD slot for build-progress messages. `CenterLeft` is accepted as an alias and maps to `Center`.
`WarningMessagePosition`	`TopLeft`	Valheim `MessageHud` positions (`Center`, `TopLeft`, `TopRight`, etc.)	HUD slot for warnings/risk messages. `CenterLeft` is accepted as an alias and maps to `Center`.

Terrain

Option	Default	Allowed values	What it does
`TerrainLevelPasses`	`2`	`1` to `5`	Main leveling pass count before spike cleanup. Lower is faster; higher can smooth stubborn terrain.
`TerrainSpikeCleanupPasses`	`2`	`1` to `5`	Post-leveling spike cleanup pass count.
`TerrainStampRadius`	`3.0`	`3.0` to `6.0`	Radius of each terrain stamp disc (meters). Also controls outer terrain blend reach.
`TerrainHighPointDelta`	`0.0`	`0.0` to `4.0`	Extra height added to sampled highest point (`targetY = highest + delta`).
`TerrainUseStagedRaise`	`false`	`true` / `false`	Experimental staged vertical raise mode instead of single full-height raise.
`TerrainRaiseStepHeight`	`0.5`	`0.15` to `1.5`	Max vertical raise per stage when staged raise is enabled (meters).
`TerrainMaxRaiseStages`	`1`	`1` to `16`	Hard cap on number of staged raises when staged mode is enabled.
`TerrainSkipSatisfiedCenterStamps`	`true`	`true` / `false`	Skips center stamps where sampled terrain is already at/above target height.

Building

Option	Default	Allowed values	What it does
`ExternalWallHeight`	`1`	`1` to `18`	Stacks outer-perimeter `Wall`/`Pillar` pieces vertically to this many levels.
`WallPillarMaterial`	`Stone`	`Stone`, `Wood`	Chooses material set used for `Wall` and `Pillar` types.

Scaffolding

Option	Default	Allowed values	What it does
`RoofScaffolding`	`false`	`true` / `false`	Adds scaffold poles and perimeter beams around the plan during the build.
`RoofScaffoldingType`	`Gable`	`Gable`, `Flat`	Controls the topmost scaffold deck shape when `ScaffoldingFloors` is enabled. `Gable` builds a pitched roof layout and extends front-mid/back-mid/center support columns up to the apex. `Flat` tiles the topmost level with ridge roof pieces edge-to-edge (one piece per 2x2 tile area).
`RoofScaffoldingGableFlooring`	`RoofWithFloorUnderlay`	`RoofWithFloorUnderlay`, `RoofOnly`	Gable-only top-surface behavior (used only when `RoofScaffoldingType=Gable`). `RoofWithFloorUnderlay` places floor tiles under the top gable roof. `RoofOnly` places only gable roof pieces.
`ScaffoldingLevels`	`1`	`1` to `3`	Number of stacked scaffolding levels when `RoofScaffolding` is enabled. Each extra level repeats the same scaffold pattern +4m above the previous level.
`ScaffoldingFloorHeight`	`4`	`2`, `4`, `6`	Vertical height in metres between scaffold levels. Must be a multiple of 2m so stacked wood-iron support segments line up correctly.
`ScaffoldingFloorHeight#2`	`4`	`2`, `4`, `6`	Vertical height in metres for the second scaffold level. Used when `ScaffoldingLevels` is `2` or `3`.
`ScaffoldingFloorHeight#3`	`4`	`2`, `4`, `6`	Vertical height in metres for the third scaffold level. Used when `ScaffoldingLevels` is `3`.
`ScaffoldingFloors`	`false`	`true` / `false`	Builds wood floor decks across each scaffolding level when `RoofScaffolding` is enabled.
`TransverseScaffoldingBeams`	`false`	`true` / `false`	Adds west-to-east horizontal scaffold beams at each scaffold pole row.
`LongitudinalScaffoldingBeams`	`false`	`true` / `false`	Adds south-to-north horizontal scaffold beams at each scaffold pole column.

Preview

Option	Default	Allowed values	What it does
`BuildOriginForwardOffset`	`0`	`0` to `20`	Extra distance added to the auto-computed player-to-build-center preview offset (meters). Usually not needed.
`MoveStep`	`2.0`	`0.25` to `10.0`	Nudge distance per move key press (meters).
`FineMoveStep`	`0.5`	`0.05` to `5.0`	Nudge distance per move key press while fine-adjust key is held (meters).

Preview Keys

Option	Default	What it does
`MoveForwardKey`	`UpArrow`	Move preview center forward relative to camera.
`MoveBackwardKey`	`DownArrow`	Move preview center backward relative to camera.
`MoveLeftKey`	`LeftArrow`	Move preview center left relative to camera.
`MoveRightKey`	`RightArrow`	Move preview center right relative to camera.
`RotateLeftKey`	`Q`	Rotate preview counter-clockwise.
`RotateRightKey`	`G`	Rotate preview clockwise.
`ConfirmKey`	`E`	Confirm current preview placement and start build.
`CancelKey`	`Escape`	Cancel preview. (Right-click cancels too.)
`FineAdjustKey`	`LeftShift`	Hold for fine movement and fine rotation.

Preview - Rotation

Option	Default	Allowed values	What it does
`RotateStepDegrees`	`90`	`22.5`, `45`, `90`	Rotation applied per coarse rotate key press (degrees).
`FineRotateStepDegrees`	`22.5`	`22.5`, `45`, `90`	Rotation applied per rotate key press while fine-adjust key is held (degrees).
`BuildRotationSnapDegrees`	`90`	`22.5`, `45`, `90`	Snaps the final build rotation to the nearest allowed angle when preview starts and when build is confirmed.