Companion Training

Companion Training turns one existing tamed two-star creature into a persistent named companion. It keeps Valheim's native tame AI wherever possible and adds progression, recovery, mounted travel and personalisation around it.

Current companion species: Boar, Wolf, Lox, Asksvin and Moose.

Creating a companion

Use Ctrl + Use on a tamed two-star supported creature. Choose its name and coat colour, then validate the selection.

Only one active companion is allowed per player. Selecting another retires the previous companion. A retired animal becomes a normal vanilla tame again and loses its pin, recall and Companion commands, but keeps its name, colour, trained size and accumulated statistics. It can be selected again later.

Main features

• Native Follow/Stay interaction through the configured Use key.
• Native pet action moved to AltPlace + Use.
• Permanent dynamic map pin for the active companion.
• Hidden offensive and defensive progression earned by dealing and receiving damage.
• Species-specific health, armor, damage and size progression.
• Mortal companions: the butcher knife and ordinary combat can kill them.
• Passive regeneration after one minute out of combat.
• Ctrl + Use consumes compatible taming food and restores 10% maximum health per second for five seconds, with a one-minute cooldown.
• Feeding also works while riding without dismounting; Use alone still dismounts.
• Crafting-station anchor and recall button for lost companions.
• Portal, teleport and dungeon transfer for a nearby active follower.
• Boat boarding through unique free passenger points, with lightweight crossing visuals to avoid destabilising ships.
• Mounted jump, sprint and direct movement controls.
• Player weapon combat and seated animations through OdinMountedCombat.
• Protection for allied players, tames, Dvergr, allied constructions and Master Rings alliances.

Requirements

• BepInExPack Valheim 5.4.2351 or newer compatible 5.4 build.
• GoblinHeim ValheimCore 1.0.3.
• OdinMountedCombat 1.0.1.

TameRidingOverhaul is not required and should not be installed alongside the current mounted controls.

For improved movement of all tamed creatures, NicoMods TameAI is recommended but remains optional.

Multiplayer

Install the same version on the server and every client. Companion identity, ownership, progression, colour and recovery data are stored persistently through Valheim's networked world data.

Current scope

The current build is intended for active playtesting on Valheim 1.0.20. Automatic long-distance recovery, boat travel and mounted movement are present, but unusual terrain or modded creatures may still expose pathfinding and animation edge cases.

Changelog

0.6.7

• Add the configurable native Valheim companion command wheel (default Y) with Stay, Follow, Heal, Come Back, Run and Return Home orders.
• Add personal companion beacons, workbench recall, persistent companion identity/map pin and three-workbench recovery history.
• Recall companions through an authoritative 20-metre clear-ground search and reject roofs, fire, lava and blocked body space.
• Keep one exclusive personal companion while leaving ordinary Vanilla mounts and tame packs untouched.
• Add guarded Follow, Stay and mounted combat behaviour through the shared TameAI/Vanilla authority contract.
• Keep neutral Dvergr allied while allowing aggravated Dvergr to be treated as hostile through Vanilla rules.
• Make recall server-authoritative, validate beacon/workbench prefab types and reject malformed requests.
• Remove the client-side pre-emptive teleport and wait for the server result.
• Clear cached defence ranges when companions die or unload and remove unused ship-anchor bookkeeping.

0.6.6

• Synchronizes embarked ship and passenger slot for every client.
• Gives companions from different players distinct free attachment points.
• Replaces the real embarked model with the same lightweight icon on every client and disables competing remote collision simulation.
• Makes mounted Ctrl + Use feeding independent of the timing of vanilla's dismount path.

0.6.5

• Removes the forced 100-metre enemy alert range from companions.
• Restores each species' native combat detection distance in Follow and Stay.
• Keeps player tracking independent through the existing Follow, teleport and recovery systems.

0.6.4

• Enforces one active companion per player across every supported species.
• Retired companions return to vanilla tame behaviour while retaining their name, coat, size and trained statistics.
• Removes retired companions from pins, recall, teleport/recovery, feeding and further skill progression.
• Allows a retired tame to become the active companion again without losing accumulated skills.

0.6.3

• Adds mounted Ctrl + Use feeding without dismounting.
• Keeps Use alone as the normal dismount command.

0.6.2

• Adds direct forward, reverse and progressive left/right mounted controls.

0.6.1

• Replaces embarked companion bodies with lightweight passenger images to prevent large creatures from destabilising boats.

0.6.0

• Restores companion mortality and permanent death.
• Adds delayed passive regeneration and food-based healing.
• Adds unique boat passenger points and automatic disembarking.