🧔 Quad's Companion

A viking companion, a follower NPC who plays like a player: comes on your adventures, fights beside you, lives its own life at home, and gets better as it goes. Levels up with EpicMMO.

Source code · Report a bug · Discord

✨ Features

A viking companion, a follower NPC who plays like a player: comes on your adventures, fights beside you, lives its own life at home, and gets better as it goes.

• Press J to summon your companion or open its menu (E on it too). Hold J: your companions come with you, or go home.
• Point and press H: at an enemy (they attack it), a tree, rock or plant (it works it, and the thing glows with a note above it while it does), your chest (it puts its things in), a cart (it pulls it), the ground (it waits there), the sky (it comes back).
• "Let it decide": it reads what you are doing. It fights beside you, mines or chops beside you, and keeps close while you explore; where a place is too dangerous for its gear it tells you and only defends.
• It fights like a player: timed parries (it learns each creature's swing), rolls out of sweeps and shots, joins in on what you are hitting and gets round behind it, pulls enemies off you when you are hurt, sneaks up for backstabs, uses weapon specials, hits and steps back against heavy hitters, drinks the right mead, remembers what has killed it, kites with its bow (leading moving targets, allowing for arrow drop), and fights bosses with care (flanking, keeping its distance, drinking early).
• Follows you through portals, into crypts and caves, onto boats and through doors; it steers round stakes and fires, jumps streams and gets itself unstuck.
• Home and away by itself: when you head out it comes along; back home it lives there again. It takes a free bed and empty chests by itself.
• At home it works toward better gear: picks its next upgrade, gathers exactly what it needs (trips further out when nothing near has it), makes bronze and the like, crafts and upgrades at your workbench and forge.
• It hunts, cooks on your cooking stations, keeps its fires burning, repairs its gear and your base, sleeps in its bed at night, and sorts what it brings home into the right chests (with QualityOfLife).
• While you are away it catches up on all of it, and tells you what it did when you return.
• Needs like a player: food for health and stamina, skills that rise, stamina, carry weight, weather, rest.
• Its gear has slots of its own (weapons, shield, bow and arrows, axe, pickaxe, hammer, armour, and three food slots it keeps filled): change them from its menu from anywhere. When it falls everything goes into its tombstone, as a player's; it wakes wearing its gear again when its tombstone is near, else it goes back for it.
• Its bag shows beside your inventory: drag items between you. Hotbar keys give it food, potions or gear.
• Between jobs it acts like a person: sits by the fire or in a chair, gets out of the rain, takes a stroll, sits with you when you rest, waves when you come back, cheers after a big fight and answers your emotes.
• A journal of its life, small talk that fits the moment, and chat messages about what it is up to.
• Its menu: status, stats and every skill, orders, home, gear, looks and journal, and a Companions tab (when you can have more than one) to switch between your companions, release one or add another. Talk to it in chat: "Rádvar, follow me", "Rádvar go home".
• With EpicMMO System it earns experience and levels from what it kills, chops, mines and picks, and its kills count for you too, as a tame's.
• With PartyHud it shows in the party panel (face, health, food); it shows on the map, and where it fell is marked for everyone.
• Multiplayer: it belongs to whoever summoned it. Everyone in the world needs the mod (the host too), or the game deletes saved companions.

📸 Screenshots

Your companion at your side out in the Meadows

Its menu: what it is doing, its food, what it has done

Its gear slots and its bag

Its bag and gear beside yours when you open your inventory

🎮 How to use

Key	What it does
J / hold J	Summon your companion or open its menu / your companions come with you, or go home
H	Point: attack it, chop or mine it (a whole patch), pick it up, put its things in that chest, pull that cart, wait here

🧩 Other mods

Goes well with

Party HUD	Gear Slots	Arena	Bounty Board	Dungeons

Known clashes: none known. (Fixed in 0.25.1: StarLevelSystem's spawn multiplier copied companions, a bald "Companion" belonging to nobody, and it gave them star levels; it now leaves companions alone, as it does players. Fixed in 0.25.0: with ExtraSlots its bag panel covered ExtraSlots' equipment panel; it now goes beside it.)

Better together

• With Quad's Build Orders: it builds your planned ghosts near its home (a home duty, Build our plans), paying from its own bag and your chests, never from you.
• With Quad's Quality of Life: what it brings home goes into the chests you assigned with K.
• With Quad's Party HUD: it shows under you in the party panel (face, health, what it's doing).
• With Quad's Skal Tavern: companions within 12 m count as drinking partners for a Skål!
• With EpicMMO System: companions earn experience and levels from what they kill, chop, mine and pick, on the server's EpicMMO curve, and their points go where they fight (Strength or Intellect, Body, Vigour); their kills count for you too, as a tame's, and keep their drops. CompanionExp in com.quad.aicompanion.more.cfg sets how much they earn (0: off).

Found a clash with another mod? Tell us which one and what happened.

👥 Multiplayer

Who needs it: Everyone in the world, the host too: without it the game deletes saved companions.

It adds the companion (a new creature the world saves). Restart the game after updating so it registers cleanly: a companion whose area loads while it is not registered is deleted by the host, with everything it carries.

Each companion belongs to whoever summoned it. Everyone sees each companion's state, and where one fell is marked for everyone. It never touches a chest someone else has open.

The host decides: how many companions, what they do while you're away, respawn time, base health and stamina, when they eat, starting skill, and (with EpicMMO) how much experience they earn. While you play on their world their values replace yours (your file isn't changed); a host without the mod leaves everyone their own.

🌍 Languages

English, Русский (Russian), Deutsch (German), 简体中文 (Chinese), Português do Brasil (Portuguese), Español (Spanish), Français (French), Polski (Polish), Türkçe (Turkish). It follows the game's own language setting.

The translations were made with AI, so a few words may be off. To correct one, or to add your language, put a file in BepInEx/config/translations/com.quad.aicompanion/ named after the game's name for the language (German.json, Italian.json, Japanese.json...) with only the lines you change, copied from English.json (it wins over the built-in one). Or tell us the better words and we'll put them in for everyone.

⚙️ Settings

In BepInEx/config/com.quad.aicompanion.cfg, made the first time the game runs with the mod. r2modman and Thunderstore Mod Manager edit it under Config editor.

Companion

Setting	Default	What it does
MaxCompanions	3	How many companions each player can have. In multiplayer the server's value applies.
WhileAway	Mild	What a companion living at home does while nobody is near. It always catches up on its work when you come back. Mild: it also fights off a few creatures and keeps their drops, and never falls. Real: those fights can go badly and it can fall. Off: work only. In multiplayer the server's value applies.

General

Setting	Default	What it does
MenuKey	J	Tap: your companion's menu (or the summon panel). Hold: all your companions near you come with you, or go home. E on a companion opens its menu too.
CommandKey	H	Point at something and press it: an enemy (they attack it), a tree, rock or plant (it works it), your chest (it puts its things in), its tombstone, a free bed (its bed), the ground (it waits there), or the sky (it comes back).

Companion

Setting	Default	What it does
FightRange	12	It fights enemies that come this close (in metres) to it or to you. In the menu: Orders.
ShowDecisions	true	Show what it decides in a fight above its head. In the menu: Brain.
RespawnSeconds	30	Seconds after falling before it wakes in its bed (or beside you). In multiplayer the server's value applies.
BaseHealth	25	Its health before food, as a player's (25). In multiplayer the server's value applies.
BaseStamina	75	Its stamina before food, as a player's (75). In multiplayer the server's value applies.
EatBelowPercent	10	It eats a food it is already under again once its time left drops below this percent (the game allows it from 50). Lower saves food: a meal lasts 80% of its time instead of 50%, and its effect weakens a little towards the end. In multiplayer the server's value applies.
StartingSkill	0	The skill level a new companion starts at (a new player: 0). In multiplayer the server's value applies.

EpicMMO

Setting	Default	What it does
CompanionExp	1	With EpicMMO System installed: the experience a companion earns from its kills and its work (chopping, mining, picking), as a multiple of what a player gets for them (EpicMMO's RateExp counts too). 0: companions don't level up, and their levels give nothing. Their kills count for their player as a tame's whatever this is (EpicMMO's "Tames give XP on Mob kill"). In multiplayer the server's value applies.

🤖 Made with AI

Made with the help of Claude (Anthropic), with Claude Code: designed, written and checked together, and tried in the game.

💬 Join us on Discord

Come hang out with the people who make and play these mods. In the Quads Lab Discord you can:

• 🛠️ Get help and report bugs straight to us
• 👀 See new mods first, and help test them before they're released
• 🗳️ Suggest ideas and vote on what we make next
• 🏰 Share your builds, bases and arena runs
• 🤖 Talk AI coding and vibe coding with people building things with AI, the way these mods are made

Join the Quads Lab Discord →

🧪 About Quads Lab

Quads Lab is where Quad H (HardHeadHackerHead) builds software with AI, of every kind: these Valheim mods are one of its projects. Each mod is designed by a player, written with Claude Code and tested in our own world, with bobisme as our tester.

• 🌐 quadslab.io
• 🧰 All Quads Lab mods on Thunderstore
• 💻 Source code on GitHub
• 💬 Discord
• ☕ Buy me a coffee
• 🐞 Found a bug? Open an issue on GitHub

☕ Support my mods

Every Quads Lab mod is free, and it stays that way. If one of them made your game better and you'd like to say thanks, a coffee helps me make new mods and keep improving the ones you already play. It's 100% optional, and always appreciated!

☕ Buy me a coffee →

📜 Recent changes

• 0.25.1 With StarLevelSystem (MidnightMods): a bald, nameless "Companion" that belonged to nobody ("someone's companion", no map or party marker) could turn up beside your companions. StarLevelSystem's spawn multiplier (1.1 in every biome by default) copied about one new creature in ten, a companion too, each time one was summoned, woke after a fall or was brought back from the menu, and the copy had nothing of it: no name, no player, no looks. StarLevelSystem now leaves companions as it leaves players: it never copies one, never deletes one (a spawn rate below 1, or a biome's "spawns disabled" list, would have removed a companion with all it carried), and gives them no star levels, modifiers (its Splitter made copies of one as it fell) or biome stats (half as much again from poison, by default). Stars or a bigger size it already gave a companion are taken back. Copies already in your world are removed when their area loads, and anything someone put in one's bag goes into a tombstone where it stood. Without StarLevelSystem nothing changes.
• 0.25.0 With EpicMMO System (WackyMole): companions earn experience and levels. A companion earns experience as a player does there: from what it kills, at EpicMMO's own rates for each creature, and from its work (each tree it fells and each hit on a log, each hit on a rock or ore, a stump or the like once it breaks, each pick: EpicMMO's own values and switches for players); while you are away, for what it fights, hunts and gathers. All on EpicMMO's level curve, and its points go where it fights: Strength with weapons or Intellect with staffs (the same points, as it uses one at a time), then Body and Vigour, at the server's EpicMMO values per point (more damage, health, stamina and armour). Its menu shows its level, its experience and what its points give (Stats). When it falls it loses part of its way to the next level, as a player does there. Its kills now count for you too, as a tame's do (EpicMMO's "Tames give XP on Mob kill"), and keep their drops: with EpicMMO's defaults a creature a companion finished dropped nothing, and nobody got experience for it. New setting EpicMMO / CompanionExp (the server's in multiplayer): how much a companion earns, as a multiple of what a player gets (1); 0 switches companion levels off. What it earns is saved every 10 seconds (or at a new level), as its skills are, so a companion mining is not sending its save to every player with each hit. Without EpicMMO nothing changes. Also, with a controller: picking up an item in your inventory while a companion's bag showed beside it put the item straight into the companion's bag (its panel took every A press along with yours). Its bag is now a panel of its own, reached with LB/RB as a chest's is, and A only acts on the panel you are in. With ExtraSlots its bag no longer covers ExtraSlots' equipment panel: it goes right of it (or under the crafting panel, or under it, when there is no room), and follows when you drag that panel.
• 0.24.7 A Companions tab in the companion's menu (when the server allows more than one companion): all your companions in one list, each with Open (to its menu), Call, and Release forever (press twice; its gear must be taken out first, and a released companion can't be brought back), and the summon panel to add another. It was only reachable when no companion was near you.

Every change is on the Changelog tab.