You are viewing a potentially older version of this package. View all versions.
redos7-SharePermissions-2.34.0 icon

SharePermissions

Share host permissions among trusted players

Date uploaded 2 weeks ago
Version 2.34.0
Download link redos7-SharePermissions-2.34.0.zip
Downloads 448
Dependency string redos7-SharePermissions-2.34.0

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 182 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
  • 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.
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 seven. The host can turn any of them off on the Members or Access tab. Changes apply right away and show up in History.

Permission What it allows
Kick Kick players
Ban Ban players for the session
Persistent ban Ban through BanEnforcer, which survives restarts (only the host needs BanEnforcer)
Admin Menu Use the R.E.P.O. Admin Menu (host and moderator both need it)
Notes Add and delete player notes
Run control Start the run, cancel the countdown, return to the lobby
1-on-1 voice Start private calls

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 182 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): adds Ban (persistent), permanent or for 1, 7 or 30 days.
  • 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)

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.

CHANGELOG

Changelog

2.45.1

Fixed

  • Punish and Banish work under a host with No Tumble. A host who had given themselves the Admin Menu's No Tumble made every Punish and Banish do nothing, to anyone, while it still reported a hit. Both now knock the player over whatever that switch says, and a knock the game still refuses is reported as not working instead of as done.
  • The R.E.P.O. Admin Menu's teleports work again. Teleport to, Summon, Return to truck and Send to did nothing to a living player on the current game. The host now moves them the way the game moves a player who fell out of the map: they land lying down and stand up a moment later. This covers Admin Menu 1.0.17 and older; a newer Admin Menu uses its own teleport, in case its author has fixed it.

2.45.0

Changed

  • No way out of a banish by dying. A banished player can't use Self destruct: with this mod they are told so, and one without it who self-destructs anyway is stood up again by the host and keeps falling. The host's own kill (the Admin Menu's Kill) still ends the banish, and once every extraction point is done self-destruct works as usual, so the truck can leave.
  • Nothing kills a spectator. While you spectate, kills that skip health (the Admin Menu's Kill, an explosion) are refused as well as damage, for the host and for moderators.
  • Spectate while dead. A dead host or moderator can spectate any player once the death shot is over: the game's own camera moves to the player you pick, with the usual keys except Speak and "Everyone hears you". Esc gives the camera back; being revived ends the spectate.

2.44.0

Added

  • Banish. A new button on a player's page on the Members tab, in a level: the player is knocked down and drops into the dark under the level, and keeps falling, unable to get up, while the game's "fell out of the map" rescue never catches them. The button turns to Unbanish, which puts them back where they stood. Whoever banished the player hears them the whole time, as if they stood beside them, and can talk to them (the banished player needs this mod for that). It ends by itself when the level ends or the player dies or leaves. Moderators need the new Banish permission, and can't banish the host, another moderator or a protected player. Both show up in History. While spectating, key 6 does the same to the player you watch.
  • Health on the Members list and while spectating. Each living player's health follows their name on the Members tab ("75 HP"), in green, yellow or red by how much is left. While you spectate, the strip shows the watched player's health after their name ("45/100 HP").

Changed

  • Admin Menu spawns land by the player you spectate. While you spectate someone, the items, valuables, enemies and cosmetic boxes you spawn appear in front of them, where they are looking, instead of by your own body. With Speak on or off, for the host and for moderators.
  • The lobby line takes the server list's colour. The lobby name under the Moderation title is drawn the way the server list draws it: in the lobby's own colour when it is advertised there, in plain light text when it is listed but not advertised, and dim grey for a lobby the list does not show. The player count beside it stays grey.
  • The kill, death and loot numbers are per level. On the Members tab and the spectate strip they start again when a level ends, and read "Seen this level".
  • Credits thank мокрая эротика and So Good for ideas too.

2.43.1

Changed

  • The lobby's name sits under the Moderation title again. The small line with the lobby's name and player count moved from the title's right to just below it, centred, where a long name has the whole width of the panel.
  • Punish knocks the player down instead of hurting them. Key 5 while spectating now throws the player you watch into a tumble, like a hit, with a spin, and keeps them down for a few seconds. It takes no health. The host sets how long they stay down (Settings > Protection > Punish > Knocked down for, 3 seconds by default) and how hard the knock is (Knock strength, 25% to 300%, 100% by default), next to the moderators' wait. The host and its moderators must all be on this version: with 2.43.0 on either side, moderators get no Punish key.

2.43.0

Added

  • Revive and heal from the Members list. Point at a player on the Members tab and press the middle mouse button: a dead player gets up where their head lies, a hurt one is healed to full. The key bar says what the key will do. For the host, and for moderators with the Revive & heal permission under a host on this version. Change the key in Settings > General > Members revive key.
  • The Members tab's key hints stay at the bottom. They used to be a line of text under the last player, so in a full lobby you had to scroll down to see them. Now they sit in a bar at the bottom of the panel, above Close, and show each key as a key cap: Click, the spectate key and the revive key. A key lights up while the player under the pointer would answer it.
  • Punish a player you spectate. Press 5 while spectating to hit the player you are watching, as if an enemy hit them. A hit never kills: it stops at 1 health. The host sets how much a hit takes and how long moderators wait between hits (Settings > Protection > Punish); the host never waits. Moderators need the new Punish permission, and can't punish the host, another moderator or a protected player. Each hit shows in History. Moderators promoted before this need the host to turn Punish on for them, and the host must be on this version.
  • The Members list marks who is dead. A dead player's row shows a red † after their name, and it goes away when they are revived.

Fixed

  • Moderators can spawn cosmetic boxes from the Admin Menu. The Admin Menu's Spawn page has a Cosmetic Boxes page now, and pressing its buttons did nothing for moderators. The host now spawns the box in front of the moderator, like the other spawns. This also needs the host on this version.
  • The Admin Menu's Spawner Count works for moderators. Moderators always got one of each thing they spawned. Now they get as many as their Spawner Count slider says, up to the host's own Admin Menu limit. The host has to be on this version too. With an older host, moderators still get one.

2.42.2

Fixed

  • The ESC menu's player list is in order again with LateJoinPlus and MorePlayerList. LateJoinPlus squeezed every player row into one column each frame while MorePlayerList laid them out in two, so the rows ended up staggered over the menu's own buttons. With MorePlayerList installed, LateJoinPlus's list fitting is now switched off and MorePlayerList's layout is the only one. Without MorePlayerList, LateJoinPlus still fits a big lobby on the page.
  • A talking player's head in the ESC list is no longer cut off. When someone talks, the top of their head swings up past its row, and the next row drew over it. The talking row is now drawn over its neighbours.

Changed

  • A two-column ESC player list sits on the right, clear of the menu and of every button. For big lobbies, MorePlayerList puts the second column to the left, over Continue, Settings and the other menu buttons, and so close that rows covered the kick and profile buttons next to them. Both columns now stand side by side on the right of the screen, between the menu's buttons and the screen's edge, and the rows shrink a little when two full-size columns would not fit there. Players keep the order the game listed them in, down the right column and then on into the left one. Rows sit as close as their boxes allow, kick and profile buttons included. While the two columns show, MorePlayerList's arrow keys no longer slide the list. A one-column list is not moved. EscListRightColumns in the config turns this off.

Older versions: see the full changelog at https://github.com/redos7/SharePermissions/blob/master/CHANGELOG.md