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 Compatibility: This mod is safe to install on local clients and runs cleanly on dedicated servers with zero desyncs and server-enforced policies. For custom pieces in multiplayer, both client and server require the mod.

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 100 HP, 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.75× the fog radius (~14× coverage area) to drastically reduce piece density and visual clutter.
• Interactive Torch Painter: Aim at any placed torch or lamp and press P to instantly 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: Stamped directly into each piece's ZDO at creation with zero desync. Unpainted pieces can inherit client-chosen defaults or server-enforced color themes, with ward-protection permissions and admin overrides.
• Zero Asset Bundles: Cloned cleanly from native Valheim prefabs at runtime using Jötunn, ensuring instant load times and lightweight installation.

Features

Tiered Lighting Installations

• Tier 1 — Large Wisp Torch (piece_wisptorch_heeler_lg):
• Cloned from the native wooden wisp torch and scaled physically by 1.25x.
• Mist Clearance: 1.50× radius (relative to 24.0m baseline: 36.0m radius, ~2.25× coverage area).
• Light: 1.33× intensity and 1.25× range (12.5m light radius).
• PlayerBase: 20.0m base spawn suppression (scales with PlayerBaseMistRadiusBonus).
• Durability: 200 HP and immune to weather decay.
• Crafting: Placed freeform with the building hammer (Wisp:8,YggdrasilWood:5,Sap:1).

• Tier 2 — Small Lamp (piece_wisplamp_heeler):
• In-game Name: Dvergr Wisp Lamp
• Adapts the native Dvergr Demister prop at natural 1.0x scale.
• Mist Clearance: 2.25× radius (relative to 24.0m baseline: 54.0m radius, ~5.0× coverage area).
• Light: 1.50× intensity and 1.50× range (15.0m light radius).
• PlayerBase: 20.0m base spawn suppression (scales with PlayerBaseMistRadiusBonus).
• Durability: 250 HP and immune to weather decay.
• Crafting: Requires a Forge (Wisp:15,Copper:5,Iron:2,BlackMarble:2,Sap:2).

• Tier 3 — Large Lamp (piece_wisplamp_heeler_lg):
• In-game Name: Large Dvergr Wisp Lamp
• Cloned from the large Dvergr demister model and scaled u