Get the Thunderstore App

Easily install and manage your mods with the Thunderstore App!

You are viewing a potentially older version of this package. View all versions.

Offline Companions

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

By ProfMags

https://github.com/JoeCorrell/HaldorCompanions

Date uploaded	4 days ago
Version	1.0.8
Download link	ProfMags-Offline_Companions-1.0.8.zip
Downloads	76
Dependency string	ProfMags-Offline_Companions-1.0.8

This mod requires the following mods to function

denikson-BepInExPack_Valheim

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

Preferred version: 5.4.2200

README

Offline Companions

Hire NPC companions from Haldor's shop - persistent allies with their own AI, inventory, voice lines, combat, gathering, smelting, and base maintenance systems.

Radial Command Wheel

Companion Inventory Panel

Trader Purchase Screen

Offline Companions adds persistent NPC allies to Valheim. A companion automatically spawns with you when you enter a new world for the first time. Additional companions can be purchased from Haldor's shop for 2,000 coins if the optional Trader Overhaul mod is installed, or spawned via console commands.

Companions come with their own inventory, equipment, stamina, food system, voice lines, and custom AI. They aren't pets or tames, they're teammates. Customize their appearance, gear them up with weapons and armor, feed them food for bonus stats, and command them through a radial wheel or point-and-click hotkey system. They'll fight beside you, gather resources, forage for food, manage your smelting operation, maintain your base, haul your cart, repair their own gear, sit by the fire with you, sleep in beds, and teleport through portals alongside you.

Leave a companion at home and they'll autonomously repair damaged walls, refuel campfires and torches, sort your chests, and keep your smelters running. They level up skills, receive the Rested buff, and respawn at the last bed they slept in.

When a companion dies, they leave behind a tombstone. They'll respawn after a short time at their bed (or the world spawn) and automatically walk to their tombstone to recover their items.

Everything persists across sessions, zone transitions, server restarts, and player deaths.

Starter Companion

A companion automatically spawns with you when you enter a new world for the first time. Each character gets one free companion per world. Disable this with the SpawnStarterCompanion config setting.

Purchase (Optional)

Install Trader Overhaul to unlock the Companions tab in Haldor's shop and recruit additional companions. Each costs 2,000 coins from your bank balance. Customize their gender, hair, beard, skin tone, and hair color in the 3D preview before confirming. This dependency is optional — the mod works fully without it.

Interact

Tap E on your companion to open their inventory panel. Manage gear, feed food, rename them. Hold E (or X on gamepad) to open the radial command wheel for quick access to all action modes and toggles.

Command

Point your crosshair at objects in the world and press the command hotkey to issue contextual orders. The companion figures out what to do based on what you're looking at.

Hold E (keyboard) or X (gamepad) on a companion to open the radial command wheel. Move the mouse or gamepad stick to highlight an option, then click or press E to select. You can select multiple options before closing. Press Escape or B to close.

The companion's name is shown in the center. Active toggles show their current ON/OFF state.

Segment	Type	Description
Follow	Toggle	Companion follows you (default ON). Can be combined with any gather mode. Overrides Stay Home when ON
Gather Wood	Mode	Autonomously find and chop trees, logs, and stumps nearby
Gather Stone	Mode	Autonomously find and mine rocks nearby
Gather Ore	Mode	Autonomously find and mine ore deposits nearby
Forage	Mode	Autonomously find and pick berry bushes, mushrooms, flowers, and ground items nearby
Smelt	Mode	Autonomously refill kilns and furnaces with fuel/ore from chests, collect smelted output
Stay Home	Toggle	Patrol the home position instead of following you
Set Home	Action	Save the companion's current position as their home point
Wander	Toggle	Roam up to 50m around home (ON) or stay put (OFF)
Auto Pickup	Toggle	Automatically pick up nearby dropped items
Command	Toggle	Accept directed commands from the point-to-command hotkey

Gather modes are mutually exclusive. Selecting a gather mode switches away from the previous one. Tapping an active gather mode deselects it. Follow is an independent toggle that can be combined with any mode.

Tap E on a companion to open the inventory panel alongside the standard inventory GUI. The panel shows:

Name field - rename your companion (persists in save)
5x6 inventory grid (30 slots, 300 weight capacity) - drag items in and out, view durability bars, equipped items highlighted in blue
3 food slots - showing active food effects and remaining duration

Companions auto-equip the best gear from their inventory: best weapon, shield, chest, legs, helmet, shoulder, and utility item. Items equip one at a time with proper animation. Broken items (0 durability) are skipped and unequipped.

Right-click an item to use/equip it. Right-click food to feed it to the companion. Drag items between your inventory and theirs using vanilla drag-and-drop.

Press F7 while the panel is open to enter UI Reposition Mode — click and drag the panel to move it anywhere on screen. Press F7 again to confirm. Your custom position is saved and persists across sessions.

Companions run on a custom AI system (CompanionAI) built from scratch on top of Valheim's BaseAI pathfinding. This is not a repurposed MonsterAI. It's a purpose-built AI loop designed specifically for companion behavior.

Follow & Formation

When following you, each companion is assigned a formation slot. Multiple companions spread out around you instead of stacking on top of each other. When far away (>15m), they sprint straight to you; when close, they maintain formation offset. They use vanilla pathfinding and navigation mesh for movement.

Target Management

Companions scan for enemies every 2-6 seconds depending on distance from you. Once they lock onto a target, they commit and won't bounce between enemies. A directed target from the command hotkey locks for 10 seconds. In gather modes, targeting is suppressed unless an enemy enters self-defense range (10m).

Sleep & Wake

Companions support Valheim's sleep/wake RPC system. They can be directed to sleep in beds and will wake automatically when enemies approach.

Stuck Detection

Built-in stuck detection nudges companions clear of furniture colliders, beds, and chairs that block pathfinding. Door handling detects when a companion is stuck behind a closed door and automatically opens, passes through, and closes it.

Stay Home Patrol

When Stay Home is active, the AI switches from following you to patrolling the home position. Combined with gather modes, they'll autonomously harvest resources near home without you being present.

Companions use a defensive-first combat system. They actively scan for incoming threats and react before attacking.

Melee Combat

Threat detection - scans nearby enemies for attack animations and incoming projectiles
Shield blocking - raises shield when threats are active, holds block through the attack
Perfect parry - every timed block is a perfect parry (block timer reset on impact)
Counter-attacks - drops shield and strikes immediately after blocking
Power attacks - delivers a heavy attack when an enemy is staggered (3s cooldown)
Dodge - sidesteps perpendicular to incoming attacks when stamina allows

Ranged Combat

Equips a bow when the target is beyond 20m, switches back to melee under 12m
Arrows are aimed at the target's center mass with velocity leading (aims ahead of moving targets) and gravity compensation (aims higher for arrow drop)

Combat Behavior

Backstab immunity - companions cannot receive backstab bonus damage from enemies attacking from behind
Retreats when health drops below 30% or stamina below 15%
Re-engages after recovering above 50% health and 30% stamina
Retreat distance is 12m from the target
Tools and pickaxes are never used in combat. Auto-equip forces a switch to a proper weapon

Stamina System

Companions have their own stamina pool (base 25 + food bonus) with regeneration. Stamina is consumed by attacks, blocking, running, and swimming. When stamina hits zero, attacks fail and blocks don't hold.

The radial menu has an inner ring with four combat stances that control how companions fight. Move the mouse closer to the center of the radial wheel to select a stance. The active stance is highlighted and persists across sessions.

Stance	Effect
Balanced	Default behavior. Standard retreat thresholds, normal blocking, dodging, and power attacks
Aggressive	Extended aggro range (50m), no blocking or dodging, lower retreat thresholds (15% HP / 5% stamina), halved power attack cooldown, tighter flanking
Defensive	Only engages enemies within 5m or those targeting the player. Higher retreat thresholds (45% HP / 25% stamina), faster dodge cooldown, tighter formation around the player
Passive	Never attacks. Suppresses all targeting and combat. The companion simply follows you or idles at home

Stances affect all combat parameters: target acquisition, retreat thresholds, dodge timing, block behavior, power attack cooldowns, flanking distance, and formation spacing.

Set a companion to Gather Wood, Gather Stone, Gather Ore, or Forage via the radial wheel or directed command. They'll autonomously find, walk to, and harvest nearby resources.

Gather Behavior

Wood - chops trees, fallen logs, and stumps. Prioritizes fallen logs and stumps over standing trees (3x distance penalty on standing trees).
Stone - mines rock formations (MineRock, MineRock5).
Ore - mines ore deposits (pickaxe-vulnerable destructibles that are chop-immune).
Forage - walks to and picks berry bushes, mushrooms, flowers, dandelions, branches, and stones. No tool required.

Smart Tool Use

The companion automatically equips the best matching tool from their inventory. Axe for wood, pickaxe for stone and ore. The tool stays equipped until gathering stops. Companions won't chop trees if their axe doesn't meet the tree's minimum tool tier — preventing wasted durability on resources they can't damage.

Drop Collection

After destroying a resource, the companion scans within 8m for item drops and picks them all up before moving to the next target.

Overweight

Gathering stops automatically at 298/300 weight. The companion reverts to Follow mode and announces they're overweight.

Self-Defense

If an enemy enters within 10m during gathering, the companion pauses to fight, then resumes gathering once the threat is gone.

Point at a specific tree, rock, or ore node and press the command hotkey to direct the companion straight to it.

Set a companion to Smelt via the radial wheel and they'll autonomously manage nearby kilns and furnaces. Place them near your smelting setup with chests of ore and fuel, and they'll handle the rest.

How It Works

The companion continuously scans for smelters within 25m and keeps them running:

Refill kilns first (they produce charcoal for furnaces)
Refill furnaces with smart priority: ore first when fuel is adequate, fuel when critically low
Collect smelted output (bars, coal) from ground drops and queued output
Deposit output into nearby chests with available space

Smart Behavior

Inventory-first: if the companion already has fuel or ore in their inventory, they go straight to the smelter instead of visiting a chest
Chest animations: opening and closing chests plays the proper animation and sound effects
Smelter effects: inserting fuel or ore plays the smelter's sound effects and feeding animation
Correct positioning: the AI navigates to the correct interaction side of each smelter (fuel side, ore side, output side)
Carry limits: up to 20 ore or 40 fuel per trip to prevent overweighting

Combine with Stay Home

Set Stay Home + Smelt and the companion will manage your smelting operation autonomously near their home position. Perfect for unattended base smelting while you're out exploring.

Companions will pause smelting to fight any enemies that enter self-defense range, then resume when the threat is gone.

Point your crosshair at objects in the world and press the command hotkey to issue contextual orders. All owned commandable companions receive the command simultaneously.

Target	Action
Enemy	Direct attack, locks target for 10 seconds
Tree / Rock / Ore	Enter gather mode for that resource, directed to that specific node
Crafting Station	Walk to station and repair all compatible gear
Cart	Closest companion attaches to cart and hauls it (press again to detach)
Ship	Find the ladder, path to it, and board the ship. Companions sit on deck during the voyage
Bed	Walk to bed and sleep (press again to wake)
Fireplace	Walk to fire and sit down
Chest	Walk to chest and deposit non-essential items (keeps equipped gear, food, weapons, armor)
Door	Walk to door and open it
Ground / Terrain	Walk to that position and wait
Nothing / Sky	Cancel all commands, return to following you

Long press the command hotkey (0.4s) to recall all companions. Cancels everything and restores follow mode. They'll say "Coming!" and head straight to you.

The command hotkey must be configured in the BepInEx config file. Works on both keyboard and gamepad.

Toggle Stay Home in the radial to anchor a companion near their home position. Use Set Home to mark where they should stay. They'll patrol within range instead of following you.

Homestead Mode (Autonomous Base Maintenance)

When Stay Home is ON and Follow is OFF, companions automatically maintain your base. Tasks rotate every 15 seconds in a round-robin cycle:

Task	What It Does
Repair	Scans for damaged player-built structures within 40m, walks to each one, plays hammer animation, fully repairs them
Refuel	Detects campfires, hearths, torches, sconces, and any fireplace below 30% fuel. Fetches the correct fuel type from nearby chests and adds fuel one unit at a time
Sort	Finds items split across multiple chests and consolidates smaller stacks into larger ones
Smelt	Cycles smelting duties (refill kilns/furnaces, collect output, deposit bars)

All chest interactions are slow and animated: the chest opens with a creak sound, items transfer one-by-one at 0.6s intervals, then the chest closes with sound. Companions speak contextual lines while performing each task.

Gathering + Auto-Deposit

Combine Stay Home + Gather mode and they'll harvest resources near home autonomously. When their inventory fills up (298 weight), direct them to a chest and they'll walk over and deposit everything except equipped gear, food, and weapons, then go right back to gathering.

Toggle Wander to control patrol range:

Wander ON - roams up to 50m around home
Wander OFF - stays exactly at the home point

Perfect for base-side wood farms, mining outposts, and fully automated bases. Set them up and leave.

Companions periodically scan their equipped gear. When any item drops below 50% durability, they'll walk to the nearest compatible crafting station (workbench, forge, etc.) and repair everything they can.

Point at a specific crafting station and press the command hotkey to direct them there immediately, regardless of durability threshold.

Companions have three food slots that work exactly like player food. Same bonuses, same burn timers, same front-loaded curve.

Base health: 25 HP + food bonus
Base stamina: 25 + food bonus
Food provides health regen, stamina regen, and Eitr bonuses
Companions auto-consume food from their inventory when a slot is empty
Meads are used automatically - health meads when below 50% HP, stamina meads when below 25% stamina (10s cooldown)
Status effects from food and meads are applied on consumption

Feed food by right-clicking consumables in the companion's inventory, or let auto-consume handle it. They'll speak up when hungry.

Companion gear works like player gear:

Weapons lose durability on every attack. When broken, they're unequipped automatically.
Armor absorbs damage and loses durability when hit. Full vanilla armor reduction formula applies.
Durability bars appear on inventory slots and overhead when looking at the companion.
Broken items are skipped by auto-equip and must be repaired at a crafting station.

Companions detect when they're stuck behind a closed door and automatically open it, walk through, and close it behind them. They also proactively scan for doors when circling a building trying to reach you.

Respects ward protection and locked doors. Companions won't open doors they shouldn't.

You can also point at a door and press the command hotkey to tell them to open it directly.

Campfire Sitting

When you sit by a burning campfire (using the sit emote), nearby companions in Follow mode will join you. They walk to the fire and sit down facing it. They'll stand up if you do, if enemies appear, or if the fire goes out.

Point at a fireplace and press the command hotkey to explicitly tell them to sit.

Bed Sleeping

Point at a bed and press the command hotkey to tell companions to sleep. They'll walk to the bed, lie down, and stay asleep until you wake them (same command again) or enemies appear.

Resting Benefits

While sitting or sleeping, companions heal 2 HP/sec and their stamina regeneration is doubled. Companions also receive the Rested buff when resting by a fire or in a Comfortable area (shelter + fire).

Bed Spawn Point

When a companion sleeps in a bed, that bed becomes their spawn point. If the companion dies, they'll respawn at the last bed they slept in instead of at the world spawn. Stay Home state is automatically restored on respawn.

Companions teleport with you through portals and dungeon entrances automatically. No commands needed — active followers warp to your destination when you arrive.

Companions in Stay Home mode are excluded — they remain at their post
Works even if the companion's zone unloaded during the teleport
Cancels any active rest state (sitting/sleeping) before warping to prevent animation glitches

Companions are marked on the minimap with a visible icon so you always know where they are. Markers are only visible to the companion's owner — other players won't see your companions on their map.

Companions level up skills just like the player. As they fight, gather, and work, their skills improve over time with progressive buff gains that increase their effectiveness.

Companions can swim but will slowly drown if their stamina is fully depleted in water. Feed them stamina food before ocean voyages. Companions also intelligently board ships — point at a boat and they'll find the ladder, path to it, and climb aboard.

Companions have context-aware speech that triggers every 20-40 seconds, with a 5-second cooldown between lines. Speech can be overhead text, voice audio, or both, configured independently per gender.

Voice Audio

Male voice audio clips are included with the mod and play automatically. Place additional or custom MP3 files in Audio/MaleCompanion/{Category}/ and Audio/FemaleCompanion/{Category}/ alongside the plugin DLL. Categories: Action, Combat, Follow, Forage, Gather, Hungry, Idle, Overweight, Repair, Smelt. If a female voice pack is missing clips for a category, male clips are used as fallback.

Speech Lines

Text lines are loaded from speech.json (auto-generated on first run). Edit this file to customize what companions say. Lines are shared across all companions regardless of gender. Language-specific speech files can be placed in Translations/speech/{Language}.json — the mod checks for the current language first, then falls back to speech.json.

Context	Example Lines
Combat	"For Odin!", "Taste my steel!", "By Thor's hammer!"
Overweight	"By Odin's beard, my back is breaking!"
Hungry	"My belly roars like a troll..."
Needs Repair	"This blade has seen better days."
Gathering	"The land provides, if you know where to look."
Foraging	"The meadows offer their gifts."
Smelting	"The forge fire burns bright.", "Good ore makes good steel."
Following	"Lead on, I am your shield."
Idle	"The winds whisper of adventure..."
Commands	"By your word!", "So it shall be."

Config Options

Setting	Default	Description
`MaleShowOverheadText`	`false`	Show overhead speech text for male companions
`MaleEnableVoiceAudio`	`true`	Play voice audio clips for male companions
`FemaleShowOverheadText`	`true`	Show overhead speech text for female companions
`FemaleEnableVoiceAudio`	`false`	Play voice audio clips for female companions

Each directed command type (attack, sit, sleep, repair, deposit, etc.) also triggers its own immediate speech line.

When looking at a companion, the vanilla enemy HUD is extended with extra stat bars below the health bar:

Yellow bar - current stamina
Brown bar - current inventory weight (percentage of 300 max carry weight)

The weight bar fills as the companion's inventory gets heavier, giving you an at-a-glance indicator of when they're getting full. This lets you check a companion's status from a distance without opening their inventory.

Stat	Value
Price	2,000 coins (from bank)
Base Health	25 HP (+ food bonus)
Base Stamina	25 (+ food bonus)
Carry Weight	300
Walk Speed	2 m/s
Run Speed	7 m/s
Gather Stop Weight	298 (stops harvesting)
Home Leash Radius	50m (Stay Home mode)
Auto-Repair Threshold	50% durability
Retreat Threshold	30% HP or 15% stamina
Re-engage Threshold	50% HP and 30% stamina

Everything about a companion is stored in ZDO and persists across:

Game sessions and server restarts
Zone transitions and area loading
Player deaths and respawns

Saved state includes: appearance, name, inventory, equipment, action mode, home position, all toggle states, food timers, and ownership. Follow targets are automatically restored after player respawn.

All UI labels, radial menu text, hover text, HUD messages, speech lines, and directed command speech are fully translatable. The mod integrates with Valheim's built-in Localization system.

How It Works

Translation keys are injected into Valheim's Localization.m_translations dictionary when the game loads. This means all $key patterns work automatically, including vanilla key bindings like $KEY_Use.

Translation Files

Translations/English.json is auto-generated on first run with all translation keys
To add a new language, copy English.json to Translations/{Language}.json (e.g., French.json) and translate the values
The mod loads the file matching the current Valheim language setting, falling back to English if not found
Speech lines support per-language files via Translations/speech/{Language}.json

For Translators

Translation files use a simple JSON format with key/value pairs. All mod keys use the hc_ prefix. Contribute translations by adding a new language file to the Translations/ folder.

1. Install BepInEx for Valheim
2. Download the latest release from Releases
3. Extract to BepInEx/plugins/Companions/
4. (Optional) Install Trader Overhaul to purchase additional companions from Haldor's shop
5. Launch the game

Dependency	Version	Required	Link
Valheim	`0.219+`	Yes
BepInEx	`5.4.2200+`	Yes	Download
Trader Overhaul	`latest`	Optional	GitHub

Trader Overhaul is optional. If installed, the Companions tab is injected into its custom trader UI for purchasing additional companions
Companions use a custom HC_Companion prefab registered at startup
Other NPC / follower mods should be compatible unless they patch BaseAI broadly
Multiplayer: companions are owned by the spawning player via ZDO ownership. Other players cannot interact with companions they don't own

Built on BepInEx and Harmony
Optionally integrates with Trader Overhaul for trader UI

_{Forged for the Valheim community ❤️ Skol, Vikings.}

CHANGELOG

Changelog

1.2.1

Farm Zones

Added Farm Zones — designate square planting areas where companions plant specific crops in a grid
Place zones via right-click on the Farm radial segment, or with a configurable hotkey (default Alt+Z)
Scroll wheel resizes zones, LMB places, RMB deletes existing zones, Escape exits
Crop picker popup lets you assign a specific crop or "Any Crop" per zone
Up to 4 zones per companion, saved to ZDO (persists across sessions)
Companions only plant inside defined zones — no zones means no planting
Zone rotation support via Q/E keys during placement
Camera zoom is blocked while placing zones to prevent accidental scrolling

Cooking

Companions can now cook for themselves — when hungry, they find a nearby Cauldron, gather ingredients from chests, and craft a meal

Potion Support

Right-clicking a potion or mead in a companion's inventory now makes them consume it
Status effects (healing, stamina, resistance, etc.) are applied to the companion and displayed in the player's HUD bar
Duplicate effects are prevented — if the same potion is already active, consumption is blocked
Stamina potions manually restore CompanionStamina (since vanilla SE_Stats targets Player only)

Harvesting Fixes

Fixed companions running back and forth over rocks — removed the LateUpdate shuffle for rock targets during Attacking state so companions stay planted once they arrive
Fixed companions digging holes in the ground instead of hitting rocks — attack facing now targets the rock's collider center (elevated) instead of the ground-level surface closest point
Fixed companions not finishing boulders (MineRock5) — when a node is destroyed, the companion always repositions to the next node instead of trying to attack from a distance
Stabilized the "too far" distance check for rocks by using the locked face target position instead of live ClosestPoint, which was shifting every frame and causing false re-approach triggers
Removed MineRock5 (boulders) from stone and ore gathering — boulders had persistent pathfinding and targeting issues and are no longer targeted by gather modes or directed commands

Stay Home Fixes

Fixed companions running in one direction and getting teleported back when Stay Home was activated — Follow toggle (default ON) was overriding StayHome throughout the codebase, causing the companion to walk toward the player and get yanked back by the hard leash
Fixed StayHome being overridden after completing gather, smelt, farm, hunt, cook, or rest tasks — all controllers now check StayHome before restoring follow target to the player
Fixed StayHome being overridden on companion respawn — spawn restore now correctly patrols at home instead of following the player
Fixed stale random movement target causing consistent directional drift after entering StayHome — ResetRandomMovement() is now called once on wander-OFF entry to flush the old target
StayHome is now checked before Follow in all follow-restore paths across 10 files (CompanionAI, CompanionSetup, CompanionRadialMenu, HarvestController, HuntController, SmeltController, FarmController, CookController, CompanionRest, CompanionManager)

UI

Enlarged the radial menu inner ring background slightly for better visual clarity
Moved companion name above the inner ring background
Moved hovered action text and state indicator above the outer radial ring

Water Fixes

Fixed companions glitching out and running in random directions near water — extended the NavMesh bypass to activate on any water contact (not just full swimming depth), preventing erratic pathfinding at shoreline edges
Context steer fallback state is now cleared when entering water, preventing stale obstacle avoidance directions from causing random movement
Fixed companions drowning with 0 stamina — pathfinding agent now switches to HumanoidAvoidWater when stamina drops below 50%, routing companions around water instead of through it
Water bypass (straight-line swimming) is now skipped when wading with low stamina, preventing companions from walking into deep water they can't escape

1.2.0

HomeLife System (Stay Home Overhaul)

Companions left at home now behave organically instead of mechanically rotating through tasks. They use a weighted random behavior picker with per-behavior cooldowns, creating natural living-at-home behavior.

Ambient Behaviors

Wander — companions walk continuously around the home area for 30-60 seconds, chaining random waypoints within the home radius
Sit on chairs — companions find nearby chairs and stools, walk over, sit down for 30-90 seconds with proper attach animation, then stand up and resume other activities
Use workstations — companions occasionally walk to a workbench or forge and stand at it for 10-20 seconds (cosmetic only)

Cooking

Companions now cook their own meals at a Cauldron when hungry (empty food slot or food below 50% remaining)
Scans ObjectDB recipes filtered to the Cauldron's station type for food items the companion can craft
Gathers ingredients from nearby chests (supports multi-chest gathering), walks to the Cauldron, and crafts the meal
Announces "Something tasty!" on successful cook — the existing food auto-consume system handles eating
If inventory is full, the cooked item is dropped on the ground as a fallback

In-Place Chest Sorting

Replaced cross-chest item transfer with in-place chest sorting — items within each chest are reorganized by type and name without moving items between chests
Sort priority: Weapons → Shields → Armor → Consumables → Materials → Trophies → Ammo

Maintained Behaviors

Repair buildings — finds damaged structures (below 50% health) within home radius and repairs them (kept from previous system)
Refuel fires — finds low-fuel fireplaces and refuels them from nearby chests or inventory (kept from previous system)

Architecture Changes

SmeltController and FarmController are now fully independent — no longer gated by HomesteadController's task rotation
Weighted behavior selection prevents repetitive loops (each behavior has a cooldown after completion)

1.1.9

Harvesting Fixes

Fixed companions not aiming at large rocks when mining — closest surface point on big rocks could be directly beside the companion, causing the facing system to silently bail out; now falls back to the rock's center and snaps body rotation instantly during attacks
Fixed companions digging holes in the ground instead of hitting rocks — tightened approach distance, arrival threshold, and "too far" detection for rock-like targets so pickaxe swings land on the rock face
Fixed companions jumping between pickaxe swings — proactive jump and stuck recovery are now suppressed while the companion is in the harvest Attacking state
Fixed pickaxes being used as combat weapons — pickaxes and tools are now excluded from CanUseAttack alongside fishing rods

Combat Fixes

Fixed companions using weak axes over better weapons — weapon selection now ranks by combat damage (excludes chop/pickaxe damage that doesn't hurt enemies), so a flint axe no longer beats a proper sword or battleaxe
Fixed vanilla EquipBestWeapon picking randomly between valid weapons — companions now always equip the highest combat-damage weapon available

1.1.8

Fish Mode

Added Fish action mode — companions autonomously fish nearby water bodies (ocean, rivers, ponds)
Requires a fishing rod and bait in the companion's inventory
Companion scans for water within 30m, walks to shore, faces the water, and casts the rod with the full casting animation
After casting, the companion waits for a nibble (15-20s), then reels in the fish (4-6s) with stamina drain
Catch type is determined by bait type using vanilla Fish prefab probability tables — the same bait catches the same fish as player fishing
On catch, the companion announces what they caught with overhead speech and a skill levelup sound effect
Automatically recasts after catching a fish if bait remains — loops until bait runs out or inventory is full
85% hook chance and 10% miss chance by default (configurable)
Companion speaks contextual lines: "I need a fishing rod...", "I need bait...", "I caught a {fish}!", "I can't find water nearby..."
Self-defense: companions abort fishing to fight enemies, then resume
All fishing parameters are fully configurable in the Fishing config section

Home Zone Fixes

Fixed home radius slider not working — the Set Home radius slider now correctly controls the companion's leash distance (previously hardcoded to 50m regardless of slider value)
Fixed companions getting stuck in a teleport loop when working outside their home radius — controllers now reset when the companion is teleported home, preventing them from immediately running back to the same spot

Hunt Mode Fixes

Fixed companions jumping after waiting at a dead animal's body during drop collection — the companion now stops moving cleanly when the collection delay expires instead of triggering a movement lunge

Bug Fixes

Fixed fishing rod being used as a combat weapon — fishing rods are now excluded from auto-equip weapon selection and BaseAI.CanUseAttack
Fixed fishing rod staying equipped after leaving fish mode — the rod is now unequipped on mode change
Fixed auto-equip overriding the fishing rod during casting — bait consumption no longer triggers a weapon swap mid-cast
Fixed companions jumping into water after casting — proactive jump and stuck recovery systems no longer trigger during fishing
Fixed companion not facing water before casting — the companion now rotates to face the water point and waits until aimed before starting the cast

1.1.7

Hunt Mode

Added Hunt action mode — companions actively hunt Boar, Deer, Chicken, and Hare within 20m
Hunting is ranged-only; companions maintain distance so prey do not flee out of range
If prey runs beyond 20m, the companion disengages and stays planted rather than chasing indefinitely
Respects home zone — companions with Stay Home enabled only hunt within the home radius
Self-defense still works: if an enemy attacks while hunting, the companion handles the threat first then resumes hunting
Combat AI view and hear range reduced from 30m to 20m to match hunt scan radius
Fixed companion using melee weapons at the start of a hunt: weapon switch cooldown is now reset on engagement so the bow equips on the first frame
Fixed companion closing in on prey (charging into melee range): circling behavior is disabled during hunt and a standoff distance of 8m is enforced so the companion stays at bow range

Companion Inventory UI

Fixed companion inventory grid floating too high and overlapping the name box
Fixed a missing row at the top of the inventory grid
Fixed panel background texture not matching the vanilla Valheim style
Fixed food slot backgrounds disappearing when the panel background was corrected
Reduced panel height by 10px and raised food slots for better proportions
Fixed top inventory row being partially clipped by the name input box

1.1.6

Companion Inventory UI

Fixed chest/container ghosting in the companion inventory by taking over companion container updates and blocking vanilla from pushing other container contents into the companion grid
Fixed gamepad focus leakage so the player inventory and companion inventory are no longer controlled at the same time
Adjusted companion inventory grid layout and positioning, including top-row highlight clipping fixes and a lower grid placement

Companion Stats

Increased default companion base stamina from 25 to 50 before food bonuses

1.1.5

Combat AI Overhaul

Replaced CombatController with CompanionCombatAI — a complete rewrite ported from vanilla MonsterAI's combat loop with proper engage/disengage lifecycle
Added 4 combat stances selectable from the inner radial ring: Balanced, Passive, Ranged, Melee
Combat stances persist to ZDO and can be changed mid-combat
Ranged stance now forces bow equip and prevents AutoEquipBest from overriding it
Melee stance forces melee weapons even when a bow is available
Passive stance completely disables combat engagement

Parry System

Companions now reactively block when an enemy swings within 8m
Shield is raised late into the enemy's swing for a natural parry look
Block timer is reset each frame during the parry window to guarantee a perfect block
After a successful parry (enemy staggered), the companion queues 2 rapid counter-attacks
Parry works across all combat stances — including while holding a bow

Ranged Combat Fixes

Fixed bow being unequipped after every arrow shot — AutoEquipBest's shield section was removing the bow from the left hand to make room for a shield (bows are two-handed)
Fixed Dverger heal behavior overriding ranged stance bow

Target Reservation

Companions no longer fight over the same work target — Farm, Smelt, Repair, and Homestead controllers now use static claim sets so each companion picks a different target

Deposit Filter

Companions depositing items into chests now keep their equipped gear, food, weapons, armor, and shields instead of dumping everything

Radial Menu

Added Despawn button to the outer radial ring with custom icon
Increased outer ring radius for better spacing

Bug Fixes

Fixed companions moving around while the radial menu or inventory panel is open
Updated Discord invite links

1.1.4

Companion Inventory Overhaul

Companion inventory is now a fixed 8-wide x 4-tall grid (was previously variable and sometimes mismatched between systems)
Added automatic layout migration for companions saved with the old inventory width — items are repositioned to fit the new grid instead of being lost
Removed the equipment side-panel from the companion UI (was only used with ExtraSlots)

Ranged Combat

Companions with bows now fire much more consistently — they pre-draw the bow between shots instead of waiting for the cooldown to finish first
Companions no longer constantly back away and reposition after every shot — they only retreat when enemies get dangerously close (within 5m)
Companions no longer jump around while trying to aim their bow, which was disrupting their shots
Companions in ranged stance who run out of arrows or lose their bow now fall through to melee combat instead of standing still and doing nothing

Melee Combat

Companions now follow up on successful parries much more reliably — the defensive block check no longer prevents counter-attacks during the parry window
Companions now consistently face their target during combat approach and while standing in melee range, fixing the rapid head-shaking animation that could occur when navigating around obstacles
Increased block grace period from 0.3s to 0.6s so companions hold their shield up long enough to actually block hits that land just after an enemy's attack animation ends

Self-Defense in Work Modes

Companions in forage, farm, smelt, and hunt modes now properly defend themselves when attacked — previously only gather modes (wood/stone/ore) triggered self-defense combat

"Come to Me" Command

The "come to me" command now properly forces companions to follow you even if they were set to Stay Home or had Follow turned off — previously they would ignore the command

Stamina

Companion stamina now properly drains while running during gather modes (foraging, harvesting, etc.) — previously the stamina system couldn't detect running when it was triggered by gather controllers
Swimming now also properly drains stamina using the same detection improvement

Harvesting

Stone mode no longer tries to mine ore veins — it now correctly skips copper, tin, and other ore deposits and only targets stone-dropping rocks
Stone mode now correctly recognizes rocks that use the "Ignore" damage modifier for chop resistance (some rocks were being skipped because they used a slightly different setting than expected)
Companions no longer sprint past their harvest target and jitter back and forth — they walk when close to avoid overshooting
Harvest stuck detection is now much faster (2 seconds instead of 12) so companions don't waste time pushing against unreachable targets

Farming

Companions in farm mode now properly detect and harvest mature crops — previously grown crops were being missed because they exist on a different layer than wild plants
Companions no longer keep holding the cultivator after farming ends — they now properly switch back to their combat gear when farming finishes or is interrupted

Repair

Fixed companions getting stuck in a back-and-forth pathing loop for up to 30 seconds when trying to reach a repair station — the AI now detects when it's running in circles and gives up after 6 seconds
Fixed companions sometimes holding a cultivator while walking to a repair station (caused by farming not cleaning up equipped tools)

Smelting & Homestead

Stuck detection for smelting and homestead tasks is now much faster (2 seconds instead of 15) so companions don't waste time pushing against obstacles they can't reach

Pathfinding

Companions no longer repeatedly jump back and forth over the same rocks in a loop — the AI now detects when jumping isn't making progress and suppresses it for 15 seconds

1.1.3

Inventory UI Overhaul

Removed all 3 Harmony patches on InventoryGui (Show, Hide, UpdateContainer) — eliminates mod conflicts with Equipment & Quick Slots, AUGA, Better Inventory, and other UI mods
Companion inventory now opens through vanilla's container system instead of intercepting it

AI Combat Improvements

Companions now lead running targets using velocity prediction instead of chasing their current position
Companions circle and reposition around enemies in melee range instead of standing still like a turret
Flanking now leads the target's predicted position instead of its current one

AI Pathing Improvements

Context steering direction is now temporally smoothed between frames for steadier, more natural obstacle avoidance

Bug Fixes

Fixed gamepad D-pad skipping rows in companion inventory — input was being processed twice per frame
Fixed gamepad starting on the wrong row when switching from player inventory to companion inventory
Fixed equipped item indicators not showing on companion inventory grid

1.1.2

New

Point-to-command for smelters and kilns — point at any smelter or kiln and press the command key to send your companion to tend it

Bug Fixes

Fixed companions only filling the first smelter or kiln when multiple are nearby — they now fill the emptiest one first and spread materials evenly
Fixed items disappearing when a companion was interrupted while carrying materials to a smelter — items are now properly tracked in inventory
Fixed companions planting seeds on top of wooden floors, walls, and other building pieces instead of on cultivated soil

1.1.1

New Features

Autonomous Farming

Companions can now be set to Farm mode via the radial wheel. They will automatically harvest ripe crops, collect the drops, fetch seeds from nearby chests, plant them on cultivated soil in a grid, and deposit harvested crops into output chests.

Supports all crops including modded ones
Only harvests player-planted crops — ignores wild berries, mushrooms, etc.
Needs a cultivator in the companion's inventory to plant; without one, they only harvest
Alternates between harvesting and planting every 30 seconds so neither task gets neglected

Repair Buildings Mode

A new toggle on the radial wheel. When active, the companion walks around and repairs any damaged building pieces within 50m. Works while following you or while staying home.

Restock Mode

A new toggle on the radial wheel. When active, the companion refuels nearby fireplaces, campfires, and torches that are running low — pulling fuel from its own inventory or nearby chests.

In-Game Settings Panel (F8)

Press F8 to open a settings panel where you can tweak all mod options without editing config files. Also accessible from the "Mod Options" button added to the ESC pause menu.

AI Improvements

Smarter Obstacle Avoidance

Companions now steer around walls, furniture, smelters, and other obstacles more smoothly when normal pathfinding can't find a route.

Half-Wall and Fence Navigation

Companions can now find their way around half-walls and fences by detecting them and looking for doorways and openings.

Movement Mirroring

Companions match your movement — walking when you walk, crouching when you crouch. They still run to catch up or during combat.

Better Stuck Recovery

When stuck behind obstacles, companions now try sidestepping in multiple directions. After repeated failures, they teleport to you.

Proactive Jumping

Companions automatically jump over small terrain ledges when they detect they're stuck on a step-up.

Hazard Awareness

Companions detect tar pits and deep water and actively try to reach shore. If they can't escape in time, they teleport to safety.

Water Avoidance

Companions check for water ahead and stop walking if their stamina is too low to swim safely.

Improved Pathfinding Over Water

Companions now use a pathfinding type that automatically routes around bodies of water.

Stuck Position Memory

Positions that keep getting the companion stuck are remembered for 30 seconds so they don't keep trying to go there.

Combat Flanking

If a companion gets stuck trying to reach an enemy, it tries approaching from the side instead.

Passive Resting

Companions now get the Rested buff just by standing near a fire inside a shelter — no need to tell them to sit down.

Radial Menu

Radial menu is 15% larger for better readability
Added Repair, Restock, and Farm segments to the radial wheel

Combat

Added crossbow bolt support
Defensive stance now only fights enemies that are directly attacking the companion or the player
Companions walk instead of run when retreating with low stamina, and use their shield to block
Companions can still hit enemies that get close during retreat
Companions walk to conserve stamina when approaching enemies below 25% stamina

Smelting

Furnaces are now filled emptiest-first so all smelters get materials evenly
"Nothing left to smelt" message only shows once per cycle instead of repeating
Smelter positions that cause stuck navigation are remembered and skipped

Harvesting

Fixed trees on slopes being missed when the companion swings
Drops are now picked up one at a time with a short pause between each for a more natural look
Fixed companions getting stuck trying to re-approach a tree at exactly the right distance

Death

A minimap marker now appears at the companion's tombstone when they die, showing their name

Bug Fixes

Fixed minimap marker not clearing after reloading a scene
Fixed MaxFoodSlots setting having no effect
Fixed new modes (Repair/Restock) being reset back to Follow after loading
Fixed restock fuel counter adding up across multiple fireplaces
Fixed proactive jumping activating when the companion is just standing near you
Fixed text not visible in the F8 settings panel
Fixed stamina draining while standing still during combat
Fixed Repair Buildings and Restock modes freezing after finding a target
Fixed Farm mode not starting immediately when selected — now starts right away
Fixed settings panel and radial menu not blocking player movement and camera

Localization

Added translation keys for all new features across all 22 languages

1.0.9

Bug Fixes

Fixed companions with Follow OFF still teleporting to the player when they get far away
Fixed Stay Home companions chasing enemies too far from home — they now stop chasing after 50m and return home

Balance

Homestead task timer increased from 15 to 60 seconds — companions spend more time on each maintenance task before switching

Death & Respawn

Fixed Auto Pickup, Wander, Commandable, Formation Slot, and Action Mode settings being lost when a companion dies and respawns

1.0.8

Bug Fixes

Fixed companions not picking up their tombstone after opening their inventory
Fixed tombstone recovery getting stuck when the path is blocked — they now teleport to it after 10 seconds
Fixed other UI interactions interrupting tombstone recovery
Fixed companions not respawning with follow target when they have a home position
Fixed tombstone items being lost when leaving and re-entering the area
Fixed invisible item slots in companion tombstones
Fixed companions not teleporting through portals when Stay Home is set — Stay Home only means "return here when dismissed", not "never leave"
Fixed companions not following through distance teleports when Stay Home is set
Fixed Hunt, Farm, and Fish modes not restoring follow after task completes
Fixed portal travel not clearing stale states from the previous zone
Fixed companion inventory grid overlapping food slots

New

Point at a companion tombstone and press the command key to send the nearest companion to loot it

1.0.7

Bug Fixes

Fixed companion duplication on death
Fixed companions teleporting through portals when set to Stay Home
Fixed gamepad radial menu opening inventory instead of the radial wheel when holding X
Fixed gamepad joystick direction being inverted on the radial menu
Fixed B button not closing the radial menu on gamepad
Fixed hover text showing "E" instead of the correct gamepad button
Fixed homestead chest sorting losing items
Fixed smelter output storage losing items

Gamepad / Controller

Improved gamepad hold detection for opening the radial menu
Left stick controls action modes, right stick controls combat stances
Added RB/LB to switch between companion and player inventory tabs
Added D-pad navigation between companion and player inventory grids

Performance

Reduced memory allocations in armor durability, projectile scanning, door caching, and UI sprite handling

1.0.6

Bug Fixes

Fixed Companions tab not appearing in Trader UI when Bounties mod is installed
Fixed controller radial menu not opening when holding X on gamepad

1.0.4

New

Press F7 while the companion inventory is open to drag and reposition it anywhere on screen — position saves across sessions

Bug Fixes

Fixed companion tombstone missing items
Fixed companion inventory UI glitching on death
Fixed controller radial menu not opening on gamepad

1.0.3

Bug Fixes

Fixed translations not loading

1.0.2

Translations

Added translations for all 22 Valheim-supported languages

Bug Fixes

Fixed game freeze on startup caused by localization initialization

1.0.0

Homestead Mode (Stay Home Automation)

Companions left at home (Stay Home ON, Follow OFF) now automatically maintain your base. They rotate between tasks every 15 seconds:

Repair — walks to damaged buildings and repairs them
Refuel — finds low-fuel campfires and torches and refuels them from nearby chests
Sort chests — consolidates split item stacks across multiple chests
Smelt — handles smelting duties alongside other tasks

All chest interactions are animated with open/close sounds.

Companion Respawn at Bed

Companions respawn at the last bed they slept in instead of the world spawn point
Home position and Stay Home state are preserved through death

Portal and Dungeon Teleportation

Companions follow you through portals and dungeon entrances
Stay Home companions are excluded — only active followers teleport

Minimap Markers

Companions appear on the minimap (only visible to their owner)

Skill Leveling

Companions level up skills over time, improving combat and gathering

Rested Buff

Companions get the Rested buff from resting near a fire or sleeping in a bed

Smart Gathering

Companions won't try to chop trees if their axe isn't strong enough

Night Sleep

Companions must be sleeping at night for the time-skip to work (matches vanilla behavior)

Drowning

Companions slowly drown if their stamina runs out while swimming

Ship Boarding

Point at a ship to tell companions to board — they find the ladder and climb on

Inventory UI

Authentic Valheim-style companion inventory panel (8x4 grid)
Equipped item indicators, split/drop modifiers, editable name, weight display, food slots

Radial Menu

Configurable radial menu key (default E)
Dual-stick gamepad support
Two-ring layout: outer ring for action modes, inner ring for combat stances

Combat

Removed backstab damage bonus against companions

Localization

Full translation framework integrated with Valheim's localization system
Translation files loaded from Translations/{Language}.json

Other

Voice audio system with gender-specific voice packs
Starter companion spawns automatically in new worlds
Speech lines customizable via speech.json
TraderOverhaul is now optional — mod works without it
Various bug fixes for smelting, female companion appearance, Stay Home modes, repair, and combat

0.1.1

Improved companion inventory UI to match vanilla Valheim style
Added configurable radial menu keybind
Added editable companion names
Added food slot display at bottom of inventory

0.1.0

Companions now teleport with you through portals and dungeons
Stay Home companions don't teleport — only active followers do
TraderOverhaul is now optional

0.0.9

Companions now teleport with you through portals and dungeons

0.0.8

Added voice audio system with gender-specific voice packs
Added starter companion that spawns in new worlds
Speech lines can now be customized via speech.json

0.0.7

Fixed companion getting stuck when trying to use smelters at the edge of reach distance

0.0.6

Improved controller support for radial menu
Added custom combat stance icons
Enlarged radial menu icons

0.0.5

Added combat stances: Balanced, Aggressive, Defensive, and Passive
Two-ring radial menu layout: outer ring for modes, inner ring for stances

0.0.4

Added Smelt mode: companions automatically fuel and fill kilns and furnaces from nearby chests
Companions collect smelted output and deposit it in chests
Added Smelt and Auto Pickup icons to the radial wheel

0.0.3

Added Forage mode: companions pick berries, mushrooms, flowers, branches, and stones
Follow is now an independent toggle that works alongside gather modes
Replaced procedural icons with custom PNG textures

0.0.2

Fixed Stay Home + Wander and Stay Home + Gather not working
Fixed various harvesting and repair bugs
Improved tree priority — fallen logs preferred over standing trees
Added Command toggle to radial wheel

0.0.1

Initial beta release
Hire companions from Haldor with custom appearance
AI with follow, combat, sleep/wake, and stuck detection
Harvest wood, stone, and ore
Auto-repair gear at crafting stations
Food system with 3 slots and auto-consume
Stay Home mode, auto-deposit, wander, auto-pickup
Door handling, directed commands, radial wheel, inventory panel
Full gamepad/controller support