Kalia-KALI_Torch_Refill icon

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.

By Kalia
Last updated 11 hours ago
Total downloads 13
Total rating 0 
Categories Mods Utility AI Generated Server-side
Dependency string Kalia-KALI_Torch_Refill-0.1.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2351
ArgusMagnus-ServersideQoL-2.5.1 icon
ArgusMagnus-ServersideQoL

Serverside-only QoL mod, compatible with vanilla/console (e.g. XBox, PS, Switch) clients. Stack player inventories into chests, generated portal hub, auto-sort chests, refuel smelters from containers, infinite building/farming stamina and much more

Preferred version: 2.5.1

README

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.