DoorDirector

DoorDirector automatically closes Valheim doors after a configurable delay. It supports ordinary doors and modded Door components such as gates and drawbridges, with server-controlled per-prefab rules.

Features

• Uses Valheim's native networked Door state and UseDoor RPC.
• Supports normal, inverted, and ignored prefab behavior.
• Supports a default timeout and per-prefab timeout overrides.
• Cancels a pending close when a player operates the Door again.
• Synchronizes every gameplay setting from the server with ServerSync.
• Lets the server lock gameplay configuration for non-admin clients.
• Exposes clean BepInEx config entries in ConfigurationManager's F1 menu.
• Works on dedicated servers and does not require ConfigurationManager.
• Reports exact prefab names through logging, a hotkey, and a console command.

ServerSync is embedded into DoorDirector.dll, following the upstream ServerSync deployment guidance. It is not a separate Thunderstore dependency.

Installation

Thunderstore or r2modman

Install DoorDirector from the Valheim mod catalog. The manager installs BepInEx automatically from the package dependency.

Install the mod on the dedicated server and on every connecting client. ServerSync enforces compatible DoorDirector versions.

Manual

1. Install BepInExPack for Valheim.
2. Create BepInEx/plugins/DoorDirector/.
3. Put DoorDirector.dll in that directory on the server and every client.
4. Start the game or server once to generate BepInEx/config/com.tomtom.doordirector.cfg.

Configuration

Gameplay settings are authoritative on the server and synchronized to clients. Debug Logging and Prefab Debug Hotkey are client-local diagnostics and intentionally stay out of ServerSync.

Example:

Included Prefabs = wood_door,iron_grate
Inverted Prefabs = my_drawbridge
Ignored Prefabs = boss_gate
Custom Delays = wood_door=3,my_drawbridge=12

Rule precedence is Ignored, then Inverted, then normal. A custom delay configures a prefab for normal behavior unless it also appears in Inverted Prefabs. Name matching is case-insensitive and surrounding whitespace is ignored.

Inverted mode treats logical state 0 as physically open and logical state 1 or -1 as physically closed. When closing an inverted Door, DoorDirector restores its previous native direction through the UseDoor RPC.

Finding prefab names

Look at a Door, gate, or bridge that uses Valheim's Door component and press F7. The exact prefab name appears on the HUD and in the BepInEx log.

The same diagnostic is available in the Valheim console:

doordirector_prefab

Enable Debug Logging to log the exact prefab name whenever the local player interacts with a Door.

Building

DoorDirector targets .NET Framework 4.8. Local builds use the actual assemblies from the installed game and BepInEx profile; no game or framework DLLs are stored in this repository.

The default local path is D:\SteamGames\steamapps\common\Valheim. Build and package with:

.\scripts\build.ps1
.\scripts\package.ps1

Override discovered paths when needed:

.\scripts\package.ps1 `
  -ValheimPath "D:\Games\Valheim" `
  -BepInExRoot "D:\Profiles\Valheim\BepInEx" `
  -ServerSyncPath "D:\Dependencies\ServerSync.dll"

The GitHub Actions build downloads the Valheim dedicated-server assemblies through SteamCMD, BepInExPack from Thunderstore, and the pinned upstream ServerSync release. Those dependencies are used only during compilation.

Release process

1. Update DoorDirectorVersion in Directory.Build.props.
2. Add the release notes to CHANGELOG.md.
3. Run .\scripts\package.ps1 and inspect the ZIP in artifacts/.
4. Commit and tag the release as vX.Y.Z.
5. Create a GitHub release for that tag. The workflow builds, validates, and attaches the matching Thunderstore ZIP.

Upload that ZIP to the Valheim community on Thunderstore using your publisher namespace. Select appropriate categories such as Mods, Utility, Client-side, and Server-side. Because this repository and its icon were produced with AI assistance, also select Thunderstore's AI Generated category when publishing.

License

DoorDirector is available under the MIT License.

Changelog

All notable changes to DoorDirector are documented here.

The format follows Keep a Changelog, and releases use Semantic Versioning.

Unreleased

0.2.0 - 2026-09-06

Added

• Added a configurable hotkey for toggling auto-close on individual player-built doors and gates.
• Added a server-synchronized delay for player-enabled doors.
• Added a second shortcut that opens Valheim's text input to set and persist a custom per-door delay.
• Persisted per-door overrides in Valheim's native networked object data.

0.1.2 - 2026-09-06

Fixed

• Aligned the Thunderstore package, DLL, and BepInEx plugin versions after the 0.1.1 manifest-only release.

0.1.0 - 2026-09-06

Added

• Automatic closing for native Valheim Door components.
• Normal, inverted, and ignored per-prefab behavior rules.
• Default and per-prefab close delays.
• Server-synchronized gameplay configuration with server locking.
• Cancellation when a Door is operated again before its timer expires.
• Exact prefab diagnostics through logging, an F7 hotkey, and the doordirector_prefab console command.
• Dedicated-server support and a Thunderstore/r2modman package workflow.