RestockRegen

A server-side mod for Valheim dedicated servers, made for long-running multiplayer worlds. In Valheim some things can be taken only once per world: a loot chest stays empty, a sunken crypt stays mined out, the Queen stays dead. Players who join the server later find those places already stripped by the players before them. This mod brings a chosen list of those one-time resources back after a while, so latecomers get their share too.

It does not regenerate every resource. Only the things in the list below come back. Everything else is left exactly as the game has it, for example copper, tin and silver deposits, trees and rocks. Everything in the list except loot chests can also be turned off on its own in the settings.

What comes back:

• Loot chests refill 30 in-game days after they are first opened.
• Muddy scrap piles in sunken crypts, crystals in frost caves, black cores in infested mines, the gems and coin piles in the Deep North's Morkhalla dungeon, and the nests and trash piles in the Deep North's Holes come back after the dungeon has gone 30 days without visitors.
• The Queen comes back to a Mistlands infested citadel 30 days after the last visit, once she has been killed, and its sealed door closes again.
• Ancient armor (the giant's helmets and swords in the Mistlands), obsidian (Mountains), flametal (the spires in the Ashlands' lava) and ice (the Deep North's ice ponds and shore ice) come back where nobody has been for 30 days.

Server-side only. Install it on the dedicated server. Players install nothing, and everything they see arrives through the game's own messages.

Days are played time. On a dedicated server, in-game time only moves while at least one player is online. A Valheim day is 20 minutes, so 30 in-game days is about 10 hours with someone on the server, not 10 hours of the server running.

Contents

• What players see
• Loot chests
• Muddy scrap piles
• Frost cave crystals
• Black cores
• Morkhalla gems and coin piles
• The Hole
• The Queen's citadel
• Ancient armor, obsidian, flametal and ice
• Admin commands
• Settings
• Hot reload
• Installation
• What the mod stores

What players see

Loot chests

• Only chests whose kind has a loot table: crypt chests, camp chests, shipwrecks, buried treasure, Dvergr and Ashlands chests and so on. Player-built chests, carts, ships, tombstones and cargo crates have no loot table and are never touched.
• A chest's clock starts the first time a player opens it (or the server finds it empty). 30 days later whatever is inside, loot or junk a player dropped in, is replaced with a fresh roll from its own loot table. Do not use dungeon or world chests for storage.
• A chest nobody has opened keeps its original loot.
• A chest next to a base, which is loaded nearly all the time, still refills, as long as nobody has that chest open at the moment the daily check runs.
• Hildir's three quest chests are never refilled, so her quest items are not handed out twice.
• A chest that has been destroyed (smashed or burnt) is gone from the world and cannot come back.
• Installing the mod on an old world does not refill everything at once: the clocks start when the mod first sees each chest.

Muddy scrap piles

• Sunken crypts only.
• A crypt's piles come back once nobody has been inside it for 30 in-game days. Any visit starts the count again, so a crypt people keep going back to stays as it is. Standing at the entrance does not count as a visit.
• Mining a pile replaces it with a broken pile, and breaking every chunk of that deletes it. The mod remembers every pile's spot from the first time it sees it, whole or broken, so both come back. A pile mined out completely before the mod was installed left nothing behind and cannot come back.
• A crypt with a player in it, or next to it, waits until they leave.

Frost cave crystals

• The crystals growing in the Mountains' frost caves (Pickable_MountainCaveCrystal). The game never brings them back: picking one deletes it.
• They work exactly like the sunken crypts' mud piles: a cave's crystals come back once nobody has been inside it for 30 in-game days, any visit starts the count again, and standing at the entrance does not count.
• Every crystal is remembered from the first time the mod sees it. Crystals picked before the mod was installed cannot come back.
• A cave with a player in it, or next to it, waits until they leave.
• Players get the same two messages as at a crypt: the days left at the entrance, and the full 30 days once inside.

Black cores

• The black cores on their stands in the Mistlands' infested mines (Pickable_BlackCoreStand). The game never brings them back: a taken core's stand stays, marked as taken, for good.
• They follow the same rule as mud piles and crystals: a mine's cores come back once nobody has been inside it for 30 in-game days, any visit starts the count again, and standing at the entrance does not count.
• Because the stand stays in the world, every taken core can come back, including ones taken before the mod was installed. Nothing is created: the stand is simply marked as not taken.
• A mine with a player in it, or next to it, waits until they leave.
• Players get the same two messages as at a crypt: the days left at the entrance, and the full 30 days once inside.
• The Queen's own lair is a separate dungeon with its own rule: see The Queen's citadel.

Morkhalla gems and coin piles

The dungeon inside the Deep North's castle. Four things in it are restored once nobody has been inside for 30 in-game days (any visit starts the count again; standing at the entrance does not count):

• Piles are remembered from the first time the mod sees them. One broken or taken before the mod was installed left nothing behind and cannot come back.
• The dungeon's chests are loot chests and refill under the loot chest rules.
• Only the dungeon is covered. The treasure piles lying on the surface around the castle are not.
• Players get the same two messages as at a crypt: the days left at the entrance, and the full 30 days once inside.

The Hole

The Deep North's underground Holes. What the normal game does with each thing in them, read from the game's own data:

• A Hole's trash piles and nests come back once nobody has been inside it for 30 in-game days. Any visit starts the count again, and standing at the entrance does not count.
• They are remembered from the first time the mod sees them. One broken before the mod was installed left nothing behind and cannot come back.
• A Hole with a player in it, or next to it, waits until they leave.
• Players get the same two messages as at a crypt: the days left at the entrance, and the full 30 days once inside.

The Queen's citadel

The Mistlands' infested citadel, behind the sealed door. What the normal game does with each thing in it, read from the game's own data:

• A citadel is reset only after its Queen has been killed. While she is alive nothing in it is touched, however long it stands empty.
• Once she is dead, the citadel resets after nobody has been inside it for 30 in-game days. Any visit starts the count again. Standing in front of the door does not count.
• A Queen killed before the mod was installed comes back too: her place is worked out from the citadel itself, not remembered. For those citadels the 30 days start when the mod first runs.
• Eggs and creep blocks are remembered from the first time the mod sees them. Ones hatched or broken before the mod was installed left nothing behind and cannot come back.
• A citadel with a player inside it, or in front of its door, waits until they leave.
• A player in front of the door of a citadel whose Queen is dead is told how many days are left, and again, with the full 30 days, on going inside.
• The Queen gives her normal drops again each time. The game's own altar in her room still works as before.
• CitadelCloseDoor set to false leaves the door as the players left it.

Ancient armor, obsidian, flametal and ice

Four kinds of world object that work the same way, each with its own settings:

• A mined or missing object comes back once no player has been within 100 m of its spot for 30 in-game days. Any visit starts the count again for that area.
• Nothing is put back where a player has built. If anything a player built stands within 8 m of the spot, it stays gone and the spot is checked again every day.
• An object is remembered from the first time the mod sees it, whole or damaged. Objects mined out or taken before the mod was installed cannot come back.
• Players entering the Mistlands, the Mountains or the Ashlands are told about it, at most once every 10 minutes.
• In the normal game a mined flametal spire stays as an empty husk for good, and now and then one sinks into the lava and is gone. Here a spire with any chunk mined, or one that has sunk, comes back whole.

Dragon eggs are not handled by the mod because they do not need to be: the game brings taken eggs back by itself.

Admin commands

A server-only mod cannot add its own console or chat commands: the console runs on each player's own computer, and plain chat on Steam is sent straight to the other players. The one console command that sends its text to the server is Valheim's kick, so the commands ride on it.

How to type them

• In the chat box: /kick restock-help
• In the F5 console: kick restock-help

Who can use them: players listed in the server's adminlist.txt (the same list that makes someone an admin for kick and ban). Anyone else is told the commands are for server admins. The answer appears in your F5 console and at the top left of your screen. A normal kick, /kick PlayerName, still works as before.

One word only. Only the first word after kick reaches the server, so every command is a single word with no spaces.

Command list

Changing settings with restock-set

The setting name is not case-sensitive. The value is written the same way as in the config file: true or false, a whole number, or a decimal number.

/kick restock-set:Days=20
/kick restock-set:MudPileDays=45
/kick restock-set:AncientArmorDryRun=false
/kick restock-set:Notify=false

For text settings, type _ wherever you want a space, because a command cannot contain spaces:

/kick restock-set:NotifyText=The_chest_will_refill_in_{days}

Every setting is listed under Settings. Exclude needs a server restart to take effect; everything else applies within 30 seconds.

Settings

All settings live on the server, in BepInEx/config/liekos47.restockregen.cfg. Players have nothing to configure.

How to configure the server

1. Install the mod and start the server once. The mod writes the config file with every setting at its default.

2. Open BepInEx/config/liekos47.restockregen.cfg in a text editor. On a hosted server, use the host's file manager or SFTP.

3. Change the values you want and save the file. Each setting sits under a [Section] heading, as Name = value:

   [General]
   Days = 30
   
   [MudPiles]
   MudPiles = true
   MudPileDays = 30
   

4. There is no need to restart. The mod reads the file again every 30 seconds. The one exception is Exclude, which needs a server restart.

Admins can also change any setting from inside the game with /kick restock-set:Setting=value, see Changing settings with restock-set. That writes to the same file.

Things most servers will want to look at:

• How long things take to come back. Every kind has its own ...Days setting, 30 in-game days by default: Days for chests, MudPileDays for sunken crypts, IceDays for ice and so on. Days are played time, about 20 minutes each with someone online.
• Turning a kind off. Every kind except loot chests has its own on/off setting named after it, such as MudPiles, Obsidian or Ice. Set it to false and the mod leaves that resource alone. Enabled = false under [General] switches the whole mod off, chests included.
• Trying it safely first. Every kind has a ...DryRun setting. With it on, the mod only writes to the server log what it would bring back and changes nothing in the world.
• The on-screen messages. Notify = false turns them off, and every message text can be rewritten.

The tables below list every setting, section by section.

General (chests)

Notify (chest messages)

History

MudPiles

FrostCaves

VisitCheckSeconds under MudPiles sets how often frost caves are checked too.

InfestedMines

VisitCheckSeconds under MudPiles sets how often infested mines are checked too.

Morkhalla

VisitCheckSeconds under MudPiles sets how often this dungeon is checked too.

TheHole

VisitCheckSeconds under MudPiles sets how often Holes are checked too.

Citadel

VisitCheckSeconds under MudPiles sets how often citadels are checked too.

AncientArmor

Obsidian

Flametal

Ice

DeepNorth

Ashlands

Mountains

Hot reload

The mod has no hot reload of its own. A new version can be loaded without restarting the server with ScriptEngine from the BepInEx developers, which the mod is built to work with:

1. Put ScriptEngine.dll in BepInEx/plugins/, and RestockRegen.dll in BepInEx/scripts/ (not in plugins/ as well).
2. In BepInEx/config/com.bepis.bepinex.scriptengine.cfg set LoadOnStart = true and EnableFileSystemWatcher = true.
3. To load a new version, back up the world first, then replace BepInEx/scripts/RestockRegen.dll. ScriptEngine reloads it a few seconds later.

Settings never need a reload; they are read every 30 seconds. Each reload leaves the old copy in memory (a few tens of kilobytes), so restart the server now and then.

Installation

Requires BepInEx 5 on the dedicated server. Put RestockRegen.dll in BepInEx/plugins/, or in BepInEx/scripts/ for hot reload. Start the server once to create the config file, then see How to configure the server.

What the mod stores

• On each loot chest: its clock (restockregen_emptysince) and history (restockregen_firstby, restockregen_firstday, restockregen_lastby, restockregen_lastday).
• On each sunken crypt: its pile spots (restockregen_mudspots) and last visit (restockregen_lastvisit).
• On each frost cave: its crystal spots (restockregen_crystalspots) and last visit (restockregen_cavevisit).
• On each infested mine: its black core spots (restockregen_corespots) and last visit (restockregen_minevisit).
• On the Morkhalla dungeon: its gem and pile spots (restockregen_morkspots) and last visit (restockregen_morkvisit).
• On each Hole: its nest and trash pile spots (restockregen_holespots) and last visit (restockregen_holevisit).
• On each infested citadel: its egg and creep block spots (restockregen_citadelspots) and last visit (restockregen_citadelvisit).
• Beside the world save: worlds_local/<world>.restockregen.txt, the ancient armor, obsidian, flametal and ice spots, and when each area was last visited. Keep it with the world when you back it up or move it.

Removing the mod leaves these behind, and the game ignores them.

Credits

The idea of restocking dungeons on a timer comes from Dvala by Ezomic. This is a separate, server-only implementation and contains no Dvala code.

Licence

MIT.