Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
00 Getting Started
Updated 4 days agoHeimKit adds independently configurable quality-of-life features to Windows Valheim dedicated servers. Install it on the server; players use unmodified clients. Linux is not supported. See the supported environment for current game and loader requirements.

Install or update
Stop the server gracefully and wait for saving and shutdown to finish before replacing plugins. Back up the world, the active configuration and both HeimKit/SharedMap/ and HeimKit/ForestRenewal/ directories beneath the active configuration directory. Restore each store together with its matching world backup. Follow the backup guide and read safety and limitations.
Thunderstore Mod Manager: Use a separate dedicated-server profile, install HeimKit and its required BepInExPack Valheim dependency, and launch through the manager's server mode. Point it at the folder containing valheim_server.exe. If server mode is unavailable, install manually.
Manual installation: Install BepInExPack Valheim beside valheim_server.exe, then place HeimKit.dll in BepInEx/plugins/HeimKit/. Keep only one HeimKit DLL in the active installation and launch with the server's normal script.
For updates, use the same profile or replace the DLL in the same active location. Preserve heimkit.cfg and the world-specific plugin stores. See installation details for server paths and launch arguments. Release notes are on the package's Changelog tab.
Choose your features
Startup creates heimkit.cfg in the loader's active configuration directory, preserves existing values and adds missing defaults. The startup log gives its full path. Do not overwrite it with the reference config.
All eleven features default enabled in a fresh configuration. StationSupply feeding for fermenters and Obliterators is opt-in. Review the guides and disable any features you do not want.
Change the owning section's Enabled value. HeimMender reloads its section during play; other sections require a server restart.
| Feature and guide | Config section | What it does |
|---|---|---|
| InfiniteTorches | Torches | Refills eligible torches and braziers without inventory fuel. Optional fireplaces can be enabled separately. |
| WeatherGuard | WeatherGuard | Protects player-built structures from rain and underwater wear while preserving creators. Combat, repair and structural support remain native. |
| AFKNightWatch | AFKNightWatch | Configurable majority sleep and inferred-AFK exclusion. Native bed and time requirements remain. |
| AFKRaidWatch | AFKRaidWatch | Excludes idle-only locations from new automatic raids. Active or uncertain nearby players retain eligibility. |
| SharedMap | SharedMap | Saves community exploration and discoveries, shared through vanilla cartography tables. |
| TameTravel | TameTravel | Brings explicitly following or portal-waiting supported tames through linked player-built portals outside dungeons. |
| DoorKeeper | DoorKeeper | Closes eligible player-built doors and gates after a delay once the doorway is clear. |
| ForestRenewal | ForestRenewal | Renews supported stumps or confirmed-cleared stump locations with matching vanilla saplings, subject to delay, chance and clearance rules. |
| SeaSalvage | SeaSalvage | Recovers eligible settled sunken loose items into floating cargo crates while preserving item data. Tombstones are excluded. |
| HeimMender | HeimMender | Gradually repairs existing damaged player-built structures without materials. Also supports bounded administrative repairs. |
| StationSupply | StationSupply | Supplies supported production stations from nearby public chests. |
Regular player-dependent work pauses when nobody has joined the world and resumes after a player spawns and native services are ready. Configuration stays enabled during this pause.
Sleep, AFK and diagnostics
Default sleep requires strictly more than half of participating players: one of two is insufficient; two of three is enough. At least one living player must be in bed. The default delay is thirty seconds after reaching the threshold; everyone entering bed bypasses it.
Shared [PlayerActivity] defaults to five minutes without observed activity and one minute of join/recovery grace; both must have elapsed. Health loss does not reset AFK. Named AFK entry/exit notices appear without debugging. See AFK limitations.
Logs include local timestamps and feature topics. Enable the relevant DebugMode and permit Debug in the loader's log filters. Under [Diagnostics], DebugVerbosity = Normal gives concise evidence; Verbose adds details only when debugging is already enabled. WeatherGuard combines routine weather-prevention results into nonempty ten-minute summaries. See debug configuration.
Troubleshooting
- Not loading: Check the active server/profile's
BepInEx/LogOutput.logfor HeimKit's version, configuration path and errors. Keep one DLL and use that same installation's launch route. - Version mismatch: See the server upgrade policy. HeimKit can try newer server versions after creating a world checkpoint, and it can persistently disable features that encounter disabling failures.
- Ready but no effect: Ready means services are available. Regular gameplay still requires joined players, eligible objects and native conditions.
- Report a problem: Include HeimKit/game versions, the affected feature, expected versus observed behavior and relevant warnings/errors. Remove passwords, join codes and other private information from logs.