Immersive Auto Fuelers 1.1.0

Keep your fires and lights burning with three decorative fuel containers. Store fuel inside, and they automatically refill supported nearby items with matching fuel.

Buildable pieces

All three require a Forge, have six inventory slots (3 x 2), and default to a 12-meter radius.

The rack does not fuel kilns or rams. The scuttle does not fuel smelters or blast furnaces. Unrelated stored items are not consumed.

Features and controls

• Placement displays a white ground circle showing the configured range.
• A connection tab lists supplied targets and current burn rates per real-life hour.
• Hover text identifies the supplier. Shift + E toggles auto fueling on a supported target.
• Fueling checks run approximately every five seconds and pause while the supplying inventory is open.
• Targets must be loaded. Discovery and ownership settling can delay initial refilling.
• Overlapping compatible containers select the nearest supplier. An empty nearest supplier does not fall back to a farther container.
• Breaking a piece returns recipe materials and remaining contents through vanilla destruction behavior, subject to vanilla world settings. Already consumed fuel is not returned.

The burn-rate display estimates fuel burning, rather than measuring withdrawals. Filling existing shortages can consume several items together even when the hourly burn rate is low.

Requirements and installation

Requires BepInEx 5 for Valheim. Configuration Manager is optional; Jotunn is not required.

Install through Vortex or a compatible mod manager. For manual installation, close Valheim and place the plugin DLL at:

BepInEx/plugins/ImmersiveAutoFuelers/ImmersiveAutoFuelers.dll

Keep only one installed copy. Install the same version on every client and the host or dedicated server.

Configuration

Use Configuration Manager or edit:

BepInEx/config/camde.valheim.immersiveautofuelers.cfg

Each piece has its own build-menu toggle and radius setting (1-128 meters). Multiplayer uses server radius and build-menu settings. Hiding a recipe leaves existing placed pieces functional.

Languages

The mod follows each player's selected Valheim language, independently in multiplayer. Names, descriptions, hover instructions, connection labels, consumption-rate units and Configuration Manager labels/tooltips are localized. Changing the game language refreshes the mod text without changing saved pieces or configuration keys.

English and 34 other Valheim language slots have complete custom UI strings: Swedish, French, Italian, German, Spanish, Russian, Romanian, Bulgarian, Macedonian, Finnish, Danish, Norwegian, Icelandic, Turkish, Lithuanian, Czech, Hungarian, Slovak, Polish, Dutch, European Portuguese, Brazilian Portuguese, Simplified Chinese, Traditional Chinese, Japanese, Korean, Hindi, Thai, Croatian, Georgian, Greek, Serbian, Ukrainian and Latvian.

Abenaki: uses Valheim's existing Abenaki item/building terms where available, with an explicit English fallback for new mod-specific phrases. A fluent Abenaki contributor is needed before those phrases can be called translated.

Existing game translations take priority for vanilla fuels and buildings, with additional popup labels where the game's community translations are incomplete. Custom translations are written in context and checked for missing text and format placeholders; they have not all been reviewed by native speakers. Please report awkward wording with the language, screenshot and suggested correction.

Internal prefab IDs, saved item identities, RPC names and config section/key identifiers remain stable. Diagnostic log types and connection identifiers remain in English for cross-player comparison. The optional Configuration Manager interface uses localized display names; its underlying config-file keys remain the existing identifiers.

Diagnostic logs and reporting issues

Logging is enabled by default for all three containers. Disable locally under Diagnostics > Enable diagnostic logs, or set:

[Diagnostics]
Enable diagnostic logs = false

Each client/server records its own files in:

BepInEx/ImmersiveAutoFuelers-Logs

Inventory and fueling logs have timestamped filenames. Restarting creates a new session. Total managed diagnostic storage is capped at 50 MiB (approximately 50 MB); older completed pairs are removed as needed, with no age limit. Long sessions rotate into smaller pairs.

If fuel unexpectedly disappears, duplicates, or fails to refill:

1. Note the approximate time and what happened, then exit normally if possible.
2. Copy and ZIP the entire diagnostic logs folder.
3. Include BepInEx/LogOutput.log and the mod's config file.
4. Send the archive or a download link to GlobalFriction with your issue report.

For multiplayer, collect the host/server and affected players' files and label each archive. Copy promptly: ordinary LogOutput.log may be overwritten on restart, and diagnostic files rotate when storage fills. Logs include player names/IDs, world identifiers and positions; share privately if preferred.

Multiplayer safeguards

Includes ownership settling, elapsed-burn handling before fireplace refills, immediate fireplace deposit verification, and protection against rapid repeated fireplace withdrawals. Diagnostic logging supports continued investigation; these safeguards are not a guarantee against every multiplayer synchronization issue.

Credits

By GlobalFriction. Uses Valheim materials and item visuals with custom model geometry. Build-menu icons and promotional illustrations were created with AI assistance.

Source build and validation

Run Build.ps1 -ValheimPath <your Valheim folder>. All translation strings are embedded from UTF-8 Translations.tsv; no additional runtime localization mod is required.

Test-Localization.ps1 runs 2,709 catalog, formatting, token-refresh and Configuration Manager adapter checks using engine/API stubs. Test-Rules.ps1 runs 343 isolated fuel-rule checks. Test-LogStorage.ps1 runs 16 real filesystem retention checks. These tests do not simulate the Unity renderer or a multiplayer session. This release's multilingual fonts and layouts still need visual verification in-game.

Changelog

1.1.1

• Fixed repeated HarmonyX warnings when optional Configuration Manager is not installed, including on dedicated servers.
• Optional configuration integration waits quietly for the plugin and caches unsupported integration attempts instead of retrying them continuously.
• Fixed automatic-fueling supplier text and enable/disable hints reverting to English after other mods load temporary localization instances.
• All three fuelers keep their hover text in the player's selected Valheim language; auxiliary localization dictionaries retain their own language.
• Preserves saved pieces, inventories, configuration keys, fuel rules and models.

1.1.0

• Automatically follows each player's selected Valheim language, including live language changes.
• Localizes piece names/descriptions, hover instructions, connection names, burn-rate labels and Configuration Manager labels/tooltips.
• Adds complete custom UI text for English and 34 other game languages; reuses native translations and supplements missing vanilla popup terms.
• Abenaki uses existing game translations with an explicit English fallback for new mod-specific phrases pending fluent review.
• Supports localized number formats and uses the native UI font for popup labels.
• Preserves saved piece IDs, config keys, fuel rules and diagnostic identifiers.
• Translation templates, native token refresh and config adapters pass 2,709 automated checks; in-game multilingual layouts still need visual verification.

1.0.3

• Caps managed diagnostic logs at 50 MiB with no age limit.
• Rotates inventory/fueling pairs at approximately 5 MiB combined.
• Removes oldest completed pairs while protecting active/locked files.
• Logging remains enabled by default and can be disabled in config.

1.0.2

• Adds separate inventory/fueling diagnostic files for all three fuelers.
• Records item movements, ownership changes, supplier/target IDs, connection counts and later deposit checks.

1.0.1

• Adds multiplayer ownership settling and elapsed-burn safeguards.
• Verifies fireplace deposits and restores inventory on failed transfers.
• Adds a shared fireplace refill timestamp and BepInEx transfer logging.

1.0.0

• Initial release with Firewood Rack, Lamplighter's Barrel and Brazier Scuttle.