PieceReplacer

PieceReplacer is a quality-of-life building mod for Valheim that lets you replace compatible building pieces directly in place.

Instead of destroying a piece and manually rebuilding it, select the replacement piece with the Hammer, aim at the existing piece, hold Left Alt, adjust the rotation if needed, and place it.

Features

• Replace compatible building pieces directly in place
• Preserves the exact target position
• Keeps rotation under player control
• Uses the visible placement preview for the final result
• Uses normal Valheim building costs
• Refunds the replaced piece through Valheim's normal removal flow
• Supports floors, walls, beams, poles, roofs, stairs, and other compatible structure pieces
• Automatic compatibility detection for structurally matching pieces
• Explicit replacement groups can be configured as overrides
• Designed for multiplayer-safe Valheim placement/removal behavior
• No Jötunn dependency required

Usage

1. Equip the Hammer.
2. Select the building piece you want to build.
3. Aim at a compatible existing building piece.
4. Hold Left Alt.
5. Rotate the preview normally if required.
6. Left-click to replace the old piece.

The replacement is placed at the target position using the rotation currently shown by the placement preview.

Example

Replace a wooden floor with an Ashwood floor without manually realigning it:

• Select the Ashwood floor
• Aim at the existing wooden floor
• Hold Left Alt
• Left-click

The same workflow applies to other compatible structural pieces.

Installation

Thunderstore / r2modman

Install PieceReplacer through your preferred Thunderstore-compatible mod manager.

Manual installation

1. Install BepInEx for Valheim.

2. Copy PieceReplacer.dll into:

   Valheim/BepInEx/plugins/PieceReplacer/

3. Start Valheim.

Configuration

After the first launch, the configuration file is created in:

Valheim/BepInEx/config/uk.ainzworth.valheim.piecereplacer.cfg

Configuration options include replacement behavior, explicit compatibility groups, and debug logging.

Compatibility

PieceReplacer primarily targets structural Hammer pieces.

Automatic replacement compatibility checks are intentionally conservative to avoid invalid replacements such as:

• walls -> doors
• floors -> roofs
• short beams -> long beams
• walls -> poles

Pieces that share compatible structural geometry can be replaced even when they use different materials.

Troubleshooting

If a compatible-looking piece cannot be replaced, enable debug logging in the PieceReplacer configuration file and inspect:

Valheim/BepInEx/LogOutput.log

This can be used to identify why a particular pair was rejected by the compatibility check.

Requirements

• Valheim
• BepInExPack for Valheim

License

All rights reserved unless otherwise stated by the package author.