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

1. Install BepInEx
2. Download and extract this mod
3. Place the contents into your BepInEx/plugins folder
4. 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.