Loading-screen panel for every player: live load states with stuck detection, talking bars, local voice volume; kick/ban and stuck-load lobby rescue for moderators. Works standalone; full SharePermissions integration when installed
Player heads. With SharePermissions 2.33.0 or newer, every row starts with the player's lobby
head: the one SharePermissions shows in the lobby and the ESC menu (a head they built, the host's
pick, a role head), in their own colors, and moving as they talk, like in the lobby. Their role
stays visible as a small gem on the head's corner. UI / ShowPlayerHeads turns the heads off.
Without SharePermissions, or with an older one, the rows keep their role gems as before.
1.2.0
Per-player volume is now the game's own volume. The panel writes
PlayerVoiceChat.voiceGain — the exact value the game's ESC-menu mic-gain slider writes — and
persists it under the same Steam id the game uses. Previously both this mod and SharePermissions
bolted a second multiplier on top of the native one from a Harmony postfix, so the panel's
percentage and the game's slider were independent values that compounded. They are one value
now: the panel's 0–200% is the native 0–200 slider, and 100% is the game's default.
Every control moved onto the player's row. Kick, Ban, the volume slider and the percentage all
live on the row itself — the kebab menu and the expanding sub-row are gone. Because the actions no
longer sit behind a disclosure, Kick and Ban are now two-step: the first click arms the button
(KICK? / BAN?) and only a second click within 3 seconds fires. Exactly one action can be armed
at a time, and it disarms itself if the target leaves or scrolls out of view.
The volume slider and the talking meter are one control, matching the native design: live
loudness rides inside the gain bar, exactly as the game's own slider draws it
(ExtraBarSet(clipLoudnessNoTTS * 5)). The panel is 820 units wide (was 620) to fit it all.
The panel finds each player's voice through its own actor registry rather than through
PlayerAvatar.voiceChat: the game only wires that field up once GameDirector.currentState
reaches Main, which outranks both Load and Start, so on a loading screen it has never fired —
and since PlayerAvatar is not DontDestroyOnLoad, it restarts unwired on every level load.
Reading it would leave the slider showing a fixed 100% and swallowing every drag.
A row now draws its volume slider only when that player's voice is actually reachable, so you
never get a control that looks live but does nothing.
Internals from the above: voice reads the loudness the game already computes instead of sampling
1024 audio samples per player per frame, the PlayerVoiceChat patch no longer touches volume at
all (it only records actor → PlayerVoiceChat), and the backend seam shrank again from 11 members
to 6 — permissions, kick dispatch, role tiers and name hygiene, nothing else.
Fixed: the FORCE lobby rescue was unreachable. Three separate defects meant the
LOBBY → FORCE escalation could effectively never appear:
The pending-return flag was cleared by a check on RunIsLobbyMenu(), which tests the
transition destination — the very thing a retarget had just set — so the flag was cleared
one frame after being armed. The tick now waits for genuine arrival (transition finished
and the room settled in a gameplay state) before it clears anything.
Pressing Lobby during the most common wedge (level generation / the start barrier) took a
direct ChangeLevel path that never armed the flag at all. Every further click was then
swallowed by the game's own "already restarting" guard, leaving an inert LOBBY button forever.
That path now arms the escalation too.
With SharePermissions installed, the Lobby button did nothing whatsoever: the click was routed
into SharePermissions' confirm popup, which silently no-ops on a loading screen (the game's
popup opener does nothing when no menu page is open).
The lobby rescue is now entirely this mod's, in both modes (src/LobbyRescue.cs). It acts on
the game's transition pipeline, not on backend state, so it no longer routes through
SharePermissions at all — the fix therefore works against every already-installed SharePermissions
version. SharePermissions still supplies permissions, kick/ban dispatch, role tiers, voice and
name hygiene.
The bail button is host-only and has two states instead of three: LOBBY → (armed) →
FORCE, each a two-step confirm. FORCE is offered as soon as a return is in flight, with no
wait on a stuck timer. Non-host SharePermissions moderators no longer see the button — a native
return cannot work for them, and it never actually worked before either. Their Kick/Ban and the
volume slider are unchanged.
Fixed: the panel had no on/off toggle when SharePermissions was installed.UI / ShowLoadingPanel was bound only in standalone mode, while the bridged path read
SharePermissions' bridge value — hardcoded to "on" since its v1.21.0. The setting is now always
bound, in BepInEx/config/RED.LoadingWidget.cfg, in both modes.
Fixed: every player showed BUILDING at once, and they all changed together. Level generation
is work the host alone does — it builds tiles, modules, items, valuables and the navmesh while
every client simply waits — and the game replicates no per-player progress for that stretch. The
panel keyed BUILDING on a list that only fills at the very end of generation (the host spawns
every avatar in a single loop), so the whole room read BUILDING for the bulk of the load and
then flipped to LOADED together: one global flag rendered as if it were per-player truth.
Generation is now attributed to the host's row, which is the player actually working;
everyone else reads LOADED (in the level, waiting). The per-player spawn and enemy barriers still
discriminate normally once they become meaningful, and when a load is flagged STUCK the blocker
accent now points at whoever is genuinely building instead of reddening every row.
Internals: the backend seam shrank from 18 members to 11 (permissions, kick, voice and name
hygiene only); LoadingPanel split into frame / UI / state files; the GameDirector gameplay
state is resolved by name like the outro states already were, so a reordered enum cannot silently
mislead the rescue; the voice postfix reads the game's cached PhotonView instead of a
GetComponent per player per frame; the temporary [LoadPanel diag] dump and its
Debug / StateDiagnostics config entry are gone.
1.1.1
Works with R.E.P.O. v0.5.0. Kick and Ban on the loading panel without SharePermissions failed
on v0.5.0 (the game now kicks by player, not by character); they work again.
1.1.0
SharePermissions is now optional. The mod detects it at startup: with SharePermissions
v1.17.0+ installed, everything works exactly as before through its LoadingWidgetBridge
(moderators get the panel's actions, its rules/wire protocol drive kick/ban, role tiers, its
config toggle). Without it, the panel works standalone on the game's own machinery: host-only
moderation with native kick/ban (bans enforced by the room's exclusion list), the Lobby button
with the same QUEUED/FORCE stuck-load rescue, talking bars, and the per-player local voice
volume slider.
Standalone panel toggle: UI / ShowLoadingPanel in BepInEx/config/RED.LoadingWidget.cfg
(bound only when SharePermissions is absent; its own toggle governs otherwise).
With an older SharePermissions (≤ 1.16.x, which ships this panel itself) the mod stays dormant
with a clean log line instead of drawing a second panel.
The Thunderstore package no longer hard-depends on SharePermissions.
The panel is visible to EVERY client running the mod, not only the host and moderators - the
load display is informational, so anyone stuck in a load can see who is holding it up. It is
strictly scoped to loading between levels in the game itself: it requires an active Photon room
and never appears on the boot/splash/menu loads or in singleplayer (in-room, the local player is
always listed, so it can never render empty). Moderation actions stay gated: Kick/Ban per-target
and the Lobby/FORCE bail only for the host (and SharePermissions moderators when bridged).
Load-state truth (a decompile-verified audit of what each per-player tier really means):
BUILDING now reads the real per-client build barriers (LevelGenerator.SpawnedReadyPlayerList
and, on enemy levels, EnemyReadyPlayerList - each sent by a client only after real local
work) instead of ModulesReadyPlayerList, which a non-master reports on a ~0.3s timer
regardless of progress. A client genuinely stuck building the level used to show LOADED and
count toward "N/N loaded"; it now stays BUILDING and drops the header count, for every viewer.
The final loading-animation barrier is recognized as a real all-players gate (it blocks every
client's Start->Main), not a cosmetic flourish.
STUCK detection: the panel surfaces the game's own ~25s stuck verdict and adds its own
long-window backstop for the phases that verdict never covers (the Start animation barrier,
the unbounded Reload gap). While stuck, the header flags STUCK and the rows the room is
actually waiting on burn in the blocker accent - the vanilla stuck prompt only offers leaving
the room; the panel points at the room-intact rescue instead.
The panel no longer vanishes during lobby-bound transitions (arena/game-over and its own
LOBBY/FORCE rescue): the window gate keyed on the transition DESTINATION, hiding the rescue UI
the moment it launched. It now rides the whole transition, and the game-over return opens the
panel properly through its outro.
The FORCE rescue is native to this mod in both modes (StandaloneLobby): it acts on the
game's transition pipeline, not on backend state. In bridged mode the panel no longer calls
SharePermissions' ForceLobbyReload; SharePermissions still owns the queued return that gates
FORCE and finishes the trip after the reboot.
Hardening against game updates and backend failures: a failing patch no longer kills the mod at
startup (per-patch guards, degrade to a log line); SemiFunc checks joined the JIT-isolated raw
helpers; the outro phase check resolves gameState values by name, so a reordered enum can no
longer silently mislabel players; and an exception from the backend now hides the panel instead
of freezing it or leaving it stuck over gameplay.
Fixed: the plugin no longer stamps HideAndDontSave on the shared BepInEx manager object (which
hid every mod's plugin component from debug tools); an expanded row no longer survives a mid-load
toggle-off / moderation revoke to reopen by itself on the next load; the volume slider now arms
on the thumb's full height instead of only the thin track; the loading-screen check reads
activeInHierarchy so a parent-level deactivation can't leave the panel stuck visible.
Performance: the per-frame redraw is allocation-free in the steady state (header, name, and
percent strings rebuilt only on change; the Photon player list fetched once per frame),
per-player load states are computed once per frame instead of twice, and unbounded per-frame
retries (FindObjectOfType<ReloadScene> in the scene-swap gap, the font resolve walk) are
throttled to timers.
New config Debug / StateDiagnostics (default off): the [LoadPanel diag] load-state dump no
longer spams the log every 2 seconds - enable it only when diagnosing wrong
LOADING/BUILDING/LOADED/READY states.
Dev/packaging: pinned the floating NuGet versions (build SDK 0.2.2, gamelibs 0.4.4-ngd.0) so a
game update can't silently shift the compile-time surface; per-machine paths now go in
Directory.Repo.props.user instead of editing the committed file; filled in the LICENSE
copyright line.
1.0.0
Initial release: the loading-screen moderation panel, extracted from SharePermissions (it shipped
inside SharePermissions through v1.16.0; from v1.17.0 it lives here). Requires SharePermissions
v1.17.0+ and talks to it through SharePermissions.Api.LoadingWidgetBridge.
Same panel, unchanged: per-player load states (LOADING / BUILDING / LOADED / READY across normal
loads, the outro, and the Reload barrier), talking bars, per-player local voice volume (0–200%,
this machine only), Kick/Ban with SharePermissions' rules, and the Lobby button with the host-side
QUEUED/FORCE stuck-load rescue.
The panel's on/off toggle stays in SharePermissions (Settings tab "Loading panel" /
UI / ShowLoadingPanel), read live through the bridge.
Thunderstore development is made possible with ads. Please consider making an exception to your adblock.