KALI Torch Refill
Refill player-built torches and braziers using fuel from nearby chests. Consumes real fuel, skips open/private chests, and needs no client mod.KALI Torch Refill
KALI Mods · made by Kalia
Version 0.1.0 · Server only · No client install
Put fuel in a nearby chest and let your lights look after themselves. KALI Torch Refill tops up supported player-built lights using their normal fuel.
Resin, guck, greydwarf eyes and coal are taken from storage as needed. You still need to supply the fuel.
Supported lights
Standing wood, iron, green and blue torches; wall sconces; and the three vanilla braziers. Campfires, hearths, ovens, smelters and cooking stations are excluded by default.
Default behavior
- Looks for ordinary storage chests within 10 metres of the light, nearest first.
- Refills at half capacity or below, using whole fuel items.
- Leaves one of the required fuel item in each source chest.
- Skips open and private chests.
- Retries after five seconds; replicated changes can trigger an earlier check.
A client-owned chest must release ownership before it is changed. Fueling also waits until the light's normal simulation is active, so this is not an offline fuel simulator.
Configuration
Edit BepInEx/config/local.finally.torchrefill.cfg after the first start:
| Setting | Default | Purpose |
|---|---|---|
| Enabled | true | Enable refilling |
| Range | 10 | Chest-to-light distance in metres |
| LeaveAtLeast | 1 | Fuel reserved in each chest |
| CheckInterval | 5 | Retry interval in seconds |
| Fireplaces | Eight supported light prefabs | Lights eligible for refilling |
| LogRefills | false | Log successful transfers |
These settings are in the [TorchRefill] section. Restart after changes for a predictable configuration reload.
Compatibility and limits
Requires ServersideQoL 2.5.1 and its dependencies. Verified on a Windows Valheim 1.0.20 dedicated server. Players do not install anything.
50 native runtime assertions cover fuel consumption, all eight lights, range, reserves, chest exclusions and ownership handoff. Actual remote-client fuel handoff has not been fully tested across latency conditions. Avoid combining it with another automatic fuel mod controlling the same lights.
Removing it
Stop the server and remove FinallyTorchRefill.dll. Lights keep their current fuel and return to normal manual refilling.
Installation
- Back up your world and existing configuration, then stop the dedicated server.
- Install BepInExPack Valheim 5.4.2351. Also install ServersideQoL-2.5.1, with their declared dependencies. These are separate projects by ArgusMagnus.
- Merge the package's
BepInExfolder into the dedicated-server folder. Keep the subfolders intact. - Start the server and check
BepInEx/LogOutput.logfor a successful plugin load.
Install on the server only. Clients need no mod. These releases target Windows dedicated servers; console-client and Linux-server compatibility have not been independently validated.
The DLL and configuration names still begin with Finally or local.finally, the project's original internal name. Keep only one copy of this plugin installed.
Credits and support
KALI Mods — made by Kalia. Built with BepInEx, Harmony where needed, and ServersideQoL by ArgusMagnus. Dependencies and Valheim game files are not bundled.
For a bug report, use this mod's public listing comments and include the game version, mod version, relevant error and reproduction steps. Remove passwords, addresses and player identifiers from logs before posting.