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.5.3
Valheim: 1.0.16
Framework: BepInEx 5

Available Trances

The current public release includes two mushroom trances:

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.

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.

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.16.

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.

Visual / VisualFX

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

HUD

• trance indicator;
• Blood Debt 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.

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.16
• 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.