REPO Portals

A simple client-side mod for R.E.P.O. that adds a two-way portal system allowing quick travel between two set points. Place portals with keybinds, then walk into one to teleport to the other!

Features

• Place two distinct portal markers using configurable keybinds.
• Walk into a portal's trigger area (defined by a BoxCollider on the prefab) to teleport to the other portal's center location.
• Collision-aware placement: Attempts to place portals on valid ground and avoid obstructions, searching nearby NavMesh if the initial spot is blocked.
• Time-based cooldown after teleporting to prevent instant loops.
• Uses custom portal visuals and trigger areas loaded from an AssetBundle (PortalBundle).

Important Notes / Limitations

• Client-Side Only: Portals only exist and function for the user who has the mod installed. They will be invisible to others.
• AssetBundle Required: This mod requires the PortalBundle file containing a PortalPrefab. This prefab must have a BoxCollider component with Is Trigger enabled. The mod will fail to load functionality if this requirement is not met.
• No Persistence: Placed portals are lost when you quit the game or potentially between level loads.
• Placement Imperfections: While placement logic avoids spawning inside walls, the visual model might still slightly clip into nearby geometry depending on its size and the NavMesh layout.

Installation

• Recommended: Install using r2modman or the Thunderstore Mod Manager.
• Manual:
  1. Install BepInExPack for REPO if you haven't already.
  2. Download the mod zip file.
  3. Place the REPOPortalsMod.dll file and the PortalBundle file into your R.E.P.O/BepInEx/plugins/ folder (creating a subfolder like REPOPortals is recommended). Both files must be in the same folder.

Suggested Mods

• REPOConfig: Useful for easily changing keybinds and settings in-game via the F1 menu, though manual config editing is also supported.

Controls (Default)

• Hold P + Press 1 (Alpha1 or Keypad1): Place/Update Portal 1 marker.
• Hold P + Press 2 (Alpha2 or Keypad2): Place/Update Portal 2 marker.
• Walk Into Portal: Enter the trigger area (BoxCollider) of a placed portal to teleport to the other one (subject to cooldown).

(Keys can be changed via configuration).

Configuration

Settings can be changed using REPOConfig (F1 Menu) or by editing the configuration file manually after running the game once with the mod installed.

• File Location: BepInEx/config/com.BellaModsGames.REPOPortals.cfg
• Options:
  • Modifier Key: The key that must be HELD DOWN while pressing the portal keys.
    • Default: P
  • Place Portal 1 Key: The key (usually a number) to press WHILE HOLDING the Modifier Key.
    • Default: Alpha1
  • Place Portal 2 Key: The key (usually a number) to press WHILE HOLDING the Modifier Key.
    • Default: Alpha2
  • Player Check Radius: Radius of the detection sphere around the player used to find portal triggers.
    • Default: 0.5
  • Placement Check Radius: Radius used to check if the initial placement spot is clear of obstructions.
    • Default: 0.4
  • Teleport Cooldown: Minimum time in seconds between allowed teleports.
    • Default: 1.0
  • NavMesh Search Radius: How far (in meters) the mod searches for a valid NavMesh spot if the initial placement is obstructed.
    • Default: 3.0

Tips

• Teleport destination is the exact center point of the other portal's visual marker.
• If placement fails completely (obstructed initial spot + no nearby NavMesh), a message will appear in the BepInEx console.
• Check the BepInEx console (F12) for debug messages regarding placement and teleportation.

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

• Initial release using walk-through trigger detection (OverlapSphere).
• Collision-aware placement with NavMesh fallback.
• Time-based teleport cooldown.
• Configurable modifier key (Default: P).
• Requires external AssetBundle with configured prefab.