Valheim
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
Downloads
229
Size
730KB
ADDatHost Valheim hosting
30% off

Feylight Bloom

0.2.1 - Easier garland dismantling

A small, standalone Valheim mod for native fey light garlands, with an original druid-themed control panel. Adjust their visible glow, actual illumination and lighting patterns on your own client. Built against Valheim 1.0.20 and BepInEx 5.4.23.5.

Controls

Open /fey in chat. If another mod already registered that command, use /feylightbloom. Existing registrations are never overwritten. If both are occupied, the mod logs the conflict and settings remain available in the config file. Mods that intercept chat independently may still conflict.

  • Glow: 0–4x, default 1.35x. Controls visible bulb emission. Native fey bulbs retain their cyan hue; selected Jack-o'-turnip interiors glow warm orange-yellow.
  • Illumination: 0–4, default 2. Controls the existing shadowless point light independently from Glow. Zero disables scene illumination while the mod is active.
  • Reach: 1–8 m, default 4 m. Controls that light's range.

Apply saves staged choices. Cancel, x, and Escape discard them. Vanilla disables enhancement, clears both nearby-option checkboxes, and restores captured native visuals and light settings. The panel uses the existing input-blocking behavior while open and scales down to fit the window.

Five lighting modes

  • Hearthglow: steady illumination.
  • Moonbreath: a slow, smooth pulse.
  • Firefly Dance: separated, gentle twinkles.
  • Wisp Waltz: a phased wave between strings, or a traveling band along individually controlled bulbs.
  • Starlit Shimmer: overlapping gentle fades.

Animated glow has deep dim phases while retaining the selected peak Glow. Scene illumination varies more gently. Phases are stable by position within a client and are not synchronized between clients.

Individual bulbs (nearby) is off by default. It independently animates the twelve modeled bulbs on up to eight nearest strings within 20 m. Other strings retain whole-string effects. Hearthglow is steady in either scope. Native fey bulbs use their original unsplit mesh for steady/whole-string settings.

Jack-o'-turnip bulbs

The new Jack-o'-turnip bulbs (nearby) checkbox is also off by default and is independent of Individual bulbs. It replaces the twelve modeled bulbs with miniature vanilla Jack-o'-turnip shells on the nearest eight strings within 20 m. Farther strings retain native fey bulbs and their original colors.

The native pink-and-white body, texture and material are preserved—no orange paint. A small original interior surface glows through the carved face and open lid gap. The garland's existing point light also becomes warm orange-yellow. Glow, Illumination, Reach and all five patterns continue to work. Each turnip has a small fixed forward-facing rotation variation, stable across reloads. Native floating cyan particles are unchanged.

Turning the checkbox off restores native bulb geometry and light color. Missing seasonal assets or unsupported mesh layouts fall back safely. The mod uses game assets already loaded by Valheim; it does not ship extracted assets, create additional build pieces or add per-bulb lights.

Normal hammer dismantling

Vanilla garlands are removable, but only two tiny endpoint colliders accept the hammer ray. This update lets you aim at a modeled bulb or the visible cord to dismantle the garland through the normal hammer action. It works with native bulbs, individual effects and Jack-o'-turnip visuals.

The nearest 32 garlands within 16 m receive supplemental targeting; native hammer reach is still enforced. Other garlands keep vanilla endpoint targeting. Walls and nearer objects block the target normally. Workbench requirements, wards, piece-removal restrictions, ownership routing and resource refunds remain handled by Valheim. No physical colliders, support geometry or placement rays are changed.

The config setting Interaction / HammerTargeting defaults to true. Set it to false to restore endpoint-only picking. The panel's Vanilla button resets lighting and bulb visuals; it leaves this separate hammer convenience enabled. Disabling or removing the plugin restores native picking.

Scope and cost

Settings are local to the BepInEx profile and apply to existing and new verified native piece_FairylightGarland instances. Other clients may choose different settings. Lighting choices do not edit world data. Hammer dismantling still removes the piece through Valheim's normal world/network operation; the mod changes only which part can be targeted. Recipes, costs, ownership and network rules are unchanged. The design requires no server installation; real multiplayer has not been tested.

The mod reuses one native point light per string and adds no light emitters. Up to 24 nearest fey lights within 32 m are eligible, with native LightLod quality prioritization still applied. Animated glow is limited to 64 strings within 40 m; farther strings use steady selected glow. Cached registrations are selected every half-second. Global discovery occurs only at startup/enable, not every frame.

Native individual bulbs use a shared 13-part derivative of the original 1,100-vertex/1,424-triangle mesh, adding up to 12 draw submissions per string per rendering pass. Turnip strings use shared combined geometry: 7,340 vertices and 8,864 triangles, with 3 material slots in whole-string mode or 14 in individual animated mode. Across eight strings, that can add 16 or 104 draw submissions per pass relative to unsplit native garlands. The two turnip meshes contain about 811,008 raw vertex/index bytes before Unity overhead, in addition to the native bulb-partition cache.

These caps bound the added work; they do not guarantee FPS. Native graphics settings may reduce actual illumination. Mods replacing the garland hierarchy or editing the same materials, property blocks, lights or input handling may conflict. Reset, disable and unload restore captured originals and release owned additions/caches.

Installation and dependencies

Only BepInEx 5 is required. Harmony is supplied with the loader. No other mod is required.

Use a Thunderstore-compatible mod manager, or place its plugins/FeylightBloom/FeylightBloom.dll in your profile's BepInEx/plugins/FeylightBloom folder. UI artwork is embedded. Settings are stored in BepInEx/config/smeagsmods.feylightbloom.cfg. Removing the DLL requires no world cleanup or migration.

Developers can build with the .NET SDK, .NET Framework 4.8 reference assemblies and local game/loader references using dotnet build FeylightBloom.csproj. Output is artifacts/production/FeylightBloom.dll.

Validation

Version 0.2.1 additionally passed private native hammer-removal, refund, ward, station, reach, occlusion, dense-target cap, damage-state, disable/unload and actual restart checks. Existing lighting and two-resolution UI regressions passed on the same final DLL. See TESTING.md for exact evidence and limitations.

Validated privately against Valheim 1.0.20: all five modes in both scopes through the actual selector/Apply path, 490 normal-window temporal screenshots, the updated UI at 1280x720 and 960x540, native glow/illumination separation, damage variants, bounds, nearby caps, fallback, reset/disable, actual save/restart and active unload. Fixed turnip rotations remain stable after restart. Approved UI artwork is unchanged.

Tests used injected native GUI events and disposable local saves. Physical keyboard/mouse input, controller navigation, real multiplayer, arbitrary modpacks and other game versions have not been tested. CPU observations are not FPS/GPU benchmarks. No gameplay-profile installation or publication occurred during testing.

License and feedback

Original code and supplied project artwork are MIT, copyright (c) 2026 SmeagsMods, to the extent rights apply. See LICENSE and THIRD-PARTY-NOTICES.md. Game assets and runtime dependencies are not redistributed.

Feedback and bug reports on Discord.

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.