You are viewing a potentially older version of this package. View all versions.
SmeagsMods-FeylightBloom-0.2.0 icon

FeylightBloom

Client-local fey garland glow, illumination and reach controls, five gentle modes, and optional nearby individual or vanilla Jack-o'-turnip bulbs.

Date uploaded 2 weeks ago
Version 0.2.0
Download link SmeagsMods-FeylightBloom-0.2.0.zip
Downloads 32
Dependency string SmeagsMods-FeylightBloom-0.2.0

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2351

README

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.

CHANGELOG

Changelog

0.2.2 - 2026-10-30

  • Replaced the package icon with the approved year-round flower, mossy wood and cyan-glow artwork, with a gold Feylight Bloom title.
  • Icon-only package update: the tested 0.2.1 DLL is unchanged and continues to report runtime version 0.2.1. No feature, dependency, license or gameplay changes.

0.2.1 - 2026-10-30

  • Fixed hard-to-target vanilla garlands: normal hammer removal and hover can now target modeled bulbs and visible cord, in addition to the native endpoints.
  • Kept native reach, obstruction, workbench, ward, piece-removal, ownership routing and refund behavior. No added physical colliders or placement/support changes.
  • Bounded supplemental picking to the nearest 32 strings within 16 m, with a shared cached mesh search. Others retain endpoint targeting.
  • Added default-on Interaction / HammerTargeting config; turning it off or disabling/unloading the plugin restores native picking. The Vanilla panel button still resets visuals only.
  • Verified native and turnip visuals, all modes/scopes, damage variants, denied-removal cases, exact refunds, dense limits, UI regressions and restart/unload. Physical-input and real multiplayer tests remain unrun.

0.2.0 - 2026-10-30

  • Added a default-off Jack-o'-turnip bulbs checkbox for the nearest eight strings within 20 m; farther strings retain native fey bulbs.
  • Preserved the native turnip body/material and added a small original glowing interior. Faces and lid openings glow warm orange-yellow, and the existing scene light uses the same warm color. No extra emitters or network/build objects.
  • Retained Glow, Illumination, Reach and all five modes in whole-string and individual scopes. Native floating cyan particles remain unchanged.
  • Added shared combined geometry and restoration for toggle-off, Vanilla, disable, distance exit and unload; safe fallback for missing/unsupported assets.
  • Reused the approved checkbox artwork within the existing 640x600 panel; verified layout and Apply/reset paths at two resolutions.
  • Added small fixed yaw variations up to 10 degrees so turnips face slightly different directions while staying forward. Stable after reload; no extra geometry, draw submissions or per-frame randomness.
  • Validated the final DLL with ten 12-second visible-window mode/scope recordings through actual panel Apply handlers, variants, bounds, dense limits, fallback, actual restart and unload. Physical input, controller navigation and real multiplayer remain untested.

0.1.1 - 2026-10-26

  • Fixed animated modes appearing almost steady at brighter Glow settings: the previous 45-65% minimum emission kept bulbs bright throughout their cycles. Deepened the smooth dim phases while preserving the selected peak Glow and native hue.
  • Gave Firefly Dance more separated soft twinkles and Wisp Waltz a clearer traveling band. Hearthglow remains steady; mode timing, UI, nearby caps and geometry are unchanged.
  • Added unforced 12-second native image sequences and per-frame telemetry for all animated modes in both scopes, including the reported brightness settings. Rechecked UI, density limits, reset, restart and unload.

0.1.0 - 2026-10-26

  • Initial standalone client-local Feylight Bloom release candidate.
  • Separate Glow, Illumination and Reach controls with preserved native colors and a Vanilla reset.
  • Five modes: Hearthglow, Moonbreath, Firefly Dance, Wisp Waltz and Starlit Shimmer.
  • Optional genuine individual-bulb effects on the nearest eight strings within 20 m; whole-string fallback elsewhere.
  • Reuses the native shadowless light, with a 24-light nearby cap and native quality limits.
  • Collision-aware /fey command and /feylightbloom fallback.
  • Approved original druid panel, title, buttons, sliders, checkbox and icon; UI textures embedded in the DLL.
  • Private native validation covers reset, variants, distance limits, dense strings, restart, unload and injected UI paths. No publication or live installation.