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.
ComfortMagicBubbles
Adjust opacity, colour and distortion of magic bubbles (Staff of Shield, Staff of Frost Orbs, Goblin Shaman shield), separately for yourself, other players and tames. Client-side only.
By KydlDev
| Date uploaded | 3 hours ago |
| Version | 1.0.0 |
| Download link | KydlDev-ComfortMagicBubbles-1.0.0.zip |
| Downloads | 8 |
| Dependency string | KydlDev-ComfortMagicBubbles-1.0.0 |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.
Preferred version: 5.4.2202ValheimModding-Jotunn
Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.
Preferred version: 2.30.2KydlDev-KydlCore
Shared runtime for all KydlDev mods: one UI root and theme, the KY hub window (F6; the one menu of every KydlDev mod) and the KY-Items category and registry.
Preferred version: 1.1.0README
ComfortMagicBubbles
Makes the magic bubbles of Valheim readable and pretty: change the opacity, colour, pattern and distortion of the Staff of Shield, Staff of Frost Orbs and Goblin Shaman shield bubbles, separately for yourself, other players and tames. Client-side: it only changes what you see.
Features
- Opacity 0-100 % per weapon (Staff of Shield, Staff of Frost Orbs, Goblin Shaman shield). The bubble's light and the Goblin smoke follow it.
- Colour per weapon and per wearer (you, other players, tames): the game's colour or your own RGB colour.
- Distortion-free switch: removes the see-through warping so you can look through the bubble without a blur.
- Reflection slider: how much the bubble mirrors the sky (100 % = the game's look). Below 100 % the game's bubble is drawn as clear glass in its colour: no light highlights.
- Patterns: the game's own look, three Stardust variants (blue, gold, violet), Clear Sky, Hex, Comb, Cage, Outline only (just the rim, nothing on the surface) and Invisible - no bubble (removes everything). Strength, speed and density can be tuned. All patterns work with colour, opacity, reflection and auto-fade.
- Auto-fade: bubbles dim by themselves (blended over half a second) when
- Crowd: 3 or more bubbled characters (players or tames, you included when you wear one) are within 20 m,
- Interior: you are inside a building or dungeon,
- Camera close: the camera is near or inside a bubble,
- Mounted: you ride a mount,
- Aiming: you draw a bow or channel a staff,
- Building: the hammer is out,
- Night: the bubble's light only, at night. Every rule has its own switch and a "fade to" percentage (default 30 %).
Shield generators and Forsaken power shields are not touched.
How to use
- Requires KydlCore (installed automatically by the mod manager).
- Open the KY hub with F6 and choose the Bubbles tab: every option above is a row there and changes apply live.
Configuration
Everything is in the Bubbles tab; the same values live in BepInEx/config/com.kydldev.ComfortMagicBubbles.cfg (or the in-game config manager):
| Section | Setting | Default | What it does |
|---|---|---|---|
| General | EnableAll | true | Switches the whole mod on / off while playing |
| DebugLog | Enable | false | Detailed lines in the BepInEx log for bug reports |
<Weapon> - Look |
Opacity | 100 | Bubble opacity in percent (one section per weapon) |
<Weapon> - Look |
Distortion-free | false | Removes the distortion of the game's bubble |
<Weapon> - Look |
Reflection | 100 | Sky reflection, 100 = the game's look |
<Weapon> - Look |
Pattern, Pattern strength / speed / density | Game's default | Surface pattern and how it looks |
<Weapon> - ... colour rows |
Use game colour, Red, Green, Blue | game colour | Colour for you, other players and tames |
| Auto-fade | Enable, Blend, <Rule> - Enabled, <Rule> - Fade to |
on, 30 % | The auto-fade rules above (Crowd also has Characters and Radius, Camera close has Start distance) |
Edits to the file are picked up while the game runs.
Multiplayer
Client-side only: nobody else needs the mod, and other players see the game's normal bubbles. Other players' and tames' bubbles are recoloured on your screen only.
Credits
The hologram-style bubble patterns are based on the Shield Shader FREE pack by SR Studios Kerala (Unity Asset Store, Extension Asset licence). The pack's source is not part of this repository; the mod ships only the compiled result.
Bug reports
Turn on [DebugLog] Enable, reproduce the problem, and attach BepInEx/LogOutput.log.

Get help and stay in touch
Questions, bug reports, ideas or mod requests? Come say hi in the KydlDev Discord: https://discord.gg/tX2CcTNC4W Everyone is welcome, and it is the quickest way to reach me. Source code and issues: https://github.com/kydlDev
CHANGELOG
Changelog
1.0.0
- Opacity, colour, distortion-free and reflection for the Staff of Shield, Staff of Frost Orbs and Goblin Shaman shield bubbles, separately for yourself, other players and tames.
- Patterns: Stardust (blue, gold, violet), Clear Sky, Hex, Comb, Cage, Outline only, Invisible - no bubble.
- Auto-fade rules: Crowd, Interior, Camera close, Mounted, Aiming, Building, Night.
- KY hub (F6) "Bubbles" tab with live changes.
- Colour rows: 'Pick colour' opens a preview; Apply saves the colour and turns 'Default color' off so it is used. A small square on each row shows the saved colour.
- Reflection below 100 % on the game's default bubble draws it as clear glass in its colour (the mod's own shader): no light highlights, no washed-out look; the reflection follows the slider, 100 % is the game's own bubble.