redos7-SharePermissions icon

SharePermissions

Share host permissions among trusted players

Last updated 3 days ago
Total downloads 19233
Total rating 4 
Categories Server-side Tools AI Generated Quality Of Life Client-side
Dependency string redos7-SharePermissions-2.36.1
Dependants 1 other package depends 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

README

SharePermissions

Lets the host of a R.E.P.O. lobby make trusted players moderators. Moderators can kick, ban, start the run or send everyone back to the lobby, and the host decides what each of them is allowed to do. Every action still goes through the host's game.

Features

  • Promote players to moderator, permanently or for 1, 7 or 30 days
  • Turn individual permissions on or off for each moderator
  • Kick and Ban buttons in the lobby list and the escape menu, with an optional reason
  • History of every moderation action, shared with your moderators
  • Shared player notes, and a warning when someone you kicked or banned joins again
  • Protect a player so moderators can't kick or ban them
  • Private voice channel for the host and moderators, and 1-on-1 calls with players
  • Lobby protection: who can join, host takeover block, voice guard, network flood auto-kick
  • Name colors and 185 lobby heads, or build your own head in the colors you pick
  • SP tag in the server list for lobbies that run the mod
  • Start countdown that moderators can cancel
  • Revive and heal the player you're holding with one key
  • Recent tab with the people you played with
  • English, Russian, Spanish, Italian, Portuguese (Brazil), Japanese, German and French

Who needs it

The host and the moderators. Other players can join and play without it. Players who have it also see name colors, lobby heads and the countdown, can build their own head, and can call the host or a moderator.

Getting started

  1. Install the mod. There is nothing to configure.
  2. Have your moderators install it too.
  3. In a multiplayer lobby, click Mod next to the menu title, or press F7.
  4. Go to Members, click a player and choose Promote to moderator.

To remove a moderator, click them again and choose Revoke moderator access. You can also do it from the Access tab, even when they are offline.

The Mod panel

Tab Who sees it What's in it
Members host, moderators Players in the lobby. The host promotes, sets permissions, protects players and sets name colors and heads here. Moderators open player notes. Both can Kick or ban a player from their page, one who never finished joining included; the host also reaches a player still loading.
Notes host, moderators Every player you hold notes on, in the lobby or not: search, and show those in the lobby or the ones you wrote
History host, moderators Searchable log of moderation events
Access host, moderators Moderators and their permissions, protected players, ban list
Settings everyone All settings, grouped into Room, Protection, Calls, Looks, Alerts and General
Recent everyone People you played with (up to 300, kept only on your PC)
Microphone icon host, moderators, players Private voice channel and 1-on-1 calls

Permissions

A new moderator gets all eight. The host can turn any of them off on the Members or Access tab. Changes apply right away and show up in History. Moderators promoted before Revive & heal existed don't have it until the host turns it on for them.

Permission What it allows
Kick Kick players
Ban Ban players for the session
Persistent ban Ban that lasts between sessions, permanent or for 1, 7 or 30 days, kept on the host's ban list
Admin Menu Use the R.E.P.O. Admin Menu (host and moderator both need it)
Notes Add, edit and delete player notes (a moderator edits and deletes their own)
Run control Start the run, cancel the countdown, return to the lobby
1-on-1 voice Start private calls
Revive & heal Revive and heal the player they're holding, with the Revive & heal key

Timed moderator access runs out on its own, and the moderator gets a notice when less than a day is left.

Private voice

On the microphone tab the host can put the whole moderator team on a private channel, or start a 1-on-1 with one moderator or player. People on the channel hear each other at full volume anywhere on the map, and nobody else hears them. Talking on it doesn't attract monsters. The host can add more people to a running call, up to eight.

Moderators with the 1-on-1 voice permission can call the host, other moderators or players. Players can call the host or a moderator, unless the host turns off Players may call the team. You answer a call with Y or N and hang up with End. The host can also set a max call length and a wait between calls.

A list in the corner of the screen shows who is on the channel and who is talking. The game's own mute key mutes you there too.

Limits:

  • It isn't a secure channel. Anyone who learns the channel's name could listen in.
  • Text chat stays public.
  • Moderators on an old version of the mod can't join it.
  • Other mods' "force mic on" features don't work while you are on it.

Lobby protection

  • Who can join (a switch under the host's Mod button): Everyone, Friends only, Invites only or Nobody. Late-join mods need Everyone.
  • Block host takeover: if a cheater makes themselves host, you stay in the lobby, the real host gets the role back and the cheater is banned.
  • Voice guard: blocks voices that pretend to be another player, and the giant emoji spam.
  • Publish Steam IDs: flags players whose Steam ID doesn't match their Steam login.
  • Flood protection: kicks players who spam network messages (lobby only).

Looks

The host picks name colors and lobby heads for themself, for moderators and for single players. There are 185 heads: hats, glasses, faces, eyes, mustaches and more, and some of them move. Every player with the mod can also build their own head from parts in Settings > Looks > My head, if the host allows it, and save up to five looks there to switch between. 43 of the parts (hair, hats, clips, lipstick, collars and more) take a color you pick on the My head page, where they carry three small color bars and the colors open right under the part you wear. The color shows when the host and the other players run this version, and otherwise the part shows its original colors. Moderators can pick their own name color in Settings > Looks, if the host runs a version that supports it; a color the host sets for them wins.

In the Esc menu, every player's lobby head shows beside their name and moves when they talk.

Lobbies that run the mod get an SP tag and are listed first in the server list for players who have the mod. The host can also change the color of the lobby's name there.

Name colors, heads, head animations and the Esc menu heads can each be turned off for yourself in Settings.

Other mods

  • BanEnforcer (host only, optional): SharePermissions keeps its own ban list, so persistent bans work without it. With BanEnforcer installed, each new persistent ban goes on both lists, so it still holds if you remove BanEnforcer later, and lifting a ban on the Access tab lifts it from both. A ban you lift in BanEnforcer's own menu is dropped from SharePermissions' list too.
  • R.E.P.O. Admin Menu: moderators can use it if the host allows it. Both need it installed. It gives moderators cheat powers over everyone, so only allow it for people you trust.
  • LobbyReactions: reaction stickers, a separate mod. Its "Host and moderators" setting uses your moderators.
  • LoadingWidget: the moderation panel on loading screens. From LoadingWidget 1.3.0 it also shows every player's lobby head there.
  • LateJoinPlus: works alongside it. By default only its late joining stays on, so the two mods don't do the same things twice.

Keys

  • F7: open or close the Mod panel (change it in Settings > General)
  • Y / N: accept or decline a call
  • End: hang up
  • Shift + click Start: start the run right away, without the countdown (host only)
  • H: revive and heal the player you're holding with the grabber (host, and moderators with the Revive & heal permission). Hold a dead player's head and they get up on the spot with full health; hold a living player and their health is topped up. Works in a level, not in the shop, lobby or arena. Change the key in Settings > General. A moderator needs a host on this version.

Y, N and End are the defaults. You can change them in Settings > Calls.

Your files

Tokens, notes, History and the log are stored in %LOCALAPPDATA%\SharePermissions, not in the BepInEx config folder, so exporting a mod profile doesn't share them. Don't share that folder: a copied token works until the host revokes it.

How it works

Moderators send requests to the host, and the host's game does the kick or ban. The host checks that a request comes from the connection of someone it promoted, not from a Steam ID, since those can be faked. Each moderator gets a private token when they are promoted and proves it with a one-time code whenever they rejoin, so the token itself is only ever sent once.

Problems

If you are the host or a moderator, Settings > General > Diagnostics shows what the mod sees, and Write diagnostics to log copies it into the BepInEx log for a bug report.

The changelog has the full details on every feature.