SimpleAccessControl

Simple Access Control

Lightweight access control for player-built doors/gates, containers, beds, crafting stations, cooking stations, cartography tables, carts and ships in Valheim 1.0.

Designed for small multiplayer servers that want object-level privacy without wards, guilds or group systems.

Behaviour

• Player-built supported objects are Public by default.
• The piece creator is the permanent owner for access-management purposes.
• Owner can switch an individual object between:
• Public — everyone may use it unless explicitly denied.
• Private — only the owner may use it; player exceptions do not grant access.
• Whitelist — owner plus explicitly allowed players may use it.
• Per-player rules:
• Default — follow the object's Public/Private/Whitelist mode.
• Allow — always allow this player.
• Deny — always deny this player.
• Public applies explicit Deny rules; Private remains owner-only; Whitelist applies Deny > Allow > denied by default.
• The owner is always allowed.
• A fully Public object with no effective restriction keeps vanilla dismantling and damage rules: another player can destroy it.
• As soon as an effective restriction exists (Private/Whitelist mode, or a Public-mode Deny), dismantling and player damage become owner/admin-only.
• Private and Whitelist objects are protected: only the owner/admin can destroy them.
• Crafting-station coverage includes the workbench, forge, cauldron and mead kettle when the prefab uses Valheim's CraftingStation component.
• Cooking-station privacy blocks both adding food/fuel and collecting cooked items.
• Cartography-table privacy independently guards both controls: reading the shared map and depositing the player's discoveries.
• Cart privacy covers its storage and attaching/detaching through the cart interaction.
• Ship privacy covers onboard storage and the helm/ship controls. It cannot physically prevent a player from jumping aboard.
• Creature and environmental damage remain vanilla; this mod blocks unauthorized player destruction, not world simulation.
• World-spawned chests/doors and pieces with no player creator are ignored.

Usage

1. Look at a supported player-built object or one of its interaction controls.
2. Hold Left Shift and press Valheim's Use key (E, F, etc.) to cycle Public → Private → Whitelist → Public without opening a window.
3. Hold Left Shift + A when Valheim is in French, or Left Shift + Q in every other language, to open the detailed Access Control window.
4. Select Public / Private / Whitelist and set individual players to Default / Allow / Deny.
5. In Whitelist mode, set every permitted player to Allow.
6. Changes are stored in the object's ZDO and therefore persist with the world.

The player to whitelist must be connected when first added. Once configured, that player remains listed while offline. The panel now displays an explicit whitelist summary and a warning when no other player is currently detectable.

Claimed beds are a special case: when AssignedBedsForcePrivate = true, the sleeper assigned by Valheim becomes the bed's owner. The bed is forced Private, ignores whitelist exceptions, and only that sleeper can use or destroy it; server admins retain their override.

Installation

Gale or another Thunderstore mod manager (recommended)

1. Search for SimpleAccessControl by Zephyrfit in your mod manager.
2. Install it in the Valheim profile used to join the server.
3. Install the same package version on the dedicated server and every client.
4. Restart Valheim and the server after installation or configuration changes.

The mod manager downloads the precompiled plugin and installs the declared BepInEx dependency automatically. Normal players do not need the .NET SDK, the source code or the Windows build installer.

Manual installation

1. Install BepInExPack Valheim 5.4.2350 or later.
2. Download the Thunderstore package and extract it.
3. Copy BepInEx/plugins/SimpleAccessControl/SimpleAccessControl.dll into the matching BepInEx/plugins/SimpleAccessControl directory on the client or dedicated server.
4. Use the same SimpleAccessControl version on the server and every client.

Players already present in an object's ACL remain visible in the panel even when offline. New players must be connected to the server at least once before they can be selected. Connected players are read from the ZNet roster, even when their character is not currently loaded near you.

Multiplayer

Install on the dedicated server and every client. For a Gale-managed server, publish/install the Thunderstore package and add it to the shared Gale profile.

The mod deliberately patches Container.CheckAccess(long) rather than replacing container open logic, to remain compatible with mods such as MultiUserChest that also manage chest ownership/open sessions.

Teleport portals are intentionally outside this mod's scope. Simple Access Control does not patch TeleportWorld, portal placement or portal targeting, and therefore leaves TargetPortal fully responsible for its own Public / Private / Group / Admin / Guild rules. In this documentation, "gates" means physical doors such as the wooden gate or iron gate.

The hover text always shows the effective state (PUBLIC, PRIVÉ, LISTE BLANCHE or PUBLIC AVEC EXCEPTIONS) and both resolved shortcuts. Destruction status appears while a hammer/build tool is equipped. Raw tokens such as $KEY_Use are never shown.

The interface follows Valheim's selected language: French uses the French strings; English and every other game language use English.

Maintainer / source build

This section is only for developers and package maintainers. It is not required when installing through Gale or Thunderstore.