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

Source code · Report a bug · Discord

✨ Features

• 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. Talk to it in chat: "Rádvar, follow me", "Rádvar go home".
• 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

🧩 Other mods

Known clashes: none known.

Works with our mods

• Quad's Build Orders: a home duty, Build our plans: it builds your planned ghosts near its home, paying from its own bag and your chests, never from you.
• Quad's Quality of Life: what it brings home goes into the right chests by your chest assignments (K).
• Quad's Party HUD: it shows under you in the party panel (face, health, what it's doing).
• Quad's Skal Tavern: companions within 12 m count as drinking partners for a Skål!
• Our chest mods (Quad's Craft From Chests, Quad's Build From Chests, Quad's Feed From Chests, Quad's Ledger Chest) never take from its bag or its own chests.

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

General

Companion

🤖 Made with AI

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

🧪 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
• 🐞 Found a bug? Open an issue on GitHub

📜 Recent changes

• 0.24.0 Now in your language: English, Russian, German, Chinese (Simplified), Portuguese (Brazil), Spanish, French, Polish and Turkish, following the game's own Language setting. The game's own names are used for its things (items, creatures, lands, stations). The translations were made with AI: to correct a line, or add a language, put a file in BepInEx/config/translations/com.quad.aicompanion/ named after the game's name for the language (German.json...) with only the lines you change, copied from translations/English.json on GitHub. The companion's status, journal, missions and what it says are now kept as data, so each player reads them in their own language; old saves still load and show their English text. Players on a server should update together: a player on an older version sees stray characters in statuses and chat lines from a newer game. The journal's counts from before are named in your language too and join the new ones, and trees, logs and stumps go by the game's own names (a stump was called "stubbe"). Headings and status lines no longer vanish in Chinese.
• 0.23.0 The companion menu (J, or E on your companion) now looks like part of the game: the crafting screen's wood, buttons and tabs, the inventory's own item slots with the game's tooltips, its scrollbar and fonts, and the game's own text box for names. Everything it did is still there, in the same tabs; health, stamina, timers and skills move as they change. E or J closes it, as well as Escape. Fixed: your companion no longer takes a Ledger Chest, the Obliterator or the Arena's chests as its own, or puts things in them or takes from them; one that already took one lets go of it the next time you're near its home, and says so (nothing in it is moved, so check an Obliterator beside its bed before you pull the lever).
• 0.22.2 A clearer page: what it does, who needs it in multiplayer, which of our mods it works with, and where to report a bug. The game itself is unchanged.

Every change is on the Changelog tab.