Valheim
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
Downloads
482
Size
3.8MB
ADDatHost Valheim hosting
30% off

Living Companion (beta)

Living Companion adds one autonomous NPC companion to a single-player Valheim world. It follows you, fights (it dodges and has tactics for 163 creatures and for the bosses), gathers and mines, crafts from zero, smelts, hunts, farms, builds a camp, swims, survives its own death and goes back for its things. You talk to it with short typed phrases or with buttons. There is no microphone input.

The mod was written Russian-first. Since 0.2.0 the companion's replies, the window and the buttons are translated into English (about 6,200 texts), and most orders can be typed in English.

This is a beta. Read "Honest status" below before you trust it with a world you care about. Back up your worlds and characters first.

Requirements

  • Valheim 1.0.20 (Steam build 25909357). The mod also runs on 1.0.17. On any other game build it disables itself and writes an error to the log.
  • BepInEx 5.4.23 (x64). This package depends on denikson-BepInExPack_Valheim, which a mod manager installs for you.
  • Single-player only. In a multiplayer session the companion cannot be created and the network commands are closed.

Note: Valheim 1.0.20 changed the save format of the game itself. A world or character saved by 1.0.20 cannot be opened by 1.0.17. If you may go back to 1.0.17, keep a backup.

Install

With r2modman or the Thunderstore Mod Manager (recommended): install "LivingCompanion" for Valheim. The manager also installs BepInExPack_Valheim. Start the game from the manager.

Manually: install BepInEx 5.4.23 first, close the game, then create the folder Valheim\BepInEx\plugins\LivingCompanion\ and put Gtorens.LivingCompanion.dll (from the plugins\LivingCompanion\ folder of this package) into it.

Start the game once. The settings file BepInEx\config\gtorens.valheim.livingcompanion.cfg appears after the first start.

Set Valheim itself to English (Settings, Language): item and place names in your orders are matched against the names the game shows, and the mod language ([Localization] Language = auto) then switches the mod's own texts to English as well. en forces English, ru forces Russian.

First launch and how to talk

  1. Start Valheim with the launch option -console (Steam: Properties, Launch options), enter a single-player world, press F5 and type lc_spawn. One companion appears with an empty pack. A second one is not created.
  2. Walk up to it (within 3 m, clear line of sight) and press E. The window has seven tabs: Talk, Inventory, Tasks, Map, Rules, Rights, Notes (Ctrl+1 to Ctrl+7). Esc closes it.
  3. Give it real food, a weapon, armor and tools in the Inventory tab. The mod never creates gear from a command.
  4. Type one short phrase in the Talk line and send it:
    • One order per message, at most 240 characters. Case, a final ., ? or !, and a leading or trailing "please" are ignored.
    • Write numbers as digits: gather 10 flint, not "ten".
    • Up to three orders can be chained with then: chop 20 wood then go home. A plain "and" does not join orders.
    • New rights, item transfers and work orders need you within 3 m. From farther away, F7 opens a limited window and H a one-line message.
  5. If it stands still, ask why did you stop. It tells the reason (a missing right, tool, food, or an unsafe route).

The Tasks tab also has Quick commands: one button per common order. They need no typing.

Rights are separate from understanding a phrase. Campaign rights (long goals such as bosses) are all off at first: say allow campaigns once to switch the whole set on, or use the toggles in the Rights tab.

Main commands (English)

Each line is one message. Names in capitals are examples. The full list, checked by automated tests against the real parser, is in docs/MANUAL_EN.md of the project.

Group Phrases
Moving follow me, stay, wait for me, guard the base, set base here, go home, retreat, stop, continue, cancel the task
Combat rules do not attack first, you may attack first, shoot from range, fight in melee, cover me, hold fire, what is your stance
Questions what are you doing, why did you stop, what do you need, what can you do, how is your health, how many arrows do you have, what should we do next
Gathering gather 10 flint, gather 20 raspberries, chop 10 wood, mine 5 copper ore within 40 m, find silver, pick up items nearby
Big goals collect 100 wood and deliver it to the chest, sort the chests, goal status, cancel the goal
Gear and crafting eat, equip available gear, repair your gear, craft hammer, make bronze axe, confirm crafting
Smelting and food smelt 10 copper ore, smelt all ore, make 20 charcoal, cook 5 cooked meat
Building build a shelter, make camp, confirm building (house building is not reliable yet)
Campaigns and bosses allow campaigns, go get the bronze armor set, defeat Eikthyr, kill the next boss, clear the crypt, campaign status, cancel the campaign
Hunting and animals hunt deer, go hunting, tame a boar, feed the animals
Exploring survey the area within 64 m, scout the biome, give me your map, exchange maps
Death where did you die, go back for your things, confirm recovery
Sleep, portals, trade go to sleep, build a portal home, buy the megingjord, where is haldor
People trust Alex, who do you trust, transfer the companion to Alex

Item names must match what your game shows. Write them singular and without "a" or "the": craft hammer, not craft a hammer.

Cheats are ON by default

Some abilities are the mod's own functions, not stock Valheim mechanics. They are enabled by default and disclosed here. To turn one off, open BepInEx\config\gtorens.valheim.livingcompanion.cfg, section [Companion], set the key to false (for CarryMultiplier set 1) and restart the game.

Key Default What it does
SilentAim true The companion's own bow and crossbow shots at its target are perfectly aimed (target lead, arrow drop, no random spread).
MagicBullets true Its arrows and bolts steer onto the target in flight; they still cannot pass walls.
CarryMultiplier 2.5 Multiplies its carry weight (range 1 to 3, 1 = stock). Your own weight is not touched.
FastCraft true Its own crafting and repair at a station take about a quarter of the time.
WorkWithoutStamina true Outside a fight, work, running and jumping cost it no stamina. In combat stamina is honest.
EternalOwnFire true Fires the companion built itself never run out of fuel. Your fires are untouched.
NoWetCold true It ignores Wet and Cold (not Freezing in the Mountain and the Deep North).
ArrowsWithCap true Shot arrows and bolts are given back so a stack it already carries does not drop below 20, at most 100 per in-game day.
StationNoRoof true It may use a crafting station that has no roof. Fire, level and distance rules stay.

The full list of settings is in the project's docs/CONFIG_REFERENCE.md.

Honest status

  • Tested offline: the project's test suites and the verification run (Verify 100, OFFLINE PASS) against Valheim 1.0.20. That checks that phrases are understood and that the rules hold; it does not play the game.
  • Tested in the game (Valheim 1.0.20, scripted test worlds, runs 116 to 118): 69 of 79 non-boss scenarios passed. The Eikthyr and Elder fights passed in runs 111 to 115 on 1.0.20. The other 10 scenarios failed or were not tested.
  • Known open: coming back out of a dungeon, passing a narrow obstacle gap, an explore-biome trip being refused, and combat against a pack is slow.
  • House building is NOT reliable yet.
  • Everything else (the other building orders, portals, trade, taming, raids, dungeons, the later bosses Bonemass, Moder, Yagluth, the Queen and Fader, fishing, brewing, ground work) is tested offline only or only partly. Treat it as an experiment.
  • The companion can still get stuck, give up, or die. A world you cannot afford to lose should be backed up.
  • If the mod language is English and you still see a Russian line, or a hint suggests a phrase that does not work, please report it.

How to report a bug

Send Valheim\BepInEx\LogOutput.log from the session (with a mod manager: the profile's BepInEx\LogOutput.log) and, in a few lines: the exact phrase or button, where you were (biome, near what), what you expected, what happened, and the companion's reply. A screenshot of the window helps. If it is stuck, say what why did you stop answered.

See CHANGELOG.md for what is in this release.

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.