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