SaveStructure

About

Select building pieces with your Hammer, save the structure under a name, and rebuild it from the Hammer menu. Place the whole layout at once, or place a private hologram and build it one piece at a time using normal materials.

Individual and box selection support up to 5,000 pieces by default, with a configurable maximum of 10,000. Saved layouts contain piece types, positions and rotations. Chest contents, sign text, portal destinations, fuel, production queues, item-stand contents, bed claims and damage are not copied. New pieces use their prefab defaults and belong to the player building them.

Layouts and unfinished holograms persist between sessions. Completed pieces behave like ordinary construction, including support, weather, repair and dismantling. Pieces must be within 128 metres of the layout's anchor. Terrain tools, vehicles, loose items, rescaled pieces, multiple-network-object prefabs, and pieces with special water, cultivation or connection rules are excluded. Terrain is not flattened.

Requires BepInEx 5 for Valheim. Jötunn is not required.

How to use

Saving a structure

1. Equip your Hammer and press F8 to enter save mode.
2. Aim at a supported Hammer piece and left-click to select it. A mint outline marks selected pieces. Click a selected piece again to remove it from the selection. Buildable ruin pieces and other players' pieces are eligible; protected wards still restrict access.
3. Select the rest of the pieces you want to save. Start with a foundation or floor piece: the first selected piece defines the placement anchor and facing.
4. Press F7, enter a name, and confirm the dialog. The Hammer entry uses your chosen name. If it already exists, a short suffix is added automatically, for example Cabin [a3f91c].

Normal hammer placement, repair and removal are blocked while save mode is active.

For box selection, hold Left Shift and right-click while in save mode. Click a lower corner of the area, aim at the opposite corner, then click again to confirm. Scroll up / down to increase / decrease the height above the corners. While in box-selection mode, scrolling adjusts height without also zooming the camera or rotating a piece. The box includes pieces whose placement pivots fall inside it. Check the highlighted candidates before confirming; over-limit boxes are rejected without partially selecting them.

Additional boxes add to your selection. Left Shift + right-click again to add or remove individual pieces. If the selection was empty, the lowest piece nearest the first box corner becomes the anchor. If you select a piece individually first, that anchor is retained.

Control	Action
F8	Enter or leave save mode
Left Shift + right-click	In save mode: individual / box selection (SwitchSelectionMode)
Left Shift + right-click	When positioning a saved structure: whole build / hologram (SwitchPlacementMode)
F10	Toggle placement overlap checks while positioning a saved structure or aiming at a placed hologram
Left-click	Select/deselect a piece, or set/confirm box corners in save mode
F7	Name and save the selection
Backspace	Clear the selection and reset the box
Scroll up / down	Increase/decrease box height by 1 metre (configurable step)
E	Build the aimed hologram piece with its full material cost
Delete	Delete the saved blueprint selected for placement, after confirmation
Left Shift + Delete	Remove the aimed hologram plan, after confirmation; completed pieces remain

The selection and placement mode shortcuts are separate config options and can use different bindings. Plain right-click still opens the Hammer build menu outside save mode. All shortcuts above are configurable. Outside their relevant modes they have no effect; typing in chat, naming dialogs, menus and build-menu search blocks mod input. Positioning, rotating and placing a structure continue to use your normal Valheim Hammer controls.

How to build a saved structure

1. Open the Hammer build menu and search for your saved name. Entries use that name directly, without a Structure: prefix.
2. Select the structure to show its full preview. Menu entries use the Building tag and the first piece's icon.
3. Position and rotate it with the normal Hammer controls. Native snap points work; use alternate placement for free positioning.
4. Check the hint says WHOLE STRUCTURE (Left Shift + right-click to switch), then click to build it.

The description lists the total materials. In normal survival play, the full cost must be available: from your inventory, or through a compatible chest-pulling mod. The full cost is consumed once after construction succeeds, along with one Hammer action's stamina and durability. World free-build settings and native no-cost mode follow the normal Hammer behaviour.

Relevant crafting stations must cover the pieces being built. A station included in the saved structure can provide that coverage. Recipes and required DLC must be available. Wards, no-build areas and other placement restrictions are checked before construction.

How to build with holograms

1. Select a saved structure in the Hammer menu and use Left Shift + right-click until the hint says HOLOGRAM.
2. Position and rotate it, then place it normally. Placing the plan consumes no materials.
3. Keep your Hammer equipped, approach a hologram piece, and aim at it. The hint shows the full materials required for that piece.
4. Press E to build it. All of that piece's materials must be available; there are no partial deposits. A successful build consumes that piece's cost once and uses Hammer stamina and durability.
5. Gather more materials and continue. Start with foundations and supporting pieces: holograms do not provide structural support. A hologram workbench must be built before it can provide crafting coverage.

Holograms are local visuals without physical collision. Other players and the server do not need SaveStructure to see completed vanilla pieces; unfinished plans are visible and usable only on your client. Original mods providing non-vanilla pieces remain necessary as usual.

Plans resume for the same world and character. Each hologram inherits its blueprint's name. Placing another plan with the same name adds a short suffix so the plans can be distinguished, without changing the blueprint's name.

Left Shift + Delete, while aiming at a plan, asks to remove its unfinished hologram without demolishing completed pieces. If an identical real piece already occupies a target position, pressing E clears that hologram piece without charging again. Completed pieces that are later destroyed are not automatically rebuilt.

Deleting saved builds

To delete a saved blueprint, select it in the Hammer menu and close the menu so its placement preview is showing. Press Delete, then confirm the named blueprint in the dialog. It disappears from your saved files and Hammer menu immediately. Existing holograms keep their own snapshots and remain usable; completed structures remain in the world.

To remove an unfinished hologram, equip the Hammer, aim at one of its remaining pieces, press Left Shift + Delete, then confirm. Its local plan and unfinished visuals are removed. Its saved blueprint and completed building pieces remain.

Choose No or press Escape to cancel either dialog. The two removal shortcuts are independently configurable as DeleteSavedStructure and RemoveHologram. If you assign them the same shortcut while both targets are available, the aimed hologram takes priority. Ordinary Hammer pieces are unaffected by blueprint deletion.

Placement collision

[10 - Building] DisableCollision = false enables normal SaveStructure overlap checks. Set it to true, or press F10 in a placement context, to bypass those checks. The hint displays Collision: ON/OFF and the key updates the configuration. On a server with locked settings, only administrators can change this setting.

This affects whole builds, hologram placement and construction through holograms. It does not make completed pieces non-solid, flatten terrain, or bypass ward access, material requirements, crafting coverage or other non-collision building restrictions. Ordinary Hammer pieces are unaffected.

Configuration

The first launch creates BepInEx/config/Dyls123.SaveStructure.cfg. Edit it with the game closed, or use a compatible in-game config manager. File edits require a reload or restart; config-manager changes apply to the next relevant action. Existing values are carried into the numbered sections automatically. If both an old and a new section contain the same setting, the new section takes priority.

Section / Setting	Default	Purpose
10 - Building / DisableCollision	false	Bypass saved-structure overlap checks; other building restrictions still apply.
11 - Selection / MaximumPieces	5,000	Maximum pieces per structure; 1–10,000.
11 - Selection / Reach	25	Selection range in metres; 2–100.
11 - Selection / BoxHeight	20	Initial selection box height in metres; 1–128.
11 - Selection / ScrollHeightStep	1	Box height adjustment per scroll input; 0.1–10 metres.
12 - Holograms / BuildReach	8	Distance to an individual hologram piece; 2–25 metres.
12 - Holograms / MaximumPlans	20	Unfinished plans per world and character; 1–100.
30 - Keybinds / ToggleSaveMode	F8	Enter or leave save mode.
30 - Keybinds / SaveSelection	F7	Name and save the selection.
30 - Keybinds / ClearSelection	Backspace	Clear the selection.
30 - Keybinds / SwitchSelectionMode	Mouse1 + LeftShift	Switch individual / box selection.
30 - Keybinds / SwitchPlacementMode	Mouse1 + LeftShift	Switch whole structure / hologram placement.
30 - Keybinds / ToggleCollision	F10	Toggle overlap checks when permitted by the server.
30 - Keybinds / SelectPiece	Mouse0	Select pieces and confirm box corners.
30 - Keybinds / BuildHologramPiece	E	Build the aimed hologram piece.
30 - Keybinds / DeleteSavedStructure	Delete	Delete the selected blueprint after confirmation.
30 - Keybinds / RemoveHologram	Delete + LeftShift	Remove an unfinished plan after confirmation.
30 - Keybinds / ScrollWheelBoxHeight	true	Adjust box height with the wheel.
30 - Keybinds / IncreaseBoxHeight	None	Optional keyboard height increase.
30 - Keybinds / DecreaseBoxHeight	None	Optional keyboard height decrease.
90 - Server / LockConfiguration	true	Lock synced functional settings to server administrators.

Shortcuts accept modifiers such as F9 + LeftControl; use None to disable one. Selection and placement may share a shortcut because they operate in different modes. A larger Hammer reach supplied by a building mod is also respected. Large layouts use more memory and take longer to preview or place.

Existing config filenames and older defaults migrate automatically while preserving custom values. The published plugin identity remains dylan.valheim.savestructure, and the active config remains Dyls123.SaveStructure.cfg. 99 - Internal contains migration markers.

Saved files

• Structures: BepInEx/config/SaveStructure/structures/.
• Hologram positions and progress: BepInEx/config/SaveStructure/holograms/<world-id>/<character-id>/.

Filenames use your chosen names. Duplicate names receive a short suffix, and unsafe filename characters are replaced. Old ID-only files are renamed when loaded while retaining their internal IDs. Copy the JSON files between profiles to share layouts; rejoin the world to load file changes. Keep each file's internal ID. Back up hologram progress with your saves; restoring an older world does not rewind these local files.

Server configuration

Install the mod on your client to use your own settings in single-player or on a server without the mod. Install the same version on the server to override the gameplay settings of clients running the mod. Server settings are locked to server administrators by default. Keybinds and display preferences stay local, and your local gameplay values return when you disconnect. Players without the mod do not gain its features.

The server controls building, selection and hologram settings. All shortcuts and scroll-wheel input preferences stay local. Config sync does not share blueprints or unfinished hologram plans.

Support

Build cameras: selection and hologram targeting follow the game's build camera and respect extended Hammer reach. Whole structures use the normal Hammer placement preview. Loaded terrain, ward access, crafting stations and other placement rules still apply.

Chest resources: whole builds and hologram pieces use the game's material checks and consumption methods, allowing compatible storage mods to supply the full cost using their own access and range rules. Holograms do not accept partial material deposits.

Modded pieces and multiplayer: original piece mods are required wherever their pieces are used. Unfinished holograms are private. Other players can see completed vanilla pieces without SaveStructure. Mods that replace the Hammer or material-handling methods may need their own integration.

Manual installation

1. Install BepInEx 5 for Valheim.
2. Create BepInEx/plugins/Dyls123-SaveStructure/ in the game installation or active mod-manager profile.
3. Copy SaveStructure.dll from the release ZIP into that folder.
4. Keep only one copy of the DLL and launch the game to generate the config.

The versioned ZIP and Dyls123-SaveStructure.zip use the same Thunderstore-compatible layout, with the DLL at the ZIP root. A mod manager installs the package and its declared dependencies automatically.

Replace any older BepInEx/plugins/SaveStructure/SaveStructure.dll copy when moving to the author-named folder. Keep the existing saved-file folders.