Delve

Version 0.1.12. Requires Crucible 0.3.27 / Crucible.UI 0.3.20. Changes are in CHANGELOG.md.

Sets dungeon sizes and brings back loot, resources, the Queen and cleared creatures on timers you choose.

Features

• Dungeon size: sets how many rooms new dungeons generate; the minimum is capped at 120 because larger values have corrupted worlds.
• Loot chests refill with a fresh roll after a delay (30 in-game days by default). Player-built chests and Hildir's quest chests are never touched. The next opener can be told who opened a chest before, and when.
• Dungeon resources come back: muddy scrap piles, frost cave crystals, black cores, Morkhalla gems, coin piles and black ice, and the Hole's nests and trash piles.
• One-time world objects come back: Mistlands ancient armor, Mountain obsidian, Ashlands flametal spires and Deep North ice.
• The Queen returns to her citadel after her death and a delay without visitors, and the sealed door locks again.
• Kall Fimbulbringer returns asleep to his Deep North boss room after his death and a delay without visitors.
• Creatures of cleared camps and dungeons can respawn (both off by default).
• Every kind has its own on/off switch, delay (in-game days or real hours) and dry run that only reports what would come back. Nothing comes back while a player is near or where a player has built.
• Players are told what comes back and when (at chests, dungeon entrances and on entering a biome); this can be turned off.
• Full dungeon resets: dungeons set to Full in Delve.Dungeons.yml are wiped and generated again with the current room counts once their delay has passed and nobody is inside. A tombstone inside postpones the reset; player buildings inside and player bases block it.
• Admins can bring back felled trees, bushes, mined rocks and ore, and picked stones, flint and branches in generated zones around them by command (never automatic): delve-surface, delve-surface-resources or delve-surface-nature in the chat or console, or Thing's World page.
• Only what the world generator placed comes back; player-built pieces and everything within the base clearance of them, dungeons and locations are never touched, and a zone whose layout no longer matches the generator (for example after a game update) is reported and left alone.

Requirements

• BepInExPack Valheim 5.4.2351
• Jotunn 2.30.2
• Crucible 0.3.27 or a later 0.3.x, which includes Crucible.UI 0.3.20 (the shared Meadworks interface kit)

Installation

• Mod manager (recommended): install Delve with r2modman, Gale or the Thunderstore Mod Manager; the dependencies above are installed for you.
• Manual: install BepInExPack Valheim, then Jotunn and Crucible, then copy the plugins/Delve folder from this package into BepInEx/plugins/.
• Install Delve where the world runs: single player, the hosting player, or the dedicated server (see Multiplayer).

Configuration

• Settings file: BepInEx/config/com.meadworks.delve.cfg. Edit it in game with Almanac (the Meadworks settings book) or any ConfigurationManager. Delve has no window of its own; its admin page is in Thing.
• The server's values apply to the whole world; admins can lock settings and locked settings show as read-only.
• Cheat: Regenerate Without Waiting is off by default. When on, an admin's regenerate-now command brings a site back at once; players nearby and player buildings still block it. It stays locked unless the server allows it; who may use it follows Crucible's Mischief settings (World category), and Hex is not needed.
• Surface: Allow Surface Reset (on), Surface Base Clearance (50 m around anything a player built, 0-200) and Surface Reset Radius (64 m around the admin, 16-256).
• Converter: imports settings from Max_Dungeon_Rooms, MoreDungeonResets, RestockRegen, Valheim_Admin_Tool and Elite Creatures Reborn after a preview, with a backup.

Multiplayer

• Server-only: install it on the server; players do not need Delve itself. A copy on a client stays idle on a remote server.
• Players without Meadworks (vanilla clients) can join when the server admin sets Crucible's Network.AdmissionMode to AllowVanilla and every installed mod allows it (Delve does). The default, Strict, refuses clients without Meadworks.

Compatibility

• Steps aside, module by module, and says so: Max_Dungeon_Rooms turns off dungeon room counts; MoreDungeonResets turns off full dungeon resets; Valheim_Admin_Tool (with automatic resets on) turns off full dungeon resets; RestockRegen turns off chest refills and dungeon resources; Elite Creatures Reborn (with respawning on) turns off creature respawns, and with dungeon loot respawning on, chest refills.
• Converter: imports the settings of all five mods above (see Configuration).
• Optional Meadworks integrations: Thing shows Delve's admin page and its dungeon and resource clocks.

Notes

• Gamepad: not applicable; Delve runs on the server and has no player window.
• Languages: English, Spanish, Simplified Chinese, Russian, French, German and Korean (non-English text is machine-assisted).
• Inspired by / replaces (behavior reimplemented, no code reused): MoreDungeonResets (Loathe), Max_Dungeon_Rooms (Digitalroot).
• Listed under Thunderstore's AI Generated category; tested in-game.
• Source: Corresponding Source for this exact version, free of charge: https://github.com/ExtraPotions/Meadworks/tree/main/Delve

Changelog

See the Changelog tab (CHANGELOG.md).

Credits and license

Code: GPL-3.0-or-later (LICENSE-CODE.md). Original documentation: CC BY-NC-SA 4.0 (LICENSE-ASSETS.md). Chest refill, history and spot memory are adapted from RestockRegen by liekos47 (MIT); the spawner respawn rules from Elite Creatures Reborn by Gerald Glasgow (GPL-3.0-or-later). Room counts follow the behavior of Max_Dungeon_Rooms by Digitalroot (clean room, no code used); full dungeon resets follow MoreDungeonResets by Loathe and automatic resets follow Valheim_Admin_Tool by QoLTeam (behavior references, no code used).

Author: expDARE.

0.1.15

• Guard world object creation, removal and nearby queries when scene or world-object services are unavailable.

Changelog

Unreleased

• Reuse player dungeon lookups within each regeneration sweep. Geometry, radius and player-snapshot changes rebuild the lookup; current generator, door and resource holds are still checked for each site.
• Reject impossible-height dungeon lookups before copying tracked site lists. Entrance, indoor occupancy, regeneration schedules and protection rules keep their existing behavior.
• Add one Debug timing summary per regeneration check, including dawn detection, service and dungeon sweep timings, scan counts, current regeneration reports, and sidecar serialization and disk timings. Diagnostics allocate nothing when Debug logging is off. Regeneration schedules, guards, saves, and action budgets are unchanged.
• Bump the local development version to 0.1.14.

0.1.13 (2026-10-21)

• Requires Crucible 0.3.28 / Crucible.UI 0.3.20.
• A full regenerate (delve-regen, or an admin request that names every kind) clears Bestiary region claims on the server only after the kinds it accepted have finished. Regenerate Without Waiting has to be on. A request that keeps the usual delays leaves the claims, including when the cheat is off or the Mischief gate locks it. Kinds that are switched off are not part of that regenerate. A request that is refused, canceled, or fails on that check leaves the claims. Dry Run All leaves the claims. Regenerating one kind does not. Finishing the same regenerate again does not clear them a second time.

0.1.12 (2026-10-21)

• Requires Crucible 0.3.27 / Crucible.UI 0.3.20.
• A full regenerate (delve-regen, or an admin request that names every kind) clears Bestiary region claims on the server. Dry Run All leaves them. Regenerating one kind does not.

0.1.11 (2026-10-21)

• Requires Crucible 0.3.26 / Crucible.UI 0.3.19.
• A loot chest that a player has loaded keeps its current items until it unloads. Restock Loaded still lets the delay run while the chest is loaded. The new roll is written on the first check after the loaded copy is gone.
• A flametal spire that drifts keeps one remembered spot. A missing flametal spot is not grown while any whole spire of that ore remains.
• A full dungeon reset generates the replacement before it removes the old interior. If generation fails, the new pieces are removed and the old dungeon stays.

0.1.10 (2026-10-19)

• Requires Crucible 0.3.22 / Crucible.UI 0.3.15.
• Kall Fimbulbringer returns asleep to his Deep North boss room (DN_Bossroom) after his death and a delay without visitors, like the Queen: new Bosses settings Kall Return (on), Kall Clock, Kall Delay (30 in-game days) and Kall Dry Run, and delve-regen-kall. A room with Kall alive in any phase, a player inside or a player holding its objects is never touched. The room has no door; its offering altar is unchanged.
• A citadel whose type is Full in Delve.Dungeons.yml now gets the Queen back in her room when its regenerated rooms do not bring her, and its sealed door locks again while Close Sealed Door is on.

Simpler in-game settings

• Simpler in-game settings: ships settings-tiers.json, so the MeadWorks menu shows Delve's 8 main switches (Enabled, chest refills and delay, Queen and Kall return, camp and dungeon respawns, notices); the rest stays in Almanac, and dry runs, check timing, the chest exclude list and fallback/import entries are marked as normally edited in the config file. Config keys, values and defaults are unchanged.

0.1.9 - batch 4E gameplay fixes (2026-10-19)

• Settings audit: chest settings apply live without a reload.
• Requires Crucible 0.3.21 / Crucible.UI 0.3.14.

0.1.8 - current-build preview refresh

Release stamps and dependency floors for the tested current UI/settings work. This is an intermediate build; expanded 4D and queued 4E are not completed. Exact checks and known limits ship in installer build evidence.

0.1.7 (2026-10-18)

• Explain setting availability through the shared dependency metadata while preserving saved values and existing gameplay rules.
• Require Crucible 0.3.19 / Crucible.UI 0.3.12. Expanded 4D qualification is pending.

0.1.6 (2026-10-15)

• First release on Thunderstore.