HeimKit

HeimKit brings quality-of-life features to Windows Valheim dedicated servers, helping server owners reduce upkeep, coordinate night skipping and limit automatic raids around idle players.

Install HeimKit on the server and choose the features you want independently. It is designed for players using unmodified clients, with configuration managed by the server. Gameplay features pause when no players have joined the world and resume after players spawn; requested administrative reports remain available. The project is under local development; no production release is advertised.

World safety

HeimKit can corrupt a world or cause loss of progress. Back up your world before installing or enabling the mod. See the world backup guide for Windows File Explorer and Valheim's in-game save-management options.

Features

InfiniteTorches

Keeps eligible torches and hanging/standing braziers supplied with fuel automatically, reducing manual refilling without spending player inventory materials. Normal water, smoke and obstruction behavior still applies, so fuel alone does not guarantee a lit torch.

Usage and supported light sources · Technical specification

WeatherGuard

Designed to prevent rain and wetness wear on eligible existing and newly player-built structures while preserving their original creators. Protection activates automatically during play without requiring a repair, logout or rejoin. Combat damage, repair, removal and structural support retain their normal gameplay roles. World-generated structures are outside its current scope.

Usage and protection scope · Technical specification

AFKNightWatch

Coordinates configurable majority sleep and idle-player sleep exclusion, so players can coordinate time skipping without waiting for inferred-idle players. A short grace period gives other players time to reach bed once the threshold is met; everyone in bed can start sleep immediately. Normal bed requirements and the native afternoon/night allowance remain. Server-observed activity informs idle detection, which cannot observe every local menu action.

Usage and scope · Technical specification

AFKRaidWatch

Protects idle-only locations from new normal automatic random raids, independently of sleep. Active or uncertain nearby players retain normal eligibility; active players elsewhere do not remove local protection. Existing raids and explicit, forced or standalone events remain unchanged. Idle protection uses the same server activity inference as sleep exclusion.

Usage and scope · Technical specification

Compatibility

• Windows Valheim dedicated servers; Linux is not supported.
• Requires BepInExPack Valheim and a compatible game version. See the supported environment for version requirements. Unsupported game versions disable the affected features.
• Designed for unmodified clients; HeimKit is installed on the dedicated server.

See server setup for installation and configuration.

Setup

Follow the setup guide to install with Thunderstore Mod Manager or manually, including manual installation when the manager is already installed.

Documentation

• Server setup — supported environment, installation, configuration and general troubleshooting.
• World backups — copying world saves and using Valheim's save-management menu.
• Development — build commands, Thunderstore packaging and plugin references.
• Contributing — change procedure and documentation placement rules.
• Architecture — code organization and shared design rules.
• Contributor instructions — required reading and project scope.

License

HeimKit uses the MIT License. Game files and dependencies retain their own licenses and are not distributed or relicensed by this project.

Disclaimer

Use HeimKit at your own risk. This mod can corrupt your world or cause loss of progress and data. We are not responsible for world corruption, data loss or other damage resulting from its use. Back up your world before installing or using the mod; see the world backup guide.

Changelog

0.2.2

• HeimKit now attempts to run after Valheim updates by default. The new [Compatibility] AllowUnverifiedVersions switch replaces the manual exact-version override; set it to false to require the audited baseline. See server upgrade settings.
• Before enabling features on a newer, unverified Valheim version, HeimKit creates a verified backup of the complete local world, current configuration and existing SharedMap/ForestRenewal data. A persistent record reuses that checkpoint across restarts for the same world and HeimKit/Valheim version combination. See automatic world backups.
• Features that encounter disabling errors during startup or later play remain disabled on subsequent starts for that world/version combination, overriding Enabled = true without rewriting configuration. Healthy features continue independently. Logs identify the failure record and associated checkpoint; see persistent feature disables.
• Installing a different HeimKit version automatically retries features enabled in configuration using a separate failure record, preserving earlier failure history. Old disable decisions do not block the upgraded mod.
• Existing configuration files are migrated automatically: the obsolete SupportedValheimVersion entry is removed, the new switch is added when missing, and existing feature values are preserved. See configuration migration and compatibility limitations.

0.2.1

• Updated the built-in Valheim compatibility requirement to the current supported server environment.
• Reduced WeatherGuard protection interruptions caused by unloaded creatures and loose items. Context checks now follow the game's roof/support collision layers while retaining support-giving pieces and shields as dependencies.
• After a game update, server owners can manually set [Compatibility] SupportedValheimVersion in the active heimkit.cfg to permit loading on another exact game version, subject to the existing runtime API checks. See version override instructions for the setting, accepted format and restart behavior, and compatibility limitations for what the override does and does not establish.
• See WeatherGuard coverage limitations for remaining terrain, instance-loading and vertically separated context constraints.

0.2.0

• Rebuilt shared server processing to reduce repeated world scans, prefab lookups and temporary memory allocations while retaining independent feature settings.
• Reduced repeated SharedMap table processing and moved routine community-exploration disk writes into background work.
• Added TameTravel: supported following tames can accompany players through linked player-built portals outside dungeons. Includes follow, stay and portal-wait commands, adjustable follow spacing, checked arrival placement and cleanup on logout/restart. Fresh follow commands can reclaim an offline player's stale follower.
• Added DoorKeeper: closes eligible player-built doors and gates after a configurable delay when the doorway is clear.
• Added ForestRenewal: renews supported stumps and confirmed cleared-stump locations with matching vanilla saplings, configurable delay/chance and clearance rules, and persistent renewal decisions.
• Added SeaSalvage: recovers eligible settled sunken loose items into floating cargo crates while preserving item data. Tombstones are excluded.
• Added HeimMender: gradually repairs damaged player-built structures without materials, with configurable cycles and nearby administrative repair requests. HeimMender settings reload during play.
• DoorKeeper, ForestRenewal, SeaSalvage, TameTravel and HeimMender default enabled and can each be disabled independently. Existing configuration values are preserved; missing settings are added automatically.
• Fixed SharedMap dungeon percentages and marker labels losing established progress while temporary empty pickup scans await confirmation.
• Redesigned logging with local timestamps, clear feature topics and Normal/Verbose debug detail. Repeated unchanged dungeon observations stay quiet, and failures retain their underlying exception details.
• Combined WeatherGuard's routine weather-prevention output into nonempty ten-minute summaries, flushing pending results when protection pauses or stops.
• Refreshed branding, documentation and feature illustrations, including workflows for all five new features and clearer SharedMap marker labels.

0.1.55

• Added optional InfiniteTorches refilling for campfires, hearths and bonfires. IncludeFireplaces defaults off, with separate Campfires, Hearths and Bonfires controls for choosing which types receive free fuel.
• Added DungeonMarkerSync, enabled by default, with persistent labeled hammer markers at supported dungeon exterior entrances.
• Added optional dungeon discovery in previously explored community terrain, disabled by default and independent of resource discovery.
• Added AllowPlayerMapWrites so server owners can reject player uploads while automatic exploration, markers and Read Map continue.
• Added short remaining-pickup percentages for supported dungeons, including permanent core, Fenris Hair and ancient gemstone pickups. DungeonLootProgress independently hides percentages while retaining entrance markers and saved progress.
• Added optional shared X checkmarks, off by default, with persistent state and vanilla marker-adoption handling.
• Added RunestoneMarkerSync and SpawnerMarkerSync, both enabled by default, for placed lore runestones and visible, player-destructible recurring spawner objects. Hidden creature-spawn points are excluded. Each has one independent switch and automatically includes eligible points in community-explored terrain.
• Added a warning when enabled spawner discovery has no compatible source types, with catalog rejection details available in Debug logs.
• Removed confirmed destroyed spawner markers while retaining discovery history across restarts; killing a spawned creature does not remove its source marker.
• Suppressed duplicate dungeon publications within ten metres of a fixed entrance anchor and clean nearby uploaded dungeon-labeled hammer copies, including stale percentage labels. Preserve other player notes and separate saved entrance histories.
• Added configurable resource-marker spacing: hide resource pins within ten metres of another generated landmark by default, retaining resource history and depletion tracking.
• Reduced packet-copying, repeated map decompression and temporary allocations in dungeon scans, player tracking and routed-message observation while retaining existing scan intervals and validation.
• Rejected malformed compressed map uploads while preserving prior table data.
• Updated SharedMap guides, marker backup coverage and illustrations, with shared safety/client limitations collected in one page.

0.1.54

• Added SharedMap resource markers for outdoor Copper, Tin, Silver, Obsidian and supported static Flametal deposits, with independent controls enabled by default and no client mod required.
• Group nearby same-type discoveries, show remaining Tin node counts, and display remaining-section percentages for Copper and Silver. Silver stays hidden until qualifying pickaxe discovery.
• Persist resource discoveries before any cartography table exists and share them through Read Map. Previously explored discovery remains separately optional and off by default; missing or unloaded deposits are not treated as depleted.
• Added selected shared-pin lookup and persistent removal by name/location identity, preventing later uploads of the selected record while preserving other pins and exploration.
• Added detailed shared-pin change diagnostics and named player connection/disconnection notices.
• Fixed portal marker history being associated with different portals after world-object IDs change on restart.
• Updated SharedMap and feature-overview illustrations and reduced documentation image sizes.

0.1.53

• Added SharedMap: persistent community exploration collected around players, available through vanilla cartography tables without requiring players to write first or install a client mod.
• Added first-run import of exploration from existing cartography tables and filtering of shared death markers while preserving accepted terrain.
• Added optional PortalMarkerSync with named portal markers, NoName for blank tags, and Multi Portals groups using a configurable 60-metre default distance.
• Added portal rename, deletion and stale-marker reconciliation, including cleanup of matching nearby legacy pins. Players receive changes by reading a table; existing client pins may still require local duplicate removal and another read.
• SharedMap and PortalMarkerSync default enabled and can be controlled independently. Back up SharedMap's separate terrain and marker-state files with the world.
• Added illustrated feature guides and documented configuration, backup requirements and vanilla map limitations.

0.1.52

• Fixed stationary players failing to become AFK while health declines. Health loss, including incoming damage and food decay, no longer resets the AFK timer or ends AFK status.
• Added PlayerActivity.DebugMode for shared activity diagnostics independently of sleep and raid debugging, with the existing global inheritance and manual suppression controls.
• Kept ordinary AFK entry and exit notices visible at Info regardless of debug settings.

0.1.51

• Added this changelog to the Thunderstore package so release notes appear on the package page.
• Made release notes mandatory for future Thunderstore packages, with a matching current-version heading and at least one change entry.

0.1.50

• Updated the built-in Valheim compatibility requirement to the current supported environment.
• Added the hidden Compatibility.SupportedValheimVersion setting to authorize one exact game version while retaining runtime API checks and independent feature switches.
• Added validation and startup warnings for manual version requirements, with fallback to the built-in requirement for invalid values.
• Updated compatibility and configuration documentation for all four features.