You are viewing a potentially older version of this package. View all versions.
Aquark-ResinFire-1.0.0 icon

ResinFire

Hanging braziers, standing braziers and iron fire pits burn resin instead of coal, and refill themselves from containers within 30 m. Server-side.

By Aquark
Date uploaded a day ago
Version 1.0.0
Download link Aquark-ResinFire-1.0.0.zip
Downloads 20
Dependency string Aquark-ResinFire-1.0.0

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

README

ResinFire

Two quality-of-life changes for the three coal-fired braziers:

  1. Resin instead of coal — Hanging Brazier (piece_brazierceiling01), Standing Brazier (piece_brazierfloor01) and Iron Fire Pit (piece_firepit_iron) burn Resin.
  2. Automatic refill — every few seconds the braziers pull resin out of any container within 30 meters and top themselves up. No more manual feeding.

Install

  • Install BepInExPack Valheim (handled automatically by r2modman).
  • Drop ResinFire.dll into BepInEx/plugins/.
  • The server needs it. The refill logic runs on the server. Clients should have it too, so the fuel item and hover text match.

Config

BepInEx/config/snowfarm.valheim.resinfire.cfg:

Section Key Default Meaning
1 - General Enabled true Master switch
2 - Fuel FuelItem Resin Item prefab burned by the three braziers. Coal restores vanilla
3 - Auto refill Prefabs piece_brazierceiling01,piece_brazierfloor01,piece_firepit_iron Which pieces get the new fuel + auto refill
3 - Auto refill Radius 30 Container search radius (m)
3 - Auto refill Interval 5 Seconds between checks

How it works

  • The fuel item is replaced on the prefab, so every brazier (existing ones after an area reload, new ones immediately) accepts resin.
  • Refill reads the fire's fuel from its ZDO and writes it back after taking resin out of nearby containers. One resin = one fuel unit, exactly like vanilla.
  • Braziers that the player switched off are left alone; only burning ones are topped up.
  • Containers that a player currently has open are skipped (their owner is the client), they get refilled on a later pass.

Notes

  • Only affects those three prefabs; campfires, hearths, fire pits and bonfires are untouched.
  • Fuel already in a brazier keeps its value; the item type is what changes.
  • Removing the mod does not corrupt anything: braziers will simply refuse new resin and go back to accepting coal.

中文说明

吊盆火炉、火盆、铁火盆这三种烧煤的照明建筑改为烧树脂,并且每 5 秒自动从 30 米内的箱子/储物建筑里 取树脂补满,不用手动加燃料。服务器必须装(补料逻辑跑在服务端),客户端也建议装(燃料图标和悬浮文字一致)。 配置可以改燃料物品、范围、间隔和目标建筑。

Build

dotnet build -c Release -p:ValheimDir="C:\Program Files (x86)\Steam\steamapps\common\Valheim"

or run pack.ps1 to build and produce ResinFire.zip for Thunderstore.

CHANGELOG

Changelog

1.2.1

  • Fixed auto refill doing nothing when a player had opened the resin chest: opening a container moves ZDO ownership to that player, so the server-side loop could not use it. The server now claims ownership of the container (unless somebody has it open) and of the fireplace itself before refilling.
  • Added a Verbose diagnostic option that logs a per-cycle summary and the reason each fire was skipped (no containers in range, no Resin in range, switched off, fire not owned, ...).
  • Logs once when the plugin is loaded on a non-server peer, because refill only runs on the server.

1.2.0

  • Added the coloured light sources to the fuel change: Blue Standing Brazier (piece_brazierfloor02), Standing Blue-burning Iron Torch (piece_groundtorch_blue) and Standing Green-burning Iron Torch (piece_groundtorch_green) now burn resin instead of Greydwarf Eyes / Guck.
  • The same three pieces are also auto-refilled now, so the refill list covers eight pieces.
  • Startup log now prints what each piece burned before it was changed.
  • Configs upgrading from 1.1.0 get the new default prefab lists once, unless they were edited by hand.

1.1.0

  • Fuel replacement and auto refill are now two separate prefab lists.
  • Default fuel list is only the two coal braziers: Hanging Brazier and Standing Brazier. The Iron Fire Pit is no longer touched (it burns wood and its prefab id did not resolve).
  • Auto refill now also covers the Sconce (wall torch) and the standing torches.
  • Refill pulls whatever item each piece actually burns, instead of always looking for resin.
  • Fuel item is also applied per instance on Awake, so pieces spawned before the prefab patch and prefabs with the component on a child object are covered too.

1.0.0

  • Initial release.
  • Hanging Brazier, Standing Brazier and Iron Fire Pit burn resin instead of coal.
  • Automatic refill from containers within 30 m (configurable radius / interval / prefabs).