You are viewing a potentially older version of this package. View all versions.
KydlDev-ComfortMagicBubbles-1.0.0 icon

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-5.4.2202 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2202
ValheimModding-Jotunn-2.30.2 icon
ValheimModding-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.2
KydlDev-KydlCore-1.1.0 icon
KydlDev-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.0

README

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.


KydlDev

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.