KALI Torch Refill

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

1. Back up your world and existing configuration, then stop the dedicated server.
2. Install BepInExPack Valheim 5.4.2351. Also install ServersideQoL-2.5.1, with their declared dependencies. These are separate projects by ArgusMagnus.
3. Merge the package's BepInEx folder into the dedicated-server folder. Keep the subfolders intact.
4. Start the server and check BepInEx/LogOutput.log for 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.