REPOCompanions
Summon your own custom companion in R.E.P.O.!.
About this mod Author’s original text
REPO Companions
Bring your own custom companions into R.E.P.O.! This mod allows you to load 3D models with simple animations as companions that follow you around the game world using direct transform manipulation.
Features
- Load Custom Companions: Loads AssetBundles named companion_1, companion_2, etc. from the same folder as the plugin DLL.
- Configurable Selection: Choose which loaded companion index to use via the config file (compatible with in-game config editors).
- Summon/Desummon: Toggle your selected companion's presence using a configurable key.
- Simple Follower Movement: Summoned companions follow the player character directly, attempting to stay on the ground via raycasting. Will clip through obstacles.
- Basic Animations: Supports "Idle" and "Moving" animations based on movement state.
- Configurable Settings: Adjust summon key, follow distance, speed, rotation, teleport distance, and ground offset via config.
Installation
- Install BepInEx
- Download and extract this mod
- Place the contents into your BepInEx/plugins folder
- Launch the game
Usage / Controls (Defaults)
- C Key: Press to Summon/Desummon the companion specified by the Companion Index config setting.
Configuration
A config file will be generated at BepInEx/config/com.BellaModsGames.REPOCompanions.cfg.
- [Controls]
- Spawn Key: Key to summon/desummon. (Default: C)
- [Selection]
- Companion Index: Select the number corresponding to the companion_X bundle file you want to load (e.g., 1 for companion_1, 2 for companion_2). The mod requires companion_1 to exist for basic validation but will load the selected index if present. (Default: 1)
- [Behaviour]
- Follow Distance: Target distance companion tries to maintain behind player.
- Follow Speed: How fast the companion moves.
- Teleport Distance: If further than this, companion teleports.
- Rotation Speed: How fast the companion turns.
- Ground Offset: Small vertical distance to keep companion above detected ground.
Known Issues
- Companions WILL clip through geometry and obstacles due to not using NavMesh pathfinding.
- Ground snapping might not be perfect on complex terrain or stairs.
- Multiplayer is not supported.
- No interaction logic is included.
Compatibility
Patches PlayerController.Update. Should be relatively compatible but avoid mods that heavily modify player input or add complex follower systems.
Credits
- Framework created by BellaModsGames
Credits
Created by BellaModsGames
Commissioned Mods
I take commissions for custom mods! If you have an idea for a mod you'd like to see created, feel free to contact me:
- Discord: bellamodsgames
I can create custom gameplay mechanics or systems tailored to your specific requirements.
Version History
1.0.0
- Initial Release.
- Uses direct transform manipulation for following (No NavMesh).
- Supports custom AssetBundles (companion_1, companion_2, etc.).
- Configurable summon key, follow behaviour, and companion index selection.
- Basic Idle/Moving animation support via Animator Speed parameter.
- Ground snapping via Raycast.
- Teleportation if companion falls too far behind.
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.
Install these first, or the mod will not work: