redos7-SharePermissions icon

SharePermissions

Share host permissions among trusted players

Last updated 9 hours ago
Total downloads 4950
Total rating 3 
Categories Tools Client-side Server-side AI Generated Quality Of Life
Dependency string redos7-SharePermissions-2.4.2
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100
nickklmao-MenuLib-2.5.4 icon
nickklmao-MenuLib

A library for creating UI!

Preferred version: 2.5.4

README

Screenshot

SharePermissions

The mod provides functionality to manage and share permissions (kick, ban, start game, return to lobby) among players who you trust. That's usually for community hosts who want to delegate moderation tasks to trusted members of their group.

Quick Start

  1. Install the mod — that's it, it is active right away (no codes to configure)
  2. Tell your trusted friends to install it too
  3. In the lobby there's a new button "Mod" next to the menu title — it opens the Members / History / Access / Settings / + panel
  4. As the host, click a friend in the Members tab and promote them to moderator

Becoming a moderator

The host clicks a player in the Members tab and promotes them. That issues the player a private access token — their moderator credential. It is presented automatically when they rejoin, so a promotion persists across sessions until the host revokes it (demote them in Members, or revoke the token in the Access tab — that works even while they are offline).

There is no shared secret code anymore: earlier versions could grant moderator to anyone whose SecretCode matched the host's, which meant a leaked or guessed code silently handed out moderation rights. Now every grant is an explicit host decision.

What's included

  • Members tab: every player with their role, live talk indicator, and (for the host) promote / demote
  • History tab: searchable, filterable log of every moderation event, kept across sessions and synced to moderators
  • Access tab: the host's issued moderator tokens (revoke one to demote its holder, online or not) and the tokens you hold from hosts that promoted you
  • Settings tab: everything configurable in-game — no config-file editing needed after setup
  • "+" tab: the private voice channel's live controls (on/off, microphone, sound, volume) and, for the host, the announcement field
  • Kick/Ban buttons on the lobby player list and the in-game escape menu, for the host and moderators
  • Name colors: the host picks nickname colors for themself, moderators, and individual players (Members > a player > Set name color) — shown to everyone running the mod in the lobby list, on the floating name above each player's head in-game, and on the escape menu's volume rows (toggle your own display of them in Settings)
  • Run-start countdown on the Start button — everyone sees it, host and moderators cancel it with one click
  • On-screen notifications of moderation events for the host and moderators
  • RPC-flood protection: auto-kicks players spamming network messages (lobby only, moderators exempt)
  • Role head markers in the lobby and truck: crown (host), gem (moderator), diamond (mod user)
  • Private voice channel: the host can put themself and their moderators on a voice channel nobody else can hear — see Private voice channel below
  • LoadingWidget companion mod (optional, separate install): the moderation panel during loading screens — load states, who's talking, per-player local volume, kick/ban, stuck-load rescue
  • Announcements: the host can toast a short message onto every player's screen from the + tab (players must run this mod to see it).
  • Player notes: the host and moderators keep shared notes about players, tied to Steam IDs, carried between lobbies by the moderation team and shown when a noted player joins.

Private voice channel

The host turns this on from the + tab of the moderation panel. Once it's on, the host and every moderator hear each other and nobody else — at full volume, anywhere on the map, through walls, across a whole level, even if one of you is dead. Everyone outside the channel simply stops hearing you, including players running no mods at all, and you stop hearing them. Talking in the channel doesn't attract monsters, and ordinary players still attract them exactly as before. Your ordinary microphone goes silent the instant you turn the mode on, so you can never be caught talking on the wrong channel by accident; the private channel itself takes a moment to connect, and the panel shows you when it's live. Switching off holds your microphone quiet for a moment longer too, so the tail end of a private sentence can't slip out into public chat. While the private channel is on, an always-visible list in the corner of the screen shows who is in it and lights up whoever is talking, so you don't have to open the panel to check. Pick the corner — or turn the list off — on the Settings tab.

Inside the channel you have two independent mutes, both on the + tab. Microphone stops you transmitting while you keep hearing everyone; Sound stops you hearing the channel while you can still talk. F4 toggles the microphone from anywhere in the game — rebind it, or bind a key for the sound mute, in the [Hotkeys] section of the config file. The always-visible corner list badges its title MIC OFF / SND OFF and dims your own name while your microphone is muted, so a mute is never silent. Both are yours alone: nothing is sent to the other members, and both reset when the game closes.

It comes with some honest limits, worth knowing before you rely on it:

  • It's a moderation convenience, not a secure channel. The channel's name is the only thing keeping it private — anyone who learns it can listen in.
  • Leaving the lobby doesn't take away someone's access. A member who leaves keeps the key until the next rotation, and rotation only happens when a moderator is demoted, not simply when someone leaves.
  • Text chat isn't part of the private channel. Whatever you type is still visible to the whole lobby, and it's still read aloud to everyone by their own text-to-speech, exactly as if the mode were off. Only your microphone is made private.
  • While it's on, other mods' "force microphone on" features stop working for you. The mod deliberately holds your ordinary microphone silent while the channel is active — that's what keeps your voice out of the public room.
  • The channel carries your raw microphone audio. The game's own echo cancellation, noise suppression and automatic gain control never get a chance to run on it. On headphones that's just a quality difference; on open speakers it means the private channel can carry your speakers' own output back to everyone else in it.
  • A moderator running an older version of the mod never joins the channel. They stay on ordinary public voice chat instead, with nothing telling them they're missing it.
  • An outsider who hasn't finished loading yet (or is stuck as a ghost) can still be heard through chat. The mod only silences the text-to-speech readout of players whose in-game character actually exists, so a still-loading or ghost outsider's typed messages stay audible to channel members.

How it works under the hood

Moderator clients send requests to the host's client; the host verifies the request arrives over the live connection of someone it actually promoted (an unforgeable connection identity, authorized by the access token — never a claimed Steam ID) and performs the action itself. Nothing runs on other players' machines.

Integrations

  • BanEnforcer (Omniscye-BanEnforcer v4+, optional): if the host has it installed, the Kick/Ban popups and the Members panel offer Ban (persistent) - the ban is written to BanEnforcer's on-disk list, so it keeps working after restarts. Moderators can use it too; only the host needs BanEnforcer installed.
  • R.E.P.O. Admin Menu (proferabg-RepoAdminMenu, optional): moderators can open the Admin Menu when the host runs it and has Settings > Admin menu > Grant to moderators on (the default). Unlike BanEnforcer, this one needs the mod on both machines - it draws its own local menu, so there is nothing to unlock on a moderator who does not have it. A moderator's actions are carried out by the host and recorded in History as Admin Menu events. Covers the whole menu - settings, upgrades, kill/heal/revive/crown/truck, teleport and summon, spawning items/valuables/enemies, and the map controls. Things spawn where the moderator stands, and Kick/Ban inside it obey SharePermissions' own rules (the host is never kickable; a moderator only by the host). Note that this hands moderators cheat powers over everyone in the room, the host included - the grant switch is the control.

Misc

In folders with config files there's a sharepermissions.log file that contains all performed actions with timestamps and player names.