LightMyFire

I use AI to review code and assist with optimization and integrity; I manually test and review every mod, and all decisions and code remain my own.

Current release: 1.1.0, audited against the current governed Valheim CLIENT assemblies and Jotunn 2.30.0.

Release status

New: the Ore Chest - Valheim's reinforced chest with black ᛟᚱᛖ runes on the front. Fill it with ore and scrap and it keeps every smelter and blast furnace within 30 m loaded.

Since 1.0.4 the barrels use the game's own assets: Valheim's barrel with a small heap of the game's own Coal, Resin or Wood on the lid. Barrels already placed in your world keep working and keep their contents.

Earlier fixes still included:

• Restores real nearest-to-next barrel fallthrough when the nearest matching barrel grants only part of a light's missing fuel or has none available.
• Keeps owner-authoritative request/grant/ack/refund networking, persists outstanding reservation state in the barrel ZDO across ownership handoffs, and retains Jotunn patch-level version enforcement.
• Uses only governed /build Valheim CLIENT, BepInEx and Jotunn references for release builds.
• Dedicated/headless servers skip the client-only range marker and fuel marker while preserving the same gameplay/network barrel structure.

LightMyFire adds separate placeable Coal Barrel, Resin Barrel, Wood Barrel and Ore Chest pieces to Hammer > Misc.

Each barrel has the same 8x4, 32-slot inventory space as a black metal chest and costs 100 Wood, 40 Iron, and 40 Tar. The Coal Barrel accepts only vanilla Coal, the Resin Barrel only vanilla Resin and the Wood Barrel only regular Wood (not Fine Wood, Core Wood or other woods) - every other item is rejected. Fill one with its matching fuel and any compatible light within range gets topped up automatically on the next scan.

The Ore Chest (Valheim's reinforced chest, marked ᛟᚱᛖ in black runes) has the same 32 slots and cost. It accepts only ore and scrap that a smelter or blast furnace can use - copper, tin, iron and silver ore, copper, bronze and iron scrap, black metal scrap, flametal and gold ore, read from the game itself, so new ores from game updates are included. As long as it holds ore, every smelter and blast furnace within 30 m is refilled to a full queue whenever it is down to 2 ore or fewer, so it never runs dry (ore you add is picked up within a few seconds). Stacks are used in reading order (top-left first), so you choose what gets smelted next. Fuel still comes from a Coal Barrel or by hand.

Development note

AI-assisted tools support code analysis, optimization review, implementation refinement, and verification support.

Created and maintained by R4V9N1.

Features

• Built from Valheim's current native barrel/container prefab through Jotunn, preserving its normal network, interaction, collider and WearNTear behaviour.
• Uses only the game's own assets: Valheim's barrel, with a small heap of the game's own Coal, Resin or Wood on the lid so you can tell the barrels apart at a glance. The marker has no collider and cannot steal clicks or damage hits from the barrel.
• Coal-only / Resin-only inventories. Wrong-fuel items (and everything else) are rejected on drop, shift-click, and quick-transfer; anything that slips through by another mod's path is safely ejected next to the barrel, never deleted.
• Tops up, doesn't just refill. Partially-fueled lights are topped up to their own maximum; full lights are left untouched.
• Works with any loaded Fireplace-based light source - vanilla or modded - that burns vanilla Coal or Resin and has finite fuel capacity, with no hardcoded torch/sconce list.
• The Wood Barrel tops up campfires, iron fire pits, bonfires and hearths, plus hot tubs and stone ovens. Press Shift+E on a stone oven to switch its automatic top-up off or on (shown in its hover text; the same for every player). Trader camp fires never run out and are skipped. With InventoryLink installed, building and crafting never take wood from the Wood Barrel.
• The Coal Barrel also tops up smelters and blast furnaces (any smelting station that burns Coal). They burn 2 coal per smelt, so they are not left to the refill round: as soon as one is down to a quarter of its coal it is filled back up from the nearest Coal Barrel. Lights still come first when coal is short.
• Nearest-matching-barrel-first selection, falling through to the next-nearest barrel if one barrel can't fully cover a light's missing fuel.
• Transaction-safe multiplayer: fuel is only ever moved by the object's own owner, using request/grant/acknowledge/refund with persisted ZDO reservation metadata and timeouts so barrel ownership handoffs/disconnects recover the same refund ledger instead of losing peer-local state.
• One efficient shared scan, 5 minutes by default, plus a lightweight maintenance tick for transaction cleanup.
• Configurable feeding range (50m default) and scan interval - server-controlled, synced to every client.
• Ore Chest: keeps smelters and blast furnaces within 30 m (configurable) loaded while it holds ore, driven by the smelter's own once-per-second update with no extra scans; ore that a station cannot take, or that does not fit, stays in the chest. Hold E or Place Stacks moves all ore and scrap from your bag into it.
• Place Stacks and holding E on a barrel move all of its fuel from your bag, even when the barrel is empty.
• A thin white dotted range ring marks the exact feeding-radius circumference while placing a barrel and while that barrel inventory is open. There is no filled area marker.
• Works in single-player and multiplayer.
• Compatible with Terramizer, TerramizerServer, EquipmentSheet, and InventoryLink 0.2.6 or newer.

Installation

Install LightMyFire and Jotunn on the server and every connecting client. LightMyFire uses patch-level network version matching, so server and clients should run the same LightMyFire version.

Configuration

Config file:

BepInEx/config/r4v9n1.lightmyfire.cfg

Enabled, feeding range, the refill interval and the [OreChest] range (30 m) are set by the server/host and synced to clients; a client's local values for those are overridden. LogTransfers and LogDiagnostics are local-only. Enable LogDiagnostics while troubleshooting to see barrel readiness and scan counts.