SunkenCryptTimer

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

| Component | Needed? | Notes |

|---|---|---|

| Valheim | on your client | Built/tested against Valheim 1.0.16 (Unity 6 build). Older versions untested. |

| BepInEx | on your client | Tested with denikson-BepInExPack_Valheim 5.4.2351 (BepInEx 5.4.22+). |

| Venture Location Reset | on the server | The mod displays VLR's reset data; without VLR on the server there is simply nothing to show. Any recent 1.x. |

| VLR on your client | optional | If installed (it usually is on modded servers), the countdown uses the server's live reset intervals, synced through Jotunn. If not, set FallbackResetDays to match your server. |

| Jotunn | not required | This mod does not reference Jotunn or any other package. |

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 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).

| Section | Key | Default | Meaning