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

SharePermissions

Share host permissions among trusted players

Date uploaded 4 days ago
Version 2.42.2
Download link redos7-SharePermissions-2.42.2.zip
Downloads 145
Dependency string redos7-SharePermissions-2.42.2

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
  • Spectate any player in third person, with sound, and talk with the dead
  • A heads-up when a player may have killed a teammate or lost a lot of loot, with a key to watch them
  • 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 button is also on the game's main menu, right after the R.E.P.O. logo, for every player with the mod.

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. A row also shows players killed, deaths and valuables lost, once any of them is not zero.
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 in this host's lobbies
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

On the main menu the panel shows two tabs, Settings and Recent. Settings holds everything a host sees in a lobby, under the line "Lobby settings apply when you host.", so a host can prepare the lobby before it opens, and any player can set their language, keys, notifications and looks. Who can join (Everyone, Friends only, Invites only, Nobody) is first in the Room group there; it is the same setting as the lobby's switch under the Mod button, shown in red when the lobby will not be open to everyone. My head (Settings > Looks) works there too: a look you build is saved and sent to the host of the next lobby you join, and whether that host shows built heads is still theirs to decide. The other tabs need a lobby, and a moderator's own head and name color picks are set in the host's lobby, not on the main menu. Nothing is sent to anyone from the main menu.

Permissions

A new moderator gets all nine. 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 or Spectate existed don't have that permission until the host turns it on for them.

Permission What it allows
Kick Kick players
Ban Ban players until the lobby is closed
Persistent ban Ban that lasts between sessions, for 1, 7 or 30 days or permanently, kept on the host's ban list

Ban opens one page with every length you may give: Until the lobby is closed, For 1 day, For 7 days, For 30 days and Permanently. The first needs the Ban permission, the others Persistent ban. | 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 | | Spectate | Watch a player in third person from the Members tab, and move next to them to talk |

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

Spectate

The host, and moderators with the Spectate permission, can watch any player, alive or dead. Open the Mod panel during a run (F7), point at the player on the Members tab and press the right mouse button, or click the player and press Spectate. While the pointer is on a player you can spectate, the line under the list names the key; change it under Settings > General > Members spectate key (any key, or the right, middle, 4th or 5th mouse button). Nobody but the host can watch the host. You get the view the game gives dead players: the camera circles that player, the mouse turns it, the wheel zooms, and you hear them and everything around them. Press the left mouse button to move to the previous player or the right mouse button to move to the next. Press Esc to go back to your own eyes, standing where you stood when you started.

While you watch, the body you left standing takes no damage, can't be knocked into a tumble and is out of the game's physics: nothing pushes it, it doesn't fall, and thrown things and carts go through it. With a host on this version enemies don't notice it either. Players who run this mod don't see your body at all; players without it see it crawling with its flashlight off. Nobody bumps into it, with or without the mod, and it blocks no object or cart under any host.

A dead player is watched over their head, wherever it lies or is carried, and while the player you watch is dead you are in dead chat: you hear the dead talk, and they hear you. If the player you watch dies, you stay with them and switch to dead chat; if they are revived, you switch back. You are never shown in the game's list of the dead.

A strip at the top of the screen shows the keys while you watch, each as a key cap, and under them what your game has seen the watched player do since you joined the lobby: players killed, deaths and the value of valuables they broke.

  • LMB / RMB: the previous and the next player. The first row of the strip shows the watched player's name in the middle, the previous player's name after LMB on the left and the next player's name before RMB on the right. With only one other player, only the right side shows.
  • 1 Speak: switches following on and off. While it is on your body stays a step behind the watched player wherever they go, so they hear your voice; the caption turns green. You keep watching, and switching it off, or Esc, puts you back where you started. Not shown while the watched player is dead: dead chat carries your voice then.
  • 2 Kick: press it, then press it again within a few seconds to confirm. Esc cancels.
  • 3 Ban: opens the ban page with every length you may give.
  • 4 Everyone hears you / Only they hear you: who receives your voice. With "only they", the watched player is the only one your voice is sent to, so nobody else hears you, with or without the mod. Use it with Speak to talk to them privately. Kept for the next spectate.
  • H Revive / Heal (your Revive & heal key): revives the watched player if they are dead, getting them up where their head lies, or tops up their health if they are alive. Shown in a level to the host and to moderators with the Revive & heal permission.
  • Esc: stop watching.

Kick and Ban are red, and show only if you have that permission and may remove that player.

Good to know:

  • While you watch, your body is protected: it takes no damage, and with a host on this version enemies don't notice it. It can't move, grab or use items, and your microphone still speaks from it, so without Speak the watched player hears you only if they are near your body.
  • The numbers are what your own game saw, so they start when you joined, and "players killed" is a best guess: a player who died within three seconds of being hit by something the watched player held, threw, drove or set off, unless an enemy killed them. It also counts a player who died while the watched player was carrying them or had let go of them within three seconds. Nothing is counted in the arena.
  • Dead chat while you are alive is this mod's doing, so it has limits. You hear the dead under any host. The dead hear you in dead chat only if they run this mod too; a dead player without it hears you as before, from your body. Players who are alive and run the mod stop hearing you while you are in dead chat. A moderator needs a host on this version for the speaking half.
  • The mouse buttons go through the Members list in its order, dead players included, and around again at both ends. With nobody else to watch they do nothing. The click that starts a spectate, or that closes a panel opened over it, never switches. The Watch key on a kill or loot notification, and the Spectate button or spectate key on the Members tab used with the panel open over a spectate, move the view to that player too; the row of the player you already watch offers no spectate key.
  • A switch keeps the same view on the new player. Speak switches off and your body goes back to where you started. A pending "press again" to kick is cancelled, so one press can never kick the player you just switched to. Switching onto a dead player puts you in dead chat; switching to a living one takes you out ("NAME is alive. Dead chat is off.").
  • The keys on the strip say LMB and RMB even if you rebound the game's keys or use a gamepad, and every switch resets the zoom.
  • Spectating stops on its own when the watched player leaves and when the level ends.
  • It works in a level, the shop and the truck, not in the lobby menu or the arena. You can start it while knocked over or sitting in a vehicle: your body gets up first.
  • Nobody is told that they are being watched. History records the player you start on and each player you then stay on for 3 seconds or more; players you click past leave no line. Under a host on an older version of this mod, History is as before.
  • A moderator needs a host on this version.

Kill and loot alerts

The host and moderators get a notification when a player may have killed a teammate ("NAME may have killed VICTIM"; kills at nearly the same moment come as one, "NAME may have killed 3 players"), or has lost $10,000 of valuables or more within a minute ("NAME: $12,400 of valuables lost in a minute"). It is a heads-up from what your own game saw, not proof. Friends who knock each other about will raise alerts: turn them off with Warn about player kills and lost valuables under Settings > Alerts, where Lost valuables alert sets the amount ($1,000 to $50,000). While one is on screen, press the Watch key (J) to spectate that player; a moderator needs the Spectate permission for that, and otherwise gets the notification only. A moderator is alerted about plain players, never the host or another moderator. Nobody is alerted about themself. On the Members list a player's row ends with players killed, deaths and valuables lost (a legend line above the list names them), shown once any of them is not zero. The numbers start when you joined the lobby. A moderator never sees numbers on the host's row, so an empty host row is expected. Each game alerts on what it saw itself, and nobody is told they were flagged. Nothing is counted in the arena.

The host's game also writes its alerts to History, as Possible teamkill or Possible loot loss with the player's name and Steam ID, and History shares them with the moderators as it shares everything else. It is worded as a guess and names only that player. At most one line per player a minute is written; the next one says how many alerts were left out. The host can turn this off with Record kill and lost-valuables alerts under Settings > History, separately from whether the alerts show on screen.

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. LateJoinPlus 1.2.2 asks you to pick one of the two at the main menu. Press the green Keep SharePermissions with LateJoin functionalities button to keep both; the window closes, no restart, and it does not ask again. Its own Keep LateJoinPlus stops SharePermissions loading, and its Keep SharePermissions turns all of LateJoinPlus off, late joining included.

Keys

  • F7: open or close the Mod panel (change it in Settings > General). It works on the main menu too, once the menu's intro is over, but not over the game's own Settings or Cosmetics pages.
  • 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. While you spectate, the key works on the player you watch instead, dead or alive.
  • J: spectate the player a kill or lost-valuables alert names, while the alert is on screen (host, and moderators with the Spectate permission). Change the key in Settings > General > Watch key.
  • Left / right mouse button: while you spectate, watch the previous / next player.

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.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.

2.42.1

Fixed

  • Conflict with LateJoinPlus 1.2.2 fixed: both mods run together again. LateJoinPlus 1.2.2 kept SharePermissions from loading at all, blocked the main menu with a "Mod conflict" window, and closed the game once you picked one of the two mods. Now:
    • SharePermissions loads beside it. This version adds a small preloader of its own (SharePermissions.Preloader.dll, which your mod manager puts in BepInEx's patchers folder).
    • The "Mod conflict" window has a big green Keep SharePermissions with LateJoin functionalities button. Press it once to keep both: the window closes, the menu works, no restart is needed, and the window does not ask again.
    • LateJoinPlus keeps only what SharePermissions doesn't do: joining a run in progress, bigger lobbies and map sync. Its moderation, Lobby Guard, calls and phone, admin panel, name colors, countdown, menus and keys are switched off, so nothing runs twice.
    • A choice you already made still counts. With Keep LateJoinPlus, SharePermissions stays unloaded. With Keep SharePermissions, all of LateJoinPlus stays off, late joining included. Set Mod conflicts > SharePermissions back to Ask in LateJoinPlus's config to get the green button.

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