Stoneveil

Stoneveil

Hidden passages, ordinary stonework.

Turn an existing Valheim wall, floor, or roof into a concealed moving panel. Conversion keeps the vanilla piece, its health, materials, and saved position. Adding a hinge to a 2x1 stone wall now creates a 2x2 secret door with two matching stone courses. The upper course repeats the original geometry one metre higher, preserving stone proportions and texture scale. Both courses move as one panel.

Early prototype: compilation and 715 automated state/motion/auto-close/linked-switch/collision-dispatch checks pass. Live-game visuals, structural behavior, and multiplayer have not yet been verified. Try it in a test world first.

Install

Install Stoneveil through Thunderstore Mod Manager or r2modman. For an unpublished ZIP, use your manager's local-mod import option. Launch Valheim through the selected mod profile.

Required dependencies:

• BepInExPack Valheim 5.4.2350
• Jotunn 2.30.0

Install the same Stoneveil version on every client and the server.

For manual installation, install the dependencies first, then copy the ZIP's plugins/Stoneveil folder into your active profile's BepInEx/plugins folder. The resulting file should be BepInEx/plugins/Stoneveil/Stoneveil.dll.

Upgrading From Secret

Exit Valheim and remove the old Secret.dll from your active profile before installing Stoneveil. Existing saved hinges and configuration remain compatible. The configuration filename intentionally remains com.tomtom.secret.cfg.

Controls

Build a supported vanilla piece, then equip the vanilla hammer and aim at it. Only the original builder can add, change, or remove a hinge.

| Action | Default control | | --- | --- | | Convert to a secret door | Alt+H | | Remove the hinge from a closed panel | Ctrl+Alt+H | | Cycle hinge edges, slide left, slide right | Alt+J | | Reverse a hinged panel's swing | Ctrl+Alt+J | | Hide/show the interaction prompt | Alt+K | | Open/close | Put the hammer away, aim at the panel, press Use (normally E) |

Hammer shortcuts are configurable in BepInEx/config/com.tomtom.secret.cfg. Opening uses the game's normal keyboard or controller Use binding. Editing defaults to keyboard shortcuts. Motion changes require a closed panel. Hidden prompts do not lock the door: anyone with ward access can still use it.

For a stacked stone door, leave one course of free space above a single 2x1 stone wall and press Alt+H with the hammer equipped. Occupied space blocks conversion; the mod does not consume or join an existing wall above it. The original bottom edge stays in place. Removing the closed hinge removes the added upper course and its snap points, returning to the original 2x1 wall. Existing stone doors from 0.1.0 keep their size; remove and re-add their hinge to use the stacked form.

Supported Pieces

• Wood walls: wood_wall_quarter, wood_wall_half, woodwall.
• Stone walls: stone_wall_2x1, stone_wall_1x1.
• Floors: wood_floor, wood_floor_1x1, stone_floor_2x2.
• Straight thatch roofs: wood_roof, wood_roof_45.

Walls hinge at a side edge; floors and roofs hinge across a front/back edge. All support sliding left/right. Prefabs with unexpected component layouts are rejected with a message instead of being converted. Natural ruins are excluded.

Auto-Close Compatibility

Stoneveil 0.3.0 exposes converted panels as standard Door components and mirrors their open/closed state. Install an auto-close mod alongside Stoneveil to supply the timer. Stoneveil itself does not enable an automatic closing timer.

The adapter was implemented against these inspected sources; live-game compatibility testing is still pending:

| Mod | Integration and setup | | --- | --- | | DoorDirector | Standard state observation and UseDoor auto-close. Aim at your converted panel with the hammer put away; Shift+G toggles that panel's auto-close and Shift+T sets its delay with DoorDirector's default controls. | | Protective Wards | Standard RPC_UseDoor observation and owner-side UseDoor close. Enable its passive door auto-close setting and place the panel within an eligible active ward. Its additional permission features still need separate compatibility testing. |

Other mods that discover live Door components and request owner-side closure through UseDoor, Door.SetState(0), or a direct owner-side state = 0 write can use the same adapter. This is not a blanket compatibility guarantee. Mods that require a particular Animator/controller, scan only original door prefabs, or write state only on a non-owning client are not covered by this integration.

For prefab filters, use the panel's original name, such as stone_wall_2x1 or woodwall, not Stoneveil. In DoorDirector, enable the individual panel or add its original prefab name if Only Affect Configured Prefabs is enabled. Use normal, not inverted, door rules for these panels.

Automatic UseDoor requests are close-only and accepted on the owning peer from that same owner. Repeated close requests cannot reopen a closed panel. A blocked close retries for up to 60 seconds; accepted manual use, hinge removal, or lost ownership cancels the retry. Direct automatic state writes cannot open a panel. Mods that explicitly call Door.Interact can still open it under normal access checks, so disable proximity auto-opening in those mods to keep passages hidden.