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

Details

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

Feylight Bloom

0.2.0 - Jack-o'-turnip bulbs

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.

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. No world data, recipes, resource costs, ownership or networking is changed. 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

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.