Wandering Companions

Wandering Companions

Hostile NPC wanderers roam every biome equipped with full gear sets and advanced combat AI featuring blocking, parrying, and stance-based weapon selection. Defeat them to earn a loyal companion.

<img src="https://img.shields.io/badge/Version-1.0.0-c9a44a?style=for-the-badge&labelColor=0d1117" alt="Version"> <img src="https://img.shields.io/badge/BepInEx-5.4.2200+-e06c20?style=for-the-badge&labelColor=0d1117" alt="BepInEx"> <img src="https://img.shields.io/badge/Valheim-0.219+-4ade80?style=for-the-badge&labelColor=0d1117" alt="Valheim"> <img src="https://img.shields.io/badge/License-MIT-7c3aed?style=for-the-badge&labelColor=0d1117" alt="License">

<img src="https://img.shields.io/badge/Discord-Join_Server-5865F2?style=for-the-badge&logo=discord&logoColor=white&labelColor=0d1117" alt="Discord">

<img src="https://img.shields.io/badge/Patreon-Support_Me-FF424D?style=for-the-badge&logo=patreon&logoColor=white&labelColor=0d1117" alt="Patreon">

<img src="https://img.shields.io/badge/%F0%9F%93%96_OVERVIEW-2b3a4a?style=for-the-badge&labelColor=2b3a4a" alt="Overview">

<table><tr><td width="900">

Wandering Companions adds hostile NPC enemies to every biome in Valheim. These wanderers spawn with full gear sets one tier above the current biome, advanced combat AI with blocking, parrying, and counter-attacks, and randomized combat stances. They're 50% larger than the player and have 50% bonus health, making them a serious challenge at any stage of the game.

When you defeat a wanderer, they convert into a friendly companion from Offline Companions that automatically follows the player who killed them. The friendly companion spawns with no gear — a blank slate ready to be equipped.

Each wanderer has a randomized appearance (gender, hair, beard, skin tone) and one of three combat stances:

| Stance | Behavior | |:---|:---| | Balanced | Auto-switches between melee and ranged weapons based on distance | | Melee | Forces sword, mace, or atgeir — stays in close range | | Ranged | Forces bow — maintains distance from the target |

All stances feature reactive blocking (raises shield when enemy swings), perfect parry timing (resets block timer for guaranteed parry), and parry counter-attacks (queues 2 fast attacks after a successful parry).

</td></tr></table>

<img src="https://img.shields.io/badge/%E2%9A%94%EF%B8%8F_BIOME_GEAR-3a2b4a?style=for-the-badge&labelColor=3a2b4a" alt="Biome Gear">

<table><tr><td width="900">

Wanderers spawn with gear one tier above the biome they appear in. This means you'll always face an enemy slightly ahead of your current progression.

| Biome | Gear Tier | Weapon | Armor | Health | |:---|:---|:---|:---|:---| | Meadows | Black Forest | MaceBronze, BowHuntsman | Iron Set | 225 | | Black Forest | Swamp | SwordIron, BowHuntsman | Iron Set | 300 | | Swamp | Mountain | SwordSilver, BowDraugrFang | Wolf Set | 450 | | Mountain | Plains | AtgeirBlackmetal, BowDraugrFang | Padded Set | 600 | | Plains | Mistlands | SwordMistwalker, BowSpineSnap | Carapace Set | 750 | | Mistlands | Ashlands | SwordFlametal, BowSpineSnap | Flametal Set | 900 | | Ashlands | Ashlands | SwordFlametal, BowSpineSnap | Flametal Set | 900 |

Health values include the 50% bonus. All wanderers carry infinite arrows and a shield.

</td></tr></table>

<img src="https://img.shields.io/badge/%F0%9F%94%A7_CONFIGURATION-4a3a2b?style=for-the-badge&labelColor=4a3a2b" alt="Configuration">

<table><tr><td width="900">

Configuration file: BepInEx/config/com.wandering.companions.cfg

| Setting | Default | Description | |:---|:---|:---| | Enabled | true | Master toggle for wandering companion spawns | | SpawnInterval | 1500 | Seconds between spawn attempts per biome (25 min) | | SpawnChance | 24 | Percent chance a spawn attempt succeeds (0-100) | | HealthMultiplier | 1.0 | Multiplier applied to base health values |

</td></tr></table>

<img src="https://img.shields.io/badge/%F0%9F%93%A6_INSTALLATION-4a3a2b?style=for-the-badge&labelColor=4a3a2b" alt="Installation">

<table><tr><td width="900">

1. Install BepInEx for Valheim
2. Install Offline Companions (required dependency)
3. Download the latest release from Releases
4. Extract to BepInEx/plugins/WanderingCompanions/
5. Launch the game

</td></tr></table>

<img src="https://img.shields.io/badge/%F0%9F%93%8B_REQUIREMENTS-3a4a2b?style=for-the-badge&labelColor=3a4a2b" alt="Requirements">

<table><tr><td width="900">

| Dependency | Version | Required | Link | |:---|:---|:---|:---| | Valheim | 0.219+ | Yes | | | BepInEx | 5.4.2200+ | Yes | Download | | Offline Companions | 1.2.2+ | Yes | GitHub |

</td></tr></table>

<img src="https://img.shields.io/badge/%F0%9F%94%97_COMPATIBILITY-4a2b3a?style=for-the-badge&labelColor=4a2b3a" alt="Compatibility">

<table><tr><td width="900">