Andejx-RefillAllTorches icon

RefillAllTorches

Keeps every fuel-burning light source topped up automatically - torches, sconces, braziers, fire pits and more. Free refills, or a frugal mode that spends just 1 fuel item per refill. Inspired by PocketResin by zach.

By Andejx
Last updated 8 hours ago
Total downloads 73
Total rating 0 
Categories Mods Tweaks Client-side Utility AI Generated Deep North Update
Dependency string Andejx-RefillAllTorches-1.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2350 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.2350

README

RefillAllTorches

Walk past your lights. They are already full.

RefillAllTorches automatically keeps every fuel-burning light source in Valheim topped up to full. By default it is completely free: no fuel items are consumed. Prefer to pay a token cost? Enable frugal mode and each refill consumes exactly 1 of the required fuel item from your inventory while still filling the light to full.

Features

  • Automatically refills all fuel-using light sources: torches, sconces, braziers, fire pits, campfires, bonfires, hearths, and seasonal lights.
  • Fuel type is read from each light source itself, so every fuel works: Resin, Greydwarf eye, Guck, Coal, Wood, and modded fuels.
  • Free mode (default): lights are topped up to full at no cost.
  • Frugal mode: each refill costs exactly 1 fuel item from your inventory and fills the light to full, no matter how empty it is.
  • Refill trigger options: always, only at half or less, or only when 1 fuel unit or less remains.
  • No simulated E press, no interaction animation, no movement interruption.
  • Works on any Fireplace-based piece, including modded ones.
  • Silent by default.

Covered light sources

Light source Fuel
Standing wood torch Resin
Standing iron torch Resin
Standing blue-burning iron torch Greydwarf eye
Standing green-burning iron torch Guck
Sconce Resin
Standing brazier Coal
Hanging brazier Coal
Blue standing brazier Greydwarf eye
Campfire Wood
Bonfire Wood
Hearth Wood
Iron Fire Pit Wood
Jack-o-turnip (Halloween) Resin

Modes and triggers

Setting Meaning
ConsumeFuelItem = false Refill for free (default).
ConsumeFuelItem = true Each refill consumes exactly 1 fuel item from your inventory and tops the light up to full.
RefillTrigger = Always Don't care, just refill whenever the light is below full.
RefillTrigger = HalfOrLess Only refill when fuel is at half or less.
RefillTrigger = OneUnitLeft Only refill when 1 fuel unit or less remains.

RefillTrigger also applies in free mode, so you can e.g. only top up lights that are running low.

Defaults

Setting Default
Enabled On
Radius 20 m (0 = every loaded light)
Check interval 1 s
Consume fuel item Off (free)
Refill trigger HalfOrLess
Refill notifications Off
Debug logging Off

Installation

r2modman / Thunderstore Mod Manager / Gale

Install RefillAllTorches from Thunderstore and launch your Valheim profile modded. BepInExPack_Valheim is declared as a dependency and will be installed automatically by the mod manager if needed.

Manual

  1. Install BepInExPack for Valheim.

  2. Copy RefillAllTorches.dll into a folder under:

    Valheim/BepInEx/plugins/

  3. Launch Valheim.

Configuration

After the first launch, edit:

BepInEx/config/Andejx.RefillAllTorches.cfg

Options:

  • Radius — check distance in meters around your character. 0 = every loaded light source.
  • CheckInterval — seconds between scans.
  • ConsumeFuelItem — false = free refills; true = 1 fuel item per refill, light filled to full.
  • RefillTrigger — Always, HalfOrLess, or OneUnitLeft.
  • Fuels.Wood, Fuels.Resin, Fuels.Coal, Fuels.Guck, Fuels.GreydwarfEye — enable/disable refilling per fuel type (all on by default).
  • NotifyWhenRefilled — center-screen message when lights are refilled.
  • DebugLogging — refill details in the BepInEx log.

Multiplayer

RefillAllTorches is intended to run on the player's client. It uses Valheim's normal networked fireplace fuel RPC, so the resulting fuel state synchronizes through standard game networking.

In frugal mode the fuel item comes from your own inventory, and lights built by other players are refilled at your expense if you walk past them. Individual servers can still restrict client-side mods through their own rules or mod-enforcement setup.

Compatibility

RefillAllTorches works on every loaded Fireplace component and reads the fuel item configured on it, so modded light sources work without being hard-coded by name. Lights flagged as infinite-fuel or non-refillable by the game are left alone.

Only light sources are ever touched. Smelters, blast furnaces, charcoal kilns, cooking stations, and other fuel-burning stations are different component types (Smelter, CookingStation) and are never scanned; modded hybrid pieces carrying both are skipped as well.

Credits

Inspired by PocketResin by zach — the client-side proximity refuelling mod whose approach this project builds on and generalises to every fuel type and light source.

Uninstall

Remove RefillAllTorches.dll from your BepInEx plugins folder. RefillAllTorches adds no custom build pieces, items, or world-save dependencies.

Development disclosure

RefillAllTorches was developed with substantial AI assistance, including code generation and review.