Viking Mushrooms

Viking Mushrooms adds mushroom-induced trance states to Valheim, combining unique gameplay mechanics with hallucinations, audio, camera effects and HUD elements designed to fit naturally into the game.

Created by TheLionCid.

Version: 0.7.0
Valheim: 1.0.17
Framework: BepInEx 5

---

Available Trances

The current public release includes three mushroom trances:

Mushroom	Trance	Main identity
Red Mushroom (Mushroom)	Berserksgangr	Blood Debt, aggressive combat bonuses and crimson hallucinations.
Yellow Mushroom (MushroomYellow)	Vision of Hel	Enemy revelation, spectral hallucinations and temporary Spirit damage.
Magecap (MushroomMagecap)	Eitr Overload	Arcane refraction, Overload, stronger magic and unstable extra projectiles.

The remaining planned mushroom trances are not enabled in the current public release. Their foods keep their normal Valheim behaviour.

Only one trance can be active at a time. By default, consuming another supported mushroom replaces the current trance.

Trance duration follows the remaining food duration of the mushroom that triggered it. The mushroom's normal food values remain unchanged.

---

Berserksgangr

Berserksgangr is an aggressive trance built around Blood Debt.

Instead of immediately dying when damage pushes the player beyond the configured health floor, part of that damage can become Blood Debt.

Blood Debt

Blood Debt is displayed near the health bar and can be repaid through healing.

As Blood Debt rises, Berserksgangr can increase:

• melee damage;
• attack speed;
• movement speed;
• stagger resistance.

The maximum bonuses and debt behaviour can be adjusted in the configuration.

Last Breath

If Berserksgangr ends while Blood Debt remains, Last Breath begins.

The player has a short period to repay the remaining debt. If it is not cleared before the countdown ends, the unpaid debt can kill the player.

Armour restriction

By default, Berserksgangr can restrict configured metal chest armour.

The restriction and blocked chest-prefab list are configurable.

Visual identity

Berserksgangr includes effects such as:

• crimson world colouring;
• Blood Debt pressure effects;
• red auras and glowing eyes;
• floating runes;
• spectral hallucinations;
• camera and post-processing effects;
• heartbeat and trance audio.

---

Vision of Hel

Vision of Hel is a perception-focused trance where the world of the dead appears to overlap normal Valheim.

Enemy revelation

Nearby enemies can be revealed by periodic perception pulses.

Revealed enemies receive a golden spectral presentation and an eye marker, helping the player track them even through normal scene obstruction where the reveal effect applies.

Hallucinations

Vision of Hel can include:

• crypt-like fog;
• distant specters;
• spectral birds;
• runic inscriptions;
• motion afterimages;
• screen distortion;
• distant chains;
• green and golden atmospheric effects.

These hallucinations are visual-only and do not have AI, collision, loot, damage or persistent world state.

Spirit damage

While Vision of Hel is active, weapon attacks receive an additional 10% Spirit damage contribution.

---

Eitr Overload

Eitr Overload is the Magecap trance: a risk-and-reward magic state built around accumulating Overload.

Casting magic increases Overload according to the Eitr cost of the cast.

Magic damage

As Overload rises, magic damage receives increasing bonuses:

• 25% Overload → +5% magic damage;
• 50% Overload → +10% magic damage;
• 75% Overload → +15% magic damage;
• 100% Overload → special +50% total magic damage state.

Physical damage is unchanged.

Maximum Overload

At 100% Overload, compatible fireball, ice-shard and lightning staff casts create one additional unstable projectile.

Each compatible cast at maximum charge also has a 25% chance to trigger Arcane Rupture.

Arcane Rupture

When Arcane Rupture triggers:

• Overload is reset to 0%;
• current Eitr is emptied;
• Eitr regeneration is briefly locked for 2 seconds.

The rupture itself does not deal damage.

For sustained ice attacks, each paid burst is treated as a cast. Other spell families can still build Overload and receive applicable magic-damage bonuses even when they do not create an additional projectile.

Visual identity

Eitr Overload reveals a hidden arcane layer beneath the normal world.

Its presentation includes:

• crystal-like camera refraction;
• blue daytime and violet nighttime atmosphere;
• large solar and lunar arcane seals;
• floating runes and arcane fractures;
• magical mushroom groves in varied sizes;
• local animal and root-like hallucinations;
• native-style magical particles;
• stronger instability as Overload rises.

These manifestations are local visual effects and do not become networked gameplay creatures.

---

Installation

Thunderstore / r2modman

Install Viking Mushrooms through your preferred Thunderstore-compatible mod manager.

Required dependency:

• BepInExPack Valheim 5.4.2351

Manual installation

1. Install BepInExPack for Valheim.
2. Extract the package into your Valheim game or profile directory.
3. Keep these files together:

BepInEx/plugins/VikingMushrooms/VikingMushrooms.dll
BepInEx/plugins/VikingMushrooms/vikingmushroomsfx

1. Start Valheim.

The current release is prepared for Valheim 1.0.17.

---

Configuration

BepInEx creates the active configuration file at:

BepInEx/config/TheLionCid.VikingMushrooms.cfg

Main configuration areas include:

General

• enable/disable the mod;
• language (es / en);
• debug logging;
• trance replacement;
• optional F8 Visual FX Lab.

Berserker

• armour restrictions;
• health floor;
• Blood Debt limits;
• combat bonuses;
• healing efficiency;
• Last Breath duration.

HelVision

• reveal range;
• pulse interval;
• highlight duration;
• line-of-sight behaviour;
• hallucination frequency.

Eitr Overload

• Overload gain;
• magic-damage thresholds;
• maximum-charge projectile behaviour;
• Arcane Rupture chance;
• Eitr regeneration lock;
• hallucination and presentation limits.

Visual / VisualFX

• trance intensity;
• camera effects;
• crystal refraction and distortion;
• afterimages;
• colour grading;
• vignette;
• hallucination limits.

HUD

• trance indicator;
• Blood Debt display;
• Overload display;
• HUD scale and spacing.

Audio

• trance audio intensity and related presentation settings.

---

Visual FX Lab

Viking Mushrooms includes an optional F8 Visual FX Lab for testing and tuning visual effects.

It is disabled by default.

Enable it with:

[General]
EnableFxLab = true

The current public release includes previews for:

• Berserksgangr;
• Vision of Hel;
• Eitr Overload.

The FX Lab is a visual preview/debug tool and does not reproduce every gameplay mechanic.

---

Multiplayer

For multiplayer, use the same Viking Mushrooms version on all participating clients.

Most hallucination and presentation effects are local to each player, while gameplay mechanics remain tied to the active trance.

If you encounter a multiplayer-specific issue, include whether the problem happened on the host, client or both when reporting it.

---

Compatibility

Viking Mushrooms is currently prepared for:

• Valheim 1.0.17
• BepInExPack Valheim 5.4.2351

Mods that heavily replace the HUD, camera or post-processing systems may require additional compatibility work.

If a Valheim update changes the APIs, prefabs, animations, shaders or HUD systems used by Viking Mushrooms, a mod update may be required.

---

Native Valheim Integration

Where appropriate, Viking Mushrooms reuses Valheim assets at runtime to keep hallucinations and effects visually consistent with the game.

The package does not redistribute Valheim game assets.

Custom visual and audio resources included with the mod are covered by:

• docs/LICENSE_AUDIO.md
• docs/LICENSE_VISUALS.md

---

Community & Support

Join the Viking Mushrooms Discord for:

• bug reports;
• troubleshooting;
• compatibility reports;
• visual and balance feedback;
• suggestions;
• development discussion;
• community testing.

Discord:
https://discord.gg/kN3cqHqWYA

When reporting a problem, please include:

• Viking Mushrooms version;
• Valheim version;
• active mod list;
• single-player or multiplayer;
• relevant BepInEx log output;
• active trance;
• steps to reproduce the issue.

For visual problems, screenshots or short videos are especially useful.

---

Development

Viking Mushrooms has been developed with the assistance of AI tools for areas such as code generation, debugging, visual planning and documentation.

Final design decisions, testing and release management are handled by TheLionCid.

---

Credits

• TheLionCid — creator and author of Viking Mushrooms.
• BepInEx / Valheim modding community — framework and modding ecosystem.
• Valheim — native runtime assets are reused where appropriate; game assets are not redistributed by this package.

---

Disclaimer

Viking Mushrooms is an independent Valheim mod and is not affiliated with or endorsed by Iron Gate.

Always make backups before major Valheim updates or large mod-list changes.