Valheim Bubble

Press one key to cast a protection bubble without opening your inventory.

1. The mod notes what is in your hands, down to the exact item.
2. It equips the Staff of Protection from your inventory.
3. It casts the staff. The game's own shield covers you and every ally in range.
4. It puts your previous weapon (and shield) back, including holstered weapons.

Your armor is never touched.

A countdown under the status-effect icons shows the time left on your bubble, whoever cast it. A chime plays 5 seconds before the bubble runs out, so you can recast in time. When it runs out or breaks, the countdown flashes "Bubble down!".

When your Eitr food has worn down so far that your Eitr bar can't hold two more bubbles, a different chime plays and "Low Eitr - eat!" shows in the centre of the screen. It plays once, and is ready again after you eat.

Food warning: each food's health and stamina fade as it wears off. When a health or stamina food has faded to half its full value (about the last 10% of its time), a rising chime plays and the centre of the screen says, for example, "Low Health - eat! Cooked meat is wearing off". Each food warns once, and again after you eat it again.

Client-side only. Nothing needs to be installed on the server.

Requirements

• Staff of Protection in your inventory.
• Enough Eitr for one cast. If you are short, the Eitr bar flashes and nothing is swapped.

Configuration

BepInEx/config/com.syloreon.valheimbubble.cfg, created on first launch. In Gale: Config tab → Valheim Bubble.

Section	Setting	Default
General	Keybind	F6	Key that runs the swap-cast-swap. A single key (F12) or a key with modifiers (A + LeftControl).
Gear	StaffPrefab	StaffShield	Staff to cast with.
Gear	CastTimeoutSeconds	6	Give up and restore gear after this long.
Timer	Enabled	true	Show the countdown.
Timer	OffsetX / OffsetY	0 / 70	Position relative to the status-effect icons.
Timer	FontSize	20
Timer	ExpiryCue	Both	None, Flash, Sound or Both. Flash is "Bubble down!", Sound is the early chime.
Timer	WarningSeconds	5	How many seconds before the bubble ends the chime plays.
Timer	CueVolume	0.4	Volume of the bubble chime.
LowEitr	Enabled	true	The Low Eitr chime and message.
LowEitr	CastsLeft	2	Warn when your maximum Eitr can't hold this many bubbles.
LowEitr	Volume	0.4	Volume of the Low Eitr chime.
Food	Enabled	true	The Low Health / Low Stamina chime and message.
Food	WarnAtPercent	50	Warn when a food has faded to this percent of its full health/stamina. Higher warns earlier.
Food	Volume	0.4	Volume of the food chime.

Changes take effect after restarting the game.

In Gale's config editor the keybind field records the key you press, including Ctrl, Shift or Alt. In the .cfg file write the main key first, then the modifiers: Keybind = A + LeftControl. With modifiers set, the key fires only while they are held. Extra keys don't block it, so the key still works while you sprint (Shift) or crouch (Ctrl). In Valheim, Left Ctrl is also crouch by default, so a Ctrl combo crouches as well.

Notes

• The key does nothing while chat, the console, a menu, the map or your inventory is open, or while you're at a ship's helm, sitting or in bed.
• If you keep attacking or jump into deep water mid-cast, your gear comes back as soon as the game allows it.
• The chimes follow their own volume settings and the master volume, not the game's SFX slider.
• If the bubble breaks before the chime, there's no chime; the game plays its own break sound.
• The Low Eitr warning needs the staff in your inventory, since it counts in bubbles. It stays quiet if you log in already low or never eat Eitr food.
• Foods that only give Eitr don't trigger the food warning; the Low Eitr warning covers them. A food that is already low when you log in stays quiet until you eat it again.
• If you carry more than one staff, the highest-quality one is used.