SunkenCryptTimer

A client-only Valheim mod for players on servers that run Venture Location Reset (VLR).

It answers two questions at a glance:

• "When does this dungeon reset?" — a HUD countdown ("Sunken Crypt — resets in 2d 14h") whenever you are near a dungeon entrance: sunken crypts, burial chambers, troll caves, frost caves, goblin camps, dvergr mines, Hildir's dungeons, Ashlands fortresses, and more.
• "How close is too close?" — a workbench-style ground ring around each nearby instanced dungeon at the radius VLR's player-activity check uses for it (45 m for sunken crypts), so you can see the footprint where player-made structures or a tombstone would block the dungeon from ever resetting.

No server changes, no Harmony patches, no world-data writes: the mod only reads the VV_LastReset stamps VLR leaves on each dungeon's world object — those sync to every connected client automatically.

Requirements

The mod does not need to be installed on the server (installing it there is harmless but does nothing — servers have no HUD). Other players don't see your rings or your timer unless they also run the mod.

Installation

With a mod manager (r2modman / Gale / Thunderstore Mod Manager): search for "SunkenCryptTimer" and install. Done.

Manual: copy Plugins/SunkenCryptTimer.dll from the package into your BepInEx profile's BepInEx/plugins/ folder.

Usage

Timer

Walk near any dungeon VLR manages (default: within 80 m of the entrance). A single line appears at the top-center of the HUD:

• Sunken Crypt - resets in 2d 14h — the dungeon still holds its loot.
• Sunken Crypt - reset ready (regenerates on approach) — the timer has elapsed. VLR only regenerates a dungeon when a player walks within 100 m of it after the timer expires, so it will pop fresh the moment someone (maybe you) shows up.

Timers keep running while the server is empty (the world clock advances 24/7 while the server process runs), and the countdown is computed from live world time — log back in after a week and the label already reflects it.

Zone rings

Each nearby instanced dungeon (crypt, burial chamber, troll cave, ...) gets a ground ring cloned from the vanilla workbench build-circle: thin rotating dashes hugging the terrain. Its radius is the distance VLR checks for player activity inside that dungeon type — 45 m for sunken crypts, computed per type from the game's own dungeon data (hypot(zoneSize.x/2, zoneSize.z/2), matching VLR's GetDungeonRadius).

Rules of thumb the ring makes visible:

• Build or die inside the ring's area (or within the small entrance zone around the door) and that dungeon stops resetting until the pieces/tombstones are removed.
• A base on the ground outside the ring is safe and never blocks resets.
• Terrain shaping (raising/leveling) never blocks a reset, but VLR reverts terrain within ~12 m of the entrance each time the dungeon resets.
• Rings show while you're within 100 m (VLR's own trigger distance), hide while you are inside the dungeon, and are capped at the 4 nearest features. Ground locations (meadow farms, villages, fuling camps) intentionally get no ring.

Configuration (BepInEx/config/lan124.SunkenCryptTimer.cfg)

All settings are client-side; changes apply immediately (no restart).

How it works

VLR stamps every dungeon it manages with VV_LastReset (the in-game day it last reset) on the dungeon's LocationProxy world object (ZDO). ZDOs sync to every connected client, so this mod:

1. scans nearby LocationProxy objects for the stamp (throttled, default 1 s),
2. resolves the effective reset interval from VLR's own live config on the client (which Jotunn keeps synced with the server's settings) or falls back to FallbackResetDays,
3. displays lastReset + interval − now, mirroring VLR's exact day-math, and
4. (rings) clones the vanilla CircleProjector marker used by the workbench and sizes it per dungeon type from the game's location prefab data, confirmed against the live dungeon generator.

The mod never writes world data, owns no networked objects, and patches nothing.

Building from source

Requires the .NET SDK (6+) and a local Valheim install + BepInEx profile:

./build.sh -p:GameDir=/path/to/Valheim -p:ProfileDir=/path/to/BepInExProfileRoot

GameDir is the folder containing valheim_Data/; ProfileDir is the folder containing BepInEx/core. Output: SunkenCryptTimer/bin/Release/SunkenCryptTimer.dll. ./package.sh additionally builds the Thunderstore zip (requires zip). For the full release/upload workflow see PUBLISHING.md.

Version compatibility

Known limitation: the per-type reset-interval table in src/ResetTimer.cs only takes effect when VLR's per-type override mode is on; otherwise VLR's global ResetTime applies to everything (as on most servers).

License

MIT