Fire Salts

Turn a quiet evening by the fire into a small light show. Craft fantasy salts and use one on a burning campfire, hearth or bonfire for 30 seconds of colored flame, crackles and short bursts of sparks.

The fire show adds no fuel, damage, warmth bonus or terrain changes. Version 0.2.2 also grants a Rested-linked utility blessing when you sit beside an active salted fire. The original fire returns to normal when its 30-second show expires or the fire goes out.

0.2.2 stability hotfix

Keeps blessing templates alive while their native status effects use them, fixing an unsafe object lifetime during blessing activation and HUD display. Recipes, buffs, Rested timing, visuals and audio are unchanged. Test in an isolated profile before updating a group; matching versions are recommended on all peers.

Crafting

Use a sheltered level 1 workbench and its Craft tab. Every recipe makes 3 salts.

Discover the workbench and pick up each ingredient to unlock its recipe. Craft the component salts to discover the three blends. Recipes do not appear in hand crafting or the Upgrade tab. These are fantasy recipes, not instructions for real fire additives.

Using a salt

1. Put salts in a hotbar slot.
2. Look at a burning campfire, hearth or bonfire until its normal interaction prompt appears. Stay within normal interaction reach.
3. Press the salt's hotbar key. Success consumes exactly one salt and starts the 30-second effect.

Unlit, unsupported and already-colored fires keep your salt. Looking away or standing too far away also keeps it. Remote-owner use can take a moment; keep looking at the fire while it completes. A cancelled or expired request spends nothing. Inventory right-click does not apply salts to the world.

Native drag/drop remains an optional physical toss. Missed items can be recovered manually; automatic pickup is disabled. A dropped stack can consume only one item per fresh toss. This optional route still depends on native physics.

Only one salt effect can occupy a fire. Native fuel, smoke, shelter and weather rules still apply. Torches, braziers, smelters and other fire types are unsupported.

Seated fire blessings (0.2.1)

Sit continuously for 10 seconds within 4 metres of a burning, actively salted campfire, hearth or bonfire. Standing, leaving range or changing to another reaction resets the unfinished sitting timer. A blessing requires Rested. Once earned, its remaining time follows your actual Rested timer, including after you stand up or leave the fire. An 8-minute Rested timer means an 8-minute blessing; higher comfort can extend both. Refreshing or shortening Rested adjusts the blessing, and losing Rested ends it. If you are not yet Rested after 10 seconds, remain seated beside the active salted fire until native Rested applies. The mod never grants or extends Rested itself. Only one Fire Salts blessing can be active; a new one replaces the previous blessing rather than stacking.

A reaction grants each player at most one blessing. Remaining seated does not award it again, and standing/re-sitting cannot reroll Prismatic. Native Rested refreshes can still extend an already-earned blessing. A newly salted reaction can grant a new blessing. A removed/expired blessing does not return merely because Rested returns; earn a new one from a newly salted reaction. Blessings are not saved across logout/death and do not add comfort or alter Rested duration.

Cinderblend requires the full initial swing cost; it returns stamina only after eligible resource contact. Air swings, combat contact, structures, under-tier tools, terrain digging and destructible stumps receive no return. A swing can return stamina once even if it hits several resources. Remote resource contact is checked locally; it is not a promise of confirmed resource damage on another machine. Native fuel/weather rules still decide whether the fire is burning.

Bonuses to base costs/healing follow native status-effect composition, so their final percentage alongside Rested or other mods can differ. All players should use the same mod version. Test in an isolated profile/world before adding the update to a group game.

Installation

Fire Salts is standalone. Its only mod dependency is BepInExPack Valheim 5.4.2351. Import the direct Fire Salts package with your mod manager and launch modded from that profile. For manual installation, copy BepInEx/plugins/FireSalts/FireSalts.dll into your BepInEx profile.

Keep exactly one Fire Salts DLL installed. The old 0.1.0 private playtest/source bundle contained a nested archive and did not install correctly when imported as a mod. Replace that outer bundle with the direct package.

If recipes are missing, confirm the log says Loading [Fire Salts 0.2.1], use the workbench's Craft tab, discover the ingredients, and clear crafting filters. A ZIP sitting inside BepInEx/plugins is not an installed plugin.

Sound and settings

The opening uses the first 1.25 seconds of a licensed ignition recording. A separate crackle recording supplies the ongoing sound, with spark bursts timed to its uneven attacks. The track repeats once as needed to fill the shared 30-second effect and fades at the end. Late arrivals join the current phase instead of replaying the ignition.

Local settings live in BepInEx/config/smeagsmods.firesalts.cfg:

• Visuals: temporary colors and particle effects.
• Sound: decorative audio within 12 metres.
• Volume: salt audio gain from 0 to 1; default 0.70.

At most eight nearby fires within 32 metres render per client. Each rendered fire adds at most 24 particles across four emitters, one audio source and no lights. There are no flashing color changes. Under a severe frame stall, missed spark cues are skipped rather than emitted in a catch-up shower.

Native smoke particle colors, light intensity/range and fire emission rates remain unchanged. Colored fire light can illuminate smoke, and previously emitted native particles can retain their tint for their normal lifetime. Other mods changing the same fire materials may conflict.

Verification and multiplayer

See TESTING.md for the checks performed on this candidate. Automated private-world tests use native hover rays, item-use routing and crafting controls with programmatic input. They do not prove physical keyboard/mouse usability or human acceptance of audio balance.

Real multiplayer and dedicated-server behavior remain unverified. Use the same version on every participating client and server when testing. A remote fire owner grants a short reservation and ownership transfer; the requesting player rechecks reach, target, ownership, burning state and inventory before consuming one item. Shared salt identity and start time determine color phase and expiry. Single-process ownership and late-arrival simulations are not remote networking tests. There is no version handshake, and a process failure between item consumption and state publication can lose an effect.

Remove mod items from inventories, containers and ground drops before uninstalling. Back up saves and begin with a disposable world when evaluating this candidate. Dropped world items remain tinted native resin models; the inventory art and cover are separate original artwork.

Original code is MIT licensed. Licensed audio is embedded for use within Fire Salts and is not covered by MIT or licensed for extraction/reuse. Native game assets are referenced in memory and are not redistributed. See THIRD-PARTY-NOTICES.md.

Support

Questions, feedback and screenshots: SmeagsMods Discord.

https://discord.gg/bfbb4yY6pt

Changelog

0.2.2

• Fix unsafe blessing-template destruction: native status effects shallow-clone their templates, so templates now remain alive while effects use them.
• Reuse a bounded cache of eight grantable blessing templates and clean up at plugin teardown.
• Add repeated Roseember/HUD and native-object-lifetime regression coverage.
• No recipe, strength, Rested-timing, visual or audio changes.
• This addresses a verified lifetime defect; the reported crash was not reproduced in the isolated baseline, and full mod-stack compatibility is not established.

0.2.1

• Seated blessings now follow the actual remaining Rested timer rather than a fixed 60 seconds.
• Native Rested refreshes, shortening and removal adjust/end the blessing; no Rested means no blessing.
• Keeps the 10-second seated ritual, one-blessing limit and once-per-reaction Prismatic choice.
• Does not alter native comfort, Rested duration, salt consumption, fire visuals, audio or bonus strengths.

0.2.0

• Add approved utility blessings after 10 continuous seated seconds within 4 m of a burning salted fire; 60-second duration and one blessing at a time.
• Add native food-healing, sneak, fall, home-tool stamina/durability and dry-timer effects with modest documented values.
• Add resource-contact stamina return for Cinderblend, excluding combat-contact swings and requiring the full initial cost.
• Prismatic grants one solid-color blessing per reaction; no standing/re-sitting rerolls or indefinite refresh.
• Preserve existing nine recipes, single-item consumption, 30-second visual/audio reactions and approved/ licensed assets.
• All peers should update together; use an isolated test profile/world first.