HeimKit

Quality-of-life features for Windows Valheim dedicated servers: infinite torches, shared map exploration and markers, weather protection, majority sleep, AFK raid protection, tame portal travel, door closing, tree renewal, sunken-loot recovery and gradual building repairs.

Install on the server. Players use unmodified Valheim clients. Choose each feature independently in heimkit.cfg.

DoorKeeper, ForestRenewal, SeaSalvage, TameTravel and HeimMender default enabled. Review their guides and disable any features you do not want before starting the server. Existing configuration values are preserved; missing settings are added automatically. Install only one HeimKit plugin DLL.

Before enabling HeimKit, follow world backups and read safety and limitations.

Features

InfiniteTorches

Automatically refills eligible torches and hanging/standing braziers without spending inventory fuel. Optional campfire, hearth and bonfire refilling defaults off, with separate controls for each fire type.

Usage and settings · Specification

WeatherGuard

Protects existing and newly player-built structures from rain and underwater wear, preserving their creators. Activation is automatic during play. Combat, repair and structural support stay native; world-created claiming is excluded.

Usage and settings · Specification

AFKNightWatch

Combines configurable majority sleep with idle-player exclusion. A grace period gives others time to reach bed; everyone in bed can start immediately.

Usage and settings · Specification

AFKRaidWatch

Excludes idle-only locations from new automatic random raids. Nearby active or uncertain players retain normal eligibility. Sleep and raid controls are independent.

Usage and settings · Specification

SharedMap

Saves community exploration and discoveries across restarts, independently of cartography tables. Players choose Read Map at a vanilla table to receive updates. Shared death pins are filtered.

Five independent marker options default enabled:

• Portal Marker: named player-built portals, with optional nearby grouping.
• Resource Marker: outdoor metal/Obsidian deposits, Tin node counts and Copper/Silver progress. Silver requires pickaxe discovery.
• Dungeon Marker: labeled exterior entrance markers with the vanilla hammer icon and cleanup of nearby duplicate dungeon pins. Supported pickup percentages appear after observed entry or evidence of already-picked items.
• Runestone Marker: placed lore-runestone landmarks as labeled dots.
• Spawner Marker: visible, player-destructible recurring spawner objects as labeled dots, removed after confirmed source destruction.

Optional settings discover resources/dungeons in previously explored terrain or reject player map uploads while automatic collection continues. Enabled runestone/spawner markers automatically include eligible points in community-explored terrain. Optional shared X checkmarks default off. Server owners can remove a selected shared pin through server-side administration without clearing other pins or exploration.

Usage, settings and administration · Specification

DoorKeeper

Closes eligible player-built doors and gates after a delay once players clear the doorway. Native manual access remains; keyed and special doors are excluded. Defaults enabled.

Usage and settings · Specification

TameTravel

Brings explicitly following or portal-waiting tamed wolves, boars, lox, asksvin, hens and moose along a validated trip between linked player-built portals outside dungeons. Preserves the same animal and its saved state. One follow command covers successive portal trips and following continues at the destination until stopped. Follow, stay and optional portal-wait commands have vanilla emote fallbacks. Explicit followers can use configurable stopping distance through bounded server control. Defaults enabled.

Usage and settings · Specification

ForestRenewal

Renews supported trees from stumps left behind or their confirmed-cleared locations, using vanilla saplings, renewal chance, delay, terrain/building exclusions and persisted cooldowns. Native growth requirements remain. Defaults enabled.

Usage and settings · Specification

SeaSalvage

Recovers eligible stable sunken item drops into ordinary floating cargo crates while preserving native item data. Active client-owned and unsupported drops wait or remain untouched. Defaults enabled.

Usage and settings · Specification

HeimMender

Gradually repairs damaged player-built structures with configurable cycles, chance and limits. Administrators can request nearby repairs, and its settings reload during play. Defaults enabled.

Usage and administration · Specification

Setup and compatibility

Windows dedicated servers with BepInExPack Valheim are supported. See supported environment for exact requirements and safety and limitations for gameplay/client constraints.

Follow server setup for Thunderstore Mod Manager or manual installation. Gameplay processing pauses when the server is empty and resumes after a player joins; see feature lifecycle.

Documentation

• Server setup: installation, configuration and diagnostics.
• Safety and limitations: world risks, server observations and client limitations.
• World backups: matching world, SharedMap and ForestRenewal backups/recovery.
• Feature guides and specifications: linked under each feature in Features.
• Development: build and packaging commands.
• Architecture: shared design and lifecycle contracts.
• Contributing: source/documentation procedures.
• Contributor instructions: task scope and authorization.

License

MIT. Game and dependency assets retain their own licenses.

Changelog

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.