R.E.P.O.
Install with App

Details

Latest version
1.3.0
Last Updated
First Uploaded
Downloads
5.7K
Likes
1
Size
76KB
Dependants

LoadingWidget

A panel on the R.E.P.O. loading screen — the one place the normal menus can't reach. Every player running the mod sees it while a multiplayer level load is in flight — between levels in the game itself, including through the scene-swap gap where even the game's own UI is gone; never on the boot/menu loads or in singleplayer. Works on its own; SharePermissions is an optional companion that unlocks its full moderation stack.

Everyone sees:

  • every connected player with their live load state — LOADING / BUILDING / LOADED / READY — so the one player hanging the load is visible at a glance. When a load is genuinely stuck (the game's own ~25s verdict, or the panel's own backstop for the Start/reload phases it misses), the header flags STUCK and the blocking rows burn red
  • a per-player voice control on every row: a 0–200% gain slider with that player's live talking loudness riding inside it. It drives the game's own per-player mic gain, so it always matches the slider in the ESC menu — the same value, not a second one stacked on top
  • with SharePermissions 2.33.0+ installed, each player's lobby head at the start of their row — the same head SharePermissions shows in the lobby and the ESC menu, in their own colors, moving as they talk — with their role as a small gem on its corner (UI / ShowPlayerHeads turns it off)

Moderators (the host — plus SharePermissions moderators when it's installed) additionally get:

  • Kick / Ban for stuck or misbehaving players, inline on the player's row. Both are two-step — the first click arms the button (KICK?), a second click within 3 seconds fires it

The host additionally gets:

  • a Lobby button that brings the whole room back to the lobby even when a load is stuck, and escalates to FORCE — a room-wide restart of the wedged transition — once a return is in flight (the vanilla stuck prompt only offers leaving the room; this bail keeps the room intact)

Standalone vs. with SharePermissions

The mod detects SharePermissions at startup and uses all of it when found:

Standalone With SharePermissions v1.17.0+
Who sees the panel Everyone in the room running the mod Everyone in the room running the mod
Who gets moderation actions Host only Host and SharePermissions moderators
Kick / Ban The game's own kick & ban (host) SharePermissions rules & wire protocol — moderators can kick remotely, bans are audited
Role icons Host crown only Full tiers: host / moderator / mod user / no mod
Player heads No (role gems) Each player's lobby head, talking, with the role gem as a badge (SharePermissions 2.33.0+)
Lobby + FORCE rescue Yes (host) Yes (host) — native to this mod either way
Load states, talking meter, voice volume Yes Yes — volume is the game's own value in both modes
Panel on/off toggle This mod's config: UI / ShowLoadingPanel in BepInEx/config/RED.LoadingWidget.cfg The same config entry — live, mid-load included

Note on older SharePermissions (≤ 1.16.x): those versions ship this panel inside SharePermissions itself, so LoadingWidget stays dormant (one log line, no double panel). Update SharePermissions to 1.17.0+ — or uninstall it — to activate LoadingWidget.

Quick start

  1. Install this mod. That's it — the panel appears on multiplayer loading screens for everyone running it; the kick/ban and lobby controls light up for the host.
  2. Optional: install SharePermissions v1.17.0+ (and set it up as usual, secret code etc.) to get moderator access, role tiers, and its kick/ban machinery on the panel.

For developers

This mod is the panel UI plus the native lobby rescue and voice control, talking to a backend picked once at startup (Plugin.ResolveBackend, soft [BepInDependency] so SharePermissions loads first when present). That backend seam is deliberately tiny — eight members: role tiers, name sanitizing, the kick/ban permission checks and dispatch, and the player heads (a view SharePermissions creates and draws on, LoadingWidgetBridge.CreateHeadView / UpdateHeadView, 2.33.0+; against an older SharePermissions the first call fails, heads switch off for the session and the rows keep their gems). Everything else acts on the game's own state, so it is native in both modes:

  • Bridged — SharePermissions v1.17.0+ installed: those eight go through its public facade SharePermissions.Api.LoadingWidgetBridge (additive-only stability contract).
  • Standalone — SharePermissions absent: host-only fallbacks on the game's own machinery (native kick/ban wire events).
  • The whole lobby rescue is native in both modes (src/LobbyRescue.cs): LOBBY, the queued return, and the FORCE restart all act on the game's transition pipeline rather than on backend state, so they live here and never route through SharePermissions. It is host-only by nature — the game's ChangeLevel ignores a non-master.
  • Voice is native in both modes (src/NativeVoice.cs): the slider writes PlayerVoiceChat.voiceGain and persists it via GameManager.PlayerMicrophoneSettingSet, i.e. the same two writes the game's own MenuSliderPlayerMicGain makes. The PlayerVoiceChat postfix that remains only records actor → PlayerVoiceChat; it never touches volume. That lookup can't go through PlayerAvatar.voiceChat, because the game leaves that field unwired until GameDirector.currentState reaches Main — which outranks Load and Start, so it has never fired while a loading screen is up, and PlayerAvatar isn't DontDestroyOnLoad so it restarts unwired every level. The older postfix instead multiplied lowPassLogic.Volume after the game's Update, stacking a second factor on the native gain so the panel's percentage disagreed with the game's own slider. Loudness is clipLoudnessNoTTS, which the game already computes each frame.

src/SharePermissionsBackend.cs is the only file allowed to reference SharePermissions.* types (JIT isolation is what lets the mod run without the assembly on disk — keep it that way).

  • libs/SharePermissions.dll is the vendored compile-time copy of the bridge contract. It is not bundled at runtime (Private=false) — BepInEx loads the real installed mod. Whenever the bridge gains members this mod needs, rebuild SharePermissions and refresh the vendored DLL from its reference assembly (public API only, about 100 KB; the full DLL carries several MB of head art this mod never needs to compile):

    dotnet build -c Release <SharePermissions repo>\SharePermissions.csproj
    copy <SharePermissions repo>\obj\Release\netstandard2.1\ref\SharePermissions.dll libs\
    

    ...then raise PluginInfo.SharePermissionsMinVersion if the new members are required — installs below the minimum fall back to standalone-or-dormant instead of crashing. Members that are only nice to have (the 2.33.0 player heads) are called inside a catch instead, so an older install just goes without them.

  • dotnet build deploys straight into the r2modman profile configured in Directory.Repo.props (per-machine overrides go in Directory.Repo.props.user, via the Linkoid.Repo.Plugin.Build SDK).

  • Design notes: the extraction spec lives in the SharePermissions repo (docs/superpowers/specs/2026-07-13-loading-widget-extraction-design.md); the optional-dependency design lives here (docs/superpowers/specs/2026-07-13-optional-sharepermissions-design.md).

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.