REPO Portals Mod

Adds a simple two-way portal system to the game REPO, allowing quick travel between two set points by walking through placed portals.

Features

• Place two distinct portal markers anywhere in the world using keybinds.
• Walk into the trigger area (defined by a BoxCollider on the portal prefab) of one portal to instantly teleport to the center of the other portal.
• Requires exiting both portal trigger zones before portals can be used again to prevent instant teleport loops.
• Portal visuals appear slightly above the ground in front of where you activate the keybind.
• Uses custom portal visuals and trigger areas loaded from an AssetBundle.

Requirements

• REPO (The game)
• BepInExPack for REPO (Make sure you have the correct version installed - see manifest.json)

Installation

1. Install BepInEx: Follow the standard BepInEx installation instructions for REPO. You likely need the correct BepInExPack for the game from Thunderstore or a similar source.
2. Download Mod: Get the REPOPortalsMod.dll file and the PortalBundle asset bundle file.
3. Place Files:
   • Move REPOPortalsMod.dll into your <REPO Game Folder>/BepInEx/plugins/ directory. You might want to create a subfolder like BepInEx/plugins/REPOPortals/.
   • Move the PortalBundle file into the same directory as the REPOPortalsMod.dll (e.g., <REPO Game Folder>/BepInEx/plugins/REPOPortals/).
4. AssetBundle Prerequisite: The PortalBundle file MUST contain a prefab named PortalPrefab. This prefab MUST have a BoxCollider component attached (on the root or a child object) and that BoxCollider's Is Trigger property MUST be checked (set to true). The size and position of this BoxCollider define the portal's activation zone.
5. Launch Game: Start REPO. The mod should load automatically if the AssetBundle is valid.

Usage

1. Place Portal 1: Hold Left Control and press 1 (Alpha1 or Keypad1). This places the Portal 1 visual marker where you are looking.
2. Place Portal 2: Hold Left Control and press 2 (Alpha2 or Keypad2). This places the Portal 2 visual marker where you are looking.
3. Teleport: Walk into the trigger area (the BoxCollider zone) of either placed portal visual. You will be instantly teleported to the exact center of the other portal visual.
4. Re-activation: You must walk completely outside of both portal trigger areas before you can use either portal again. This prevents getting stuck in a teleport loop.

Placing a portal again simply replaces the old one.

Configuration

Settings can be changed via the BepInEx configuration file after running the game once with the mod installed:

• File: <REPO Game Folder>/BepInEx/config/com.BellaModsGames.REPOPortals.cfg
• Options:
  • Place Portal 1 Key: The number key used with Left Control for Portal 1 (Default: Alpha1).
  • Place Portal 2 Key: The number key used with Left Control for Portal 2 (Default: Alpha2).
  • Player Check Radius: How close the player's center needs to be to a portal's trigger BoxCollider for the game to detect the interaction (Default: 0.4). You might adjust this slightly based on player/collider size.

(Note: The Left Control modifier key cannot be changed via the config).

Known Issues / Notes

• Teleportation might have minor visual glitches depending on how the game handles player position updates.
• Crucially dependent on the PortalBundle: Ensure the bundle exists, is named correctly, contains PortalPrefab, and that the prefab has a correctly configured BoxCollider trigger as described in Installation.
• Portals are not saved between game sessions.

Credits

• Mod 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.