You are viewing a potentially older version of this package. View all versions.
ProfMags-Wandering_Companions-1.1.1 icon

Wandering Companions

Hostile Hostile NPC's that roam every biome with full gear sets and advanced combat AI. Defeat them to earn a loyal companion that follows you across Valheim.

Date uploaded 5 days ago
Version 1.1.1
Download link ProfMags-Wandering_Companions-1.1.1.zip
Downloads 440
Dependency string ProfMags-Wandering_Companions-1.1.1

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2200 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2200
ProfMags-Offline_Companions-1.2.2 icon
ProfMags-Offline_Companions

Hire NPC companions with their own health, stamina, food, inventory, voice lines, and AI. They fight alongside you, gather, forage, farm, fish, hunt, smelt, repair gear, maintain your base, and follow you across Valheim.

Preferred version: 1.2.2

README


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.


Version BepInEx Valheim License

Discord

Patreon


Overview


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



Biome Gear


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.



Configuration


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


Installation


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



Requirements


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


Compatibility


  • Offline Companions is a hard dependency. Defeated wanderers convert into HC companions
  • Uses a custom WC_Wanderer prefab registered at startup via Harmony patches on ZNetScene and SpawnSystem
  • Patches MonsterAI.UpdateAI only for wandering companion instances (other monsters unaffected)
  • Multiplayer: wanderers spawn per the server's SpawnSystem. The killing player becomes the friendly companion's owner


Console Commands


Command Description
spawnwanderer Spawns a wandering companion 10m in front of the player


Credits


Built on BepInEx and Harmony
Requires Offline Companions for friendly companion conversion



GitHub Issues Discord

Forged for the Valheim community. Skol, Vikings.

CHANGELOG

Changelog

1.1.1

Fixes

  • Fixed wanderers being completely invulnerable — Dverger faction prevented all player damage; now uses ForestMonsters with hunt disabled instead
  • Wanderers are now properly damageable while remaining passive until struck

1.1.0

Fixes

  • Fixed critical spawn bug where wanderers spawned every frame — entries were being added once per zone chunk load instead of once per session
  • Wanderers now correctly spawn at expected frequency

Changes

  • Wanderers are now passive until attacked — they will wander the biome peacefully and only turn hostile when struck
  • Health now scales aggressively by biome tier (Meadows 150 → Ashlands 2500 base HP)
  • Biome override argument added to spawnwanderer command (e.g. spawnwanderer plains)
  • Converted companions now spawn at full health
  • Bow attack cooldown added (3 seconds between shots) to prevent arrow spam
  • Added overhead speech text — wanderers say contextual lines while roaming and in combat
  • Added ConvertOnDeath config option — disable to have wanderers simply die instead of becoming companions
  • Natural skin and hair color tones only (no more green/purple)
  • Spawn rate reduced (50 min interval, 15% chance)

1.0.0

  • Initial release