Lur

Lur

Hildir sells a horn. Sound it inside one of her three dungeons and the mini-boss you already killed there comes back, so you can fight it again.

Features

• A horn on Hildir's shelf, 500 coins by default.
• Sounding it inside one of her three dungeons clears the spent mark on the mini-boss's

spawner. Vanilla's own spawner code does the spawning a second later.

• Wakes the mini-boss and nothing else. Looted chests stay looted, smashed pots stay smashed,

mined veins stay mined.

• A cooldown per dungeon, measured in in-game days. Five by default.
• The horn is only consumed if something actually wakes. Every refusal names its reason on

screen.

• Deletes no saved objects, never regenerates a dungeon, never touches terrain and never

writes a global key.

The three dungeons

| Setting | Dungeon | Biome | | --- | --- | --- | | WakeCrypt | Smouldering Tomb | Black Forest | | WakeCave | Howling Cavern | Mountains | | WakeTower | Sealed Tower | Plains |

Lur finds them by the theme flags the game puts on the dungeon generator (ForestCryptHildir, CaveHildir, PlainsFortHildir), not by prefab or location names. Ordinary crypts, caves and Fuling camps are never matched.

Using the horn

Put it on the hotbar and use it there. Using it from the inventory window does nothing; only the hotbar path is hooked.

You have to be standing inside the dungeon. "Inside" means inside one of the generator's own room boxes, plus RoomPadding metres of slack.

When the horn is accepted:

1. The spent mark is cleared on the mini-boss's spawner, and on the other spawners in its

spawn group if it has one. A grouped spawner counts spawns across the whole group, so a spent neighbour would keep the group shut on its own.

1. Lur watches those spawners for up to WatchSeconds (30 by default) and checks what

actually appears against the creature the boss spawner holds.

1. On a match the horn is consumed and the dungeon is stamped with the current world time,

which starts the cooldown.

1. On a timeout every spawner is put back exactly as it was and you keep the horn.
2. If something spawns but it is not the boss, the horn is not consumed and the log explains

it. The spawners are not rolled back in that case, since the spawn has already happened and restoring the old mark could leave a live creature beside a spawner free to make another.

What it says and what it means

| Message | Meaning | | --- | --- | | Nothing sleeps here. | Not inside one of the three dungeons, that dungeon is switched off in config, two dungeons overlap at this point, or no boss spawner was found in it. | | The stone is still settling. | The dungeon's rooms are still streaming in. Wait a second and sound it again. | | This place has not settled. N days yet. | Cooldown. Counted in in-game days. | | Someone lies unclaimed here. | There is a tombstone inside the dungeon. Collect it first. | | It is already awake. | The spawner never fired, or the creature it made is still alive. | | Something built here keeps it away. | Someone has built inside the dungeon and the spawner now sits in a player base area, where vanilla will not spawn. | | Nothing here answers the horn. | A global key on the spawner blocks it. | | Something wakes. | Success. The horn is spent. | | Nothing stirred. | Nothing spawned in time. The horn is not spent. | | Something else stirs. | Something spawned, but not the boss. The horn is not spent; turn on Diagnose and report the census. |

What it does not restore

Only the mini-boss. Chests you emptied stay empty, props you broke stay broken, veins you mined stay mined. A repeat run buys the fight, its drops and its trophy, and nothing you already took. If you want a dungeon that restocks itself, Dvala is the mod for that.

Hildir will not accept a second quest chest. Her turn-in is recorded on the world and her own code refuses an offering whose key the world already holds, before the item is taken. So the cosmetic reward happens once per world however many times you fight for it.

Installation

Requires BepInEx 5.4.2350. BepInEx 5 API only; this is not compatible with BepInEx 6.

Through a mod manager it is one install. By hand, put Lur.dll, lur.obj and lur.png in BepInEx/plugins/Lur/. The .obj and .png are the horn's model and icon and are read off disk at runtime, so the item cannot be built without them.

Then start the game once and quit. That first run writes the config file, which does not exist before the mod has loaded.

Version 1.1.0 is built for Valheim 1.0.7 and does not run on pre-1.0 Valheim. 1.0.1 is the last version for older game builds.

Configuration

The file is BepInEx/config/ezomic.valheim.lur.cfg. Every entry has its reasoning in a comment above it.

BepInEx writes every entry on first run and the saved value beats a new default in code, so changing a default in a new version does nothing on a machine that has already run the mod. If a setting looks like it is being ignored, read the cfg before anything else.

Lur

| Setting | Default | Effect | | --- | --- | --- | | Enabled | true | Off leaves the plugin loaded, drops the horn from Hildir's stock and makes sounding it do nothing. Horns already in an inventory stay there. | | ItemName | Lur | Display name only. The prefab name is fixed in code, because renaming it would orphan every horn already saved in a world. | | ItemDonor | SurtlingCore | Vanilla item the horn borrows its machinery from: ZNetView, ItemDrop, Rigidbody, colliders, floating in water. Its appearance is not used. SurtlingCore and Wood are tried as fallbacks if the named one is missing. |