Gruffy AI Companion

An AI teammate for when you're short a player. Gruffy is built from your own player model, moves and animates like a player, talks with the game's text-to-speech voice, and has opinions about all of it.

What he does

• Plays the game with you. Scouts rooms on his own, opens cabinets, carries loot carefully to the cart. He only knows about items he (or you) has actually seen.
• Runs for his life. He sprints away from monsters on a route that doesn't pass them, then hides properly: under beds and tables, in corners, inside lockers and wardrobes. He leaves passive monsters alone (the duck, Bella on her tricycle, little Elsa) until they're set off.
• Hunts gnomes. Gnomes wreck the loot, so he beams them up and slams them into the floor.
• Can die, and can be revived. Monsters hurt him like a player. Throw his head into an extraction point while it cashes out to bring him back.
• Hero mode. If everyone dies while he's alive, the level doesn't end. You spectate him while he loads everyone's heads into the cart, tows every loaded cart into the extraction point, and cashes out to revive you. If the cart gets wedged he unloads it by hand. Once every extraction is done, he takes the heads to the truck and drives off to end the level. He'll talk trash the whole time, and he will never let you forget it.
• Talks. Original lines, plus dad jokes (light, dark and dirty).

Playing with friends

Everyone needs the mod installed (same version). Then:

• The host's Gruffy joins the lobby, and every player with the mod sees him, hears him talk, and sees his grab beam.
• He follows the host around, but helps the whole team: hauling loot, opening cabinets, smashing gnomes.
• His head can be grabbed by anyone when he dies. Throw it into an extraction point during a cash-out to revive him.
• Hero mode works in lobbies too: if every human dies while he's alive, the run isn't over. Everyone spectates him while he loads all your heads into the cart, tows it to an extraction point, and cashes out to revive you.
• Only the host's settings matter for his behavior. Turn AllowInMultiplayer off on the host to keep him out of group games.
• Players without the mod can't see him. They just see loot floating to the cart.

Controls

• MenuLib (installed with this mod): a "Gruffy: ON/OFF" button on the main menu, lobby and pause menu.
• F8 in game toggles him (configurable).

Works well with

• ExtractionPointConfirmButton by Zehs: in hero mode Gruffy presses the confirm button himself, but only when every human is dead and the quota is met.

Config

BepInEx/config/gruffy.aicompanion.cfg (created on first launch): distances, speeds, how much damage he takes, hero mode, voice pitch, joke settings (JokeChance, DarkJokes, DirtyJokes, TrashTalk), gnome smashing, color and more.

His lines are in gruffy_speech.json next to the mod's DLL. Edit it to change what he says.