Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
FeylightBloom
Fey garland glow, illumination, five lighting modes, optional Jack-o'-turnip bulbs and easier normal hammer dismantling.
| Date uploaded | 2 weeks ago |
| Version | 0.2.2 |
| Download link | SmeagsMods-FeylightBloom-0.2.2.zip |
| Downloads | 93 |
| Dependency string | SmeagsMods-FeylightBloom-0.2.2 |
This mod requires the following mods to function
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.2351README
Feylight Bloom
Package 0.2.2 - Updated icon
This is an icon-only package update. The tested DLL is byte-identical to 0.2.1 and still reports runtime version 0.2.1. Features, dependencies and validation limitations are unchanged.
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.
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
/feycommand and/feylightbloomfallback. - 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.