WispTorchHeeler

WispTorchHeeler

Tiered Mistlands wisp torches and demister lamps with expanded mist clearance, interactive torch painting, body-worn Wisplight customization, and multiplayer color synchronization.

> [!NOTE] > Client & Server Required: In multiplayer, install the mod on the server and every client at the same version. Single-player needs no server install.

The Problem

In native Valheim, clearing the thick mist of the Mistlands requires placing dozens of small, fragile native wisp torches in close proximity. This creates:

• Severe Visual Clutter & Construction Fatigue: Expansive Mistlands bases, farms, and transit paths quickly devolve into chaotic thickets of sticks.
• Performance Overhead: Dozens of overlapping particle system force fields, dynamic point lights, and particle emitters ticking simultaneously cause noticeable framerate drops.
• Rigid Aesthetics: Builders are locked into a single fixed cyan/white color palette that cannot be customized to fit different build themes, architectural styles, or interior moods.
• Fragility: Native torches possess only 200 HP (I was previously incorrect, the base game torch has 200 health, not 100), breaking easily from collateral combat damage, seeker attacks, or stray dvergr fire.

The Solution

WispTorchHeeler introduces four tiered, late-game Mistlands lighting installations with progressively larger mist-clearance radii alongside an interactive, crosshair-driven "Torch Painter" system and multiplayer color synchronization via Valheim's native Zero Data Object (ZDO) architecture:

• Tiered Mist Clearance: Four distinct lighting fixtures ranging from reinforced large torches to colossal dwarven monuments, clearing up to 3.75x the fog radius (~14x coverage area) to reduce piece density and visual clutter.
• Interactive Torch Painter: Aim at a torch or lamp from this mod, or a base game mist torch with AffectNativeMistTorches on, and press P to paint its light and particle effects with your chosen color, or LeftShift + P to reset it.
• Auto-Paint on Placement: Newly placed torches and lamps can automatically inherit your active painter color the instant you build them.
• Body-Worn Wisplight Customization: Full cosmetic customization for your equipped Wisplight accessory (the floating demister_ball follower orb), including custom color, light and emission intensity multipliers, alpha transparency, and multiplayer color sync.
• Multiplayer & Server-Synchronized: Painted colors are stored on each piece, so every player with the mod sees them. Unpainted pieces use client-chosen defaults or server-enforced color themes, with ward-protection permissions and admin overrides.
• No Asset Bundles: Pieces are cloned from base game prefabs at runtime using Jotunn.
• Recipe Editor: Edit recipes in Configuration Manager with item and amount rows. Borrowed from Searica.

Features

Tiered Lighting Installations