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)

1. Install Infinity Hammer (+ Server Devcommands / World Edit Commands as required by IH).
2. Run hammer_menu to spawn the Infinity Hammer.
3. Equip it → build menu → category hammer → Dismantleheim - Mass Dismantle / Dismantleheim - Mass Delete (Hammer icons; IH loads BepInEx/config/tools/infinity_tools*.yaml).
4. 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

1. BepInExPack + Jötunn (+ Infinity Hammer for Tools entries).
2. 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