Troll-Toll

"You gotta pay the Troll-Toll... unless there are no trolls around!"

A lightweight, high-performance Valheim mod that turns off stamina drain when exploring, building, or farming out of combat, while preserving full combat challenge.

Featuring granular creature control, biome-by-biome configuration, and a progressive Boss Relief system where conquering biomes rewards you with permanent combat stamina discounts (culminating in 100% free stamina in conquered early biomes!).

🌟 Key Features

• Contextual Stamina Costs: Sprint, jump, dodge, sneak, and hammer-build with zero stamina cost when exploring or relaxing in your base.
• Accurate Threat Detection: Leverages Valheim's internal BaseAI.IsEnemy logic. Correctly ignores tamed pets (wolves, boars, lox) and friendly Dvergr, but detects hostile creatures, bosses, and raid attackers.
• Boss Relief System: Defeating a biome's boss unlocks permanent combat stamina relief (25% – 75%) for that biome. Each subsequent boss defeated beyond that biome grants further relief (+25% by default), culminating in 100% free stamina even during combat in conquered biomes (e.g., after 4 bosses, the Meadows has 100% stamina relief)!
• Granular Biome Control: Toggle Troll-Toll individually for each biome (Meadows, Black Forest, Swamp, Mountain, Plains, Mistlands, Ashlands, Deep North, Ocean) and set per-biome detection radii.
• Granular Creature Control:
  • Ignored Creatures List: Comma-separated list of creature names or prefabs that will never trigger threat (e.g. Greyling, Neck, Boar, Skeleton).
  • Enforced Threat List: Comma-separated list of creatures that always trigger threat (e.g. Troll, Abomination, Gjall).
  • Per-Creature Detection Radii: Set custom threat ranges per creature (e.g. Troll:50, Abomination:40, Greyling:10).
  • Quick Toggles: Fast boolean toggles to ignore wild Boars, Necks, Greylings, Bats, and Skeletons.
• Zero-Stamina Protection: Patches Player.HaveStamina so you aren't blocked from sprinting, jumping, or building when actions are discounted.
• Raid Awareness: Automatically enforces normal stamina consumption whenever a base raid or random event is active.
• In-Game Chat Command: Type /trolltoll or /tt in chat to inspect your current biome, boss defeat status, active discount, and nearby threat state.
• Multiplayer Friendly: Client-side mod. Can be used on vanilla and modded servers without requiring server installation.
• Lag-Free: Threat scanning is cached (default every 0.2s), eliminating micro-stutters even in massive, creature-dense bases.

👑 How the Boss Relief System Works

When you defeat the boss of a biome, you unlock permanent combat stamina relief for that biome:

1. Initial Relief: Defeating the biome's boss unlocks base relief (default 25%, configurable between 25% and 75%).
2. Additional Boss Scaling: For each additional boss defeated in world progression, earlier conquered biomes gain stronger relief (default +25% per additional boss).
3. Mastery Cap: Caps at 100% (zero stamina drain even while actively fighting).

Example Progression Table (Default 25% Base + 25% Per Additional Boss):

(Notice: after 4 bosses total, Meadows reaches 100% stamina relief, making you the undisputed master of early lands!)

💬 In-Game Chat Commands

Open chat (Enter) and type:

• /trolltoll (or /tt): Prints your current biome, boss defeat status, total world bosses defeated, nearby threat detection status, and effective stamina discount percentage.

⚙️ Configuration

Configuration is automatically generated at BepInEx/config/com.beardymike.trolltoll.cfg. You can edit this file in any text editor or configure it via the r2modman / Thunderstore Configuration Manager.

1 - General

2 - Detection

3 - Restrictions

4 - Performance

5 - Biome Controls

6 - Creature Controls

7 - Boss Relief System

📦 Installation

Using a Mod Manager (Recommended)

1. Install r2modman or the Thunderstore Mod Manager.
2. Search for Troll-Toll and click Download with Mod Manager.

Manual Installation

1. Install BepInExPack Valheim.
2. Download the latest TrollToll.dll from the Releases page.
3. Place TrollToll.dll into your Valheim/BepInEx/plugins/ folder.

🛠️ Building From Source

dotnet build

The project targets .NET Standard 2.1 for compatibility with Valheim's Unity runtime.

Automatic Path Detection

The build automatically locates your Valheim and BepInEx assemblies using:

1. Standard Steam installation directories across common drive letters (C:, D:, E:).
2. Dynamic user profile paths ($(APPDATA)) for r2modman and Thunderstore Mod Manager profiles, so anyone can clone and build immediately without editing the project file.
3. System environment variables (VALHEIM_INSTALL_DIR or VALHEIM_PATH) if defined.

Custom Installation Paths

If your game or BepInEx core is in a custom folder, copy Environment.props.example to Environment.props and uncomment your paths:

<Project>
  <PropertyGroup>
    <ValheimPath>D:\Games\Steam\steamapps\common\Valheim</ValheimPath>
    <BepInExCorePath>D:\Games\Steam\steamapps\common\Valheim\BepInEx\core</BepInExCorePath>
  </PropertyGroup>
</Project>

(Note: Environment.props is ignored by Git, so your local machine paths will never be committed).

📄 License & Credits

• Author: BeardyMike
• Compatibility: Valheim (Ashlands & Bog Witch updates) + BepInEx 5.4.x
• Licensed under the MIT License.