Dismantleheim

Dismantleheim

Satisfactory-inspired queued selection for Valheim with two modes:

• Mass Dismantle — reclaim construction materials like the normal Hammer (vanilla refunds).
• Mass Delete — erase selected objects with no material or harvest drops. Deleting containers can destroy their contents.

Nothing is removed on hover, select, tool switch, or mode switch. Hold Mouse3 to confirm.

| | |

| --- | --- |

| Version | 0.1.0 (beta) |

| GUID | com.sonicdm.valheim.dismantleheim |

| Dependencies | BepInExPack Valheim, Jötunn |

| Soft dependency | Infinity Hammer (Tools menu entries) |

How to get the tools

With Infinity Hammer (recommended)

• Install Infinity Hammer (+ Server Devcommands / World Edit Commands as required by IH).
• Run hammer_menu to spawn the Infinity Hammer.
• Equip it → build menu → category hammer → Dismantleheim - Mass Dismantle / Dismantleheim - Mass Delete (Hammer icons; IH loads BepInEx/config/tools/infinity_tools*.yaml).
• Or press Delete (ActivateKey) while in hammer placement mode.

First launch after install writes the tools file; restart once if the entries are missing from the menu.

Without Infinity Hammer

Equip a hammer → enter build/placement mode → press Delete, or console: dismantleheim mode dismantle|delete. No extra hammer item.

Controls (while active)

| Input | Action |

| --- | --- |

| Click / hold LMB | Add piece under aim (does not unselect) |

| Hold Ctrl + wave aim | Mass-select valid pieces under the cursor (add-only; no box) |

| Ctrl + click | Unselect one hovered piece |

| Shift + Mouse3 | Sample prefab filter (vanilla pipette suppressed) |

| Hold Mouse3 | Confirmation ring; release early cancels |

| Right click | Normal build menu |

| Escape | Cancel hold or clear queue |

| ActivateKey again | Deactivate |

HUD shows MASS DISMANTLE — Returns Materials or MASS DELETE — No Drops, plus N selected. Mass Delete warns when queued containers hold items.

Unfiltered selection: removable Pieces only. Mass Delete may include rocks/trees/props after an explicit prefab sample. Mass Dismantle never queues environment.

Dry-run

Removal.DryRunOnly = false by default (live dismantle/delete). Set true to log the plan only with no world deletes — useful for testing. Read docs/authority.md before enabling live remove on a valued world.

Authority

• Mass Dismantle (live): ward access → CheckCanRemovePiece → Piece.CanBeRemoved → WearNTear.Remove → Piece.DropResources (vanilla refund path).
• Mass Delete (live): ward access → WearNTear.Remove without DropResources. Occupied chests allowed after warning.
• Environment on unmodded dedicated servers is not promised. Details: docs/authority.md.

Config

• [Modes] DefaultMode, ShowActiveMode, PreserveSelectionOnModeSwitch
• [Input] ActivateKey (Delete)
• [Confirm] HoldSeconds, ShowRing, ShowSelectedCount
• [Selection] AllowEnvironmentWithFilter, ClearQueueOnToolSwitch, MaximumTargets, ExtraDeny/Allow
• [Safety] WarnWhenDeletingOccupiedContainers, RefuseUnknownDeleteTargets
• [Integration] InstallInfinityHammerTool, PreferInfinityHammerOnly
• [Removal] DryRunOnly

Commands

| Command | Purpose |

| --- | --- |

| dismantleheim mode dismantle\|delete | Enter / switch mode |

| dismantleheim activate | Enter DefaultMode |

| dismantleheim deactivate | Leave mode |

| dismantleheim status | State / mode / queue / filter |

| dismantleheim clear | Clear queue |

| dismantleheim why | Last selection reject reason |

Install / Build / Uninstall

• BepInExPack + Jötunn (+ Infinity Hammer for Tools entries).
• Place Dismantleheim.dll in BepInEx/plugins..\build.ps1.\test.ps1

Uninstall: remove the DLL; optional delete BepInEx/config/infinity_tools_dismantleheim.yaml (or config/tools).

Acceptance

• Dual-mode: docs/acceptance-Gxx.md
• Selection/confirm history: docs/acceptance-Hxx.md