Wabbaka-AreaRepair icon

AreaRepair

Repair nearby building pieces with one hammer action, synchronized for multiplayer servers.

By Wabbaka
Last updated a day ago
Total downloads 589
Total rating 0 
Categories Mods
Dependency string Wabbaka-AreaRepair-1.0.2
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2350 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2350
shudnal-ConditionalConfigSync-1.0.9 icon
shudnal-ConditionalConfigSync

Shared config synchronization and server policy library for Valheim mods. Installed as a dependency and compatible with Jotunn and ServerSync.

Preferred version: 1.0.9
shudnal-ConfigurationManager-1.1.21 icon
shudnal-ConfigurationManager

Localized, recolored, refined. Split view mode. Config files editor. Setting edit window. Changed values are highlighted. Prevent user input or pause the game while window is open. Window scale depends on game scale.

Preferred version: 1.1.21

README

AreaRepair

Repair damaged building pieces in a configurable area with one hammer action. AreaRepair follows Valheim's normal repair rules, costs, permissions, effects, and multiplayer synchronization.

Features

  • Configurable repair radius, with a default of 7.5 metres.
  • Repairs the nearest damaged pieces first.
  • Configurable safety limit for large bases.
  • Ignores generated ruins and other non-player pieces by default.
  • Hold Left Alt to temporarily use normal single-piece repair.
  • Server-controlled gameplay settings.
  • Required version validation for servers and clients.
  • Standard ConfigurationManager interface on F1.
  • Repair-count notifications in all officially supported Valheim languages.

Requirements

  • Valheim 1.0.
  • BepInExPack Valheim 5.4.2350.
  • ConditionalConfigSync 1.0.9.
  • ConfigurationManager 1.1.21.

Thunderstore-compatible mod managers install these dependencies automatically.

Installation

Mod manager

Install AreaRepair from Thunderstore using a compatible mod manager and launch the selected profile.

Manual installation

Install all requirements, then place AreaRepair.dll in:

BepInEx/plugins/AreaRepair/AreaRepair.dll

Remove or disable other area-repair mods before starting the game.

Multiplayer

AreaRepair and ConditionalConfigSync must be installed on the server and every client. Connecting clients must use a compatible AreaRepair version.

The server controls gameplay settings. Client-local settings, such as the single-repair key and repair-count notification, remain individual for each player.

Configuration

Open ConfigurationManager with F1 and select AreaRepair.

Server-controlled settings

Setting Default Description
LockConfiguration true Restricts synchronized settings to server administrators.
Enabled true Enables or disables area repair.
Radius 7.5 Repair radius in metres, from 1 to 100.
MaximumPieces 250 Maximum pieces checked per repair action, from 1 to 2000.
OnlyPlayerBuilt false When enabled, ignores pieces without a player creator.

Client-local settings

Setting Default Description
SingleRepairKey LeftAlt Hold to use normal single-piece repair.
ShowRepairCount true Shows the number of successfully repaired pieces.

The generated configuration file is:

BepInEx/config/Wabbaka.AreaRepair.cfg

Troubleshooting

If the mod does not load or repair pieces, check BepInEx/LogOutput.log and verify that AreaRepair and its dependencies use the same versions on the server and clients.

When reporting an issue, include:

  • AreaRepair version;
  • Valheim version;
  • host, dedicated-server, or remote-client status;
  • relevant lines from BepInEx/LogOutput.log.