RepoBots

Adds player bots to R.E.P.O. They show up as actual players in your lobby, with their own colors and names, and they play the level with you. They're not perfect and they're definitely dumber than a real person, but they're pretty fun to have around when you don't have a full lobby (or any friends online lol).

There are up to 10 of them: Bolt, Rusty, Sprocket, Gizmo, Widget, Cog, Pip, Noodle, Tater and Dingus.

What they actually do

They split up and explore the level, checking rooms nobody's been in yet. When they find loot they carry it to the extraction point, or to a cart if one's close. They turn on extraction points themselves if none is running. They're careful with fragile stuff, they walk slower with a vase, and they set things down instead of just dropping them. They'll still break stuff sometimes, same as you.

If something's too heavy for one bot they'll ask for help, and another bot (or you) can grab the other side. If you're struggling with something big, a nearby bot will come help you carry it.

They use carts. Each round a bot might decide it really wants the cart. It brings the cart over to where the loot is, fills it up and pushes it to extraction. They try not to run you over with it.

They open chests, cabinets, wardrobes, fridges, lockers and safes looking for loot. They also open doors when they need to get through.

They can't see through walls. Bots only know about monsters they've seen or heard, and only remember loot they've actually looked at. They share what they know with bots nearby. They also forget where you are if they haven't seen you in a while, and sometimes they'll pull out the map to check where they're going.

Monsters

Bots hide when something dangerous is coming. They duck under tables, hide behind stuff, or just run if it's already chasing them. They freeze and stay quiet around the Huntsman, look away from the things you're not supposed to look at, keep away from the duck, and run from the really deadly ones like the Robe. They grab and smash gnomes. If they get hurt standing in something, they get out of it.

They do die, a lot sometimes. That's kind of the game.

Dying and reviving

When a bot dies it tells everyone where its head is. When you die, a bot will grab your head and carry it to an extraction point so you come back when it finishes. If there's a cart close by and the extraction is far, they put your head in the cart and the cart goes straight to extraction. If there's no extraction to use yet, they bring your head to someone instead.

They also neck heal people who are hurt. How generous they are depends on the bot, some will give you a lot and some barely give you any.

If every real player is dead, the bots get 2 minutes to revive somebody before the level fails. You can change that in the config (ReviveGiveUpSeconds), or set FailWhenPeopleDie if you want the level to end right away like normal.

End of the level and the shop

When the extractions are done they head to the truck. If a bot is the last one in, it hits the truck screen so you can leave. If the truck leaves without them they count down in chat and then die, just like a person would.

In the shop they buy what the team actually needs, like health packs for people who are hurt, crystals when the charging station is low, and upgrades. They only spend their share of the money and never go over what you can afford. You still press the buy button. When they're done they just hang around the shop and look at stuff until you're back in the truck. On the ride between levels they use the upgrades and health packs they picked.

Talking

Bots talk out loud with the game's text to speech voice and type in chat like players do. They call out monsters, ask for help, complain, brag about loot, and talk to each other. Every bot has its own personality (brave or jumpy, greedy, helpful, chatty, clingy or a lone wolf, careful or clumsy) that changes how it plays and how it talks. Some of them use a lot of slang and make typos. Personalities and colors stay the same per save file, and bots remember how many times they've died on that save.

Telling them what to do

Type in chat with a bot's name, or "everyone". If you don't say a name, the nearest bot that can hear you does it. You don't have to say it exactly like this, they understand a lot of different ways of saying stuff:

• bolt follow me
• rusty come here
• everyone wait here
• everyone to the truck
• go there (they go where you're looking)
• grab that / bring me that
• put that in the cart
• bring the cart here / take the cart to extraction / drive the cart
• revive bolt / rusty bring bolt back
• turn on the extraction
• open that chest / check the cabinets
• check the map
• heal me
• help (if you're carrying something heavy)
• dont buy anything / buy health
• do your thing (back to normal)

You can also ask them stuff, like "where are you", "what are you doing", "how much money", "any monsters", "find anything good" or "how many times have you died".

Voice commands

You can just say all of that out loud instead of typing. It uses Windows speech recognition, so it's Windows only, and you need "Online speech recognition" turned on in Settings > Privacy & security > Speech.

Important: Windows only listens to your Windows default mic, not the one you picked in REPO. If your default is something like Voicemod or Steam Streaming Microphone, it won't hear you. The mod will tell you on screen if your Windows default mic doesn't match your game mic. To change it, press Win+R, type mmsys.cpl, go to the Recording tab, right click your real mic and pick Set as Default Device. That works even if Windows isn't activated.

It only listens while there are bots around and your in-game mic is open, so mute and push to talk still work.

Multiplayer

Everyone in the lobby needs the mod, and everyone needs the same version. Only the host's settings matter for the bots. Players without the mod will have problems because the game deletes the bots on their end.

Singleplayer

Singleplayer works too. It starts a private offline game in the background so bots can play with you, and nobody else can join. If you want the normal singleplayer back, turn off SingleplayerBots in the config.

How many bots

On the lobby screen the host gets ADD BOT and REMOVE BOT buttons, plus a line showing which bots are in. You can also set Count in the config, press F8 to add a bot or F9 to remove all of them. The bot count is saved per save file.

Config

The config file is BepInEx/config/dcz.repo.playerbots.cfg, or you can edit it in your mod manager. Almost everything can be turned off if you don't like it:

• BotsExplore, BotsHaul, BotsUseCarts, BotsOpen, BotsShop, BotsFlee
• BotsTalk, ChatCommands, VoiceCommands, VoiceShowText, BotSlang, Personalities
• GentleCarry (careful carrying and setting things down)
• MaxCarryMass (how heavy stuff can be before a bot won't pick it up alone)
• CartFanChance (how likely a bot is to take over the cart each round)
• RealPhysics and KeyboardMouse (bots move with a real physics body and "keys", like a player)
• BotsDive (off by default, bots roll away from monsters)
• FailWhenPeopleDie and ReviveGiveUpSeconds

There's also an optional ClaudeApiKey setting for the host. If you put an Anthropic API key in there, bots can answer anything you say to them, still only using what they actually know. Each reply costs a tiny bit on your API account. Leave it empty and they just use their built in replies, which is how most people will play it.

The key isn't in the normal config file, so it doesn't get shared when you share your mod profile with someone. It's in its own file in the game's save folder: %USERPROFILE%\AppData\LocalLow\semiwork\Repo\RepoBots\RepoBots.secrets.cfg (the file shows up after you start the game once with the mod). If you had a key in the old config, it gets moved over by itself.

Known stuff

Bots are still bad at some things. Really big or awkward items, tight doorways and some stairs can still trip them up, and they'll occasionally get stuck on something and need a minute to figure it out. They're a lot better than they used to be though. If something's really broken, the BepInEx log (LogOutput.log) has a lot of info about what each bot was doing.

Changelog

0.22.5

• the Claude API key moved out of the BepInEx config into its own file in the game's save folder, so sharing a mod profile can't leak it

0.22.4

• the voice mic check uses a normal Windows audio call now instead of running a script in the background

0.22.3

• bots are way better at carrying big stuff together. The one in front used to freeze forever thinking the item was stuck
• if the bot in front lets go, the helper takes over instead of dropping it
• the helper walks with you instead of trailing behind, and stops pushing its end into the floor

0.22.2

• carrying things up and down stairs works a lot better, items don't dig into the steps anymore
• fixed bots randomly stopping because they thought there was a pit in front of them
• voice commands now tell you when your Windows default mic is the wrong one

0.22.1

• bots spawn on the actual player spawn points instead of all around the host, and they spawn way faster
• bots give anyone carrying loot more room so they stop bumping into them and breaking stuff
• bots don't put heads in your cart when the extraction is right there

0.22.0

• bots don't walk into death pits anymore
• bots hang out in the shop instead of staring at the truck screen the whole time
• bots put heads in a nearby cart if the extraction is far away