AutoReturnToLobby

COMPATIBLE WITH R.E.P.O. v0.4.3.

AutoReturnToLobby

This mod is a host-only emergency recovery mod that automatically returns the room to the lobby when a loading stack is detected, and also lets the host manually trigger the same recovery by holding HOME.

It is meant to be used together with OrigamiCoder's ReturnToLobby. When triggered, it calls the same action as pressing Yes on ReturnToLobby's return-to-lobby popup, then runs an extra hard reload fallback to recover from loading-stack states.

Why this mod exists

A common long-standing problem in R.E.P.O. is that a room can get stuck during loading when another player joins right before or right after a level transition begins.

This can happen especially around late joins, and it can leave the host unable to continue normally while the room remains trapped in a broken loading state.

With the default settings, this mod detects the vanilla loading-stuck warning and automatically returns the room to the lobby menu after a short countdown.

Even outside loading, the host can also hold HOME to manually trigger the same emergency return sequence.

This is intended to be a practical fix for one of the larger persistent multiplayer problems: getting the room out of a broken loading state without requiring everyone to restart the game.

Features

• Automatically detects the vanilla loading-stuck warning.
• Automatically runs forced ReturnToLobby recovery after a configurable delay.
• Hold HOME to manually start the same emergency lobby return.
• The progress UI appears after the configured display delay.
• The progress timer starts from the moment the UI appears.
• When the bar reaches 100%, the ReturnToLobby yes action is executed.
• The progress UI is drawn in front of the screen.
• The recovery path can destroy remaining Photon network objects and force the Reload scene to break out of loading stacks.

Install

• Install BepInEx.
• Install MenuLib.
• Install ReturnToLobby by OrigamiCoder.
• Place this mod DLL into the BepInEx/plugins folder.
• Start the game once to generate the config file.

Usage

Loading-stuck recovery is enabled by default.

When the vanilla loading-stuck warning appears, this mod starts its own countdown and executes the forced ReturnToLobby recovery after the configured delay.

Manual recovery is also available.

Hold HOME to start the progress UI.

By default, the progress bar appears after 2 seconds.

From the moment the UI appears, it takes 5 seconds to reach 100%.

When it reaches 100%, the room is forced back toward the lobby through the same recovery sequence.

Notes for players

Only the host needs this mod to return the room to lobby.

Participants do not need this mod for the host-triggered recovery to work.

The mod intentionally does not restrict execution by lobby, shop, level, or arena state.

It is designed as an emergency recovery tool that can be triggered whenever the required game managers exist and the user is host or in singleplayer.

During hard recovery, a temporary Photon warning about missing PhotonViews or late RPCs may appear.

This can happen because the mod intentionally destroys old network objects before forcing the reload fallback.

Configuration

General

| Setting | Description | Default | Min | Max |

| --- | --- | ---: | ---: | ---: |

| Enabled | Enables this mod. | true | - | - |

| HoldKey | Key to hold before the progress UI starts. | Home | - | - |

| DisplayDelaySeconds | Seconds before showing the progress bar. | 2 | 0 | 30 |

| RequiredProgressSeconds | Seconds required after the progress UI appears. | 5 | 0.1 | 60 |

| CooldownSeconds | Cooldown seconds after execution. | 3 | 0 | 60 |

| TransitionLockSeconds | Seconds to block repeated execution after one trigger. | 20 | 0 | 120 |

Recovery

| Setting | Description | Default | Min | Max |

| --- | --- | ---: | ---: | ---: |

| EnableHardReloadFallback | Forces the Reload scene after the ReturnToLobby yes action. | true | - | - |

| HardReloadDelaySeconds | Seconds to wait before ha