SCPUtils [Mongo DB Edition] Plugin:

This is the list of SCPUtils features with a brief description, i recomend to read configs:

• Welcome Message: You can set in server config a welcome broadcast that every player join will see.
• Decontamination Message: A broadcast that all players will see when decontamination starts
• Auto-Restart: Having only one player in server may cause round stuck forever, with this plugin you can avoid it!
• Advanced SCP Suicide / Quit punishements: If a SCP suicide or leave the server you can punish him, with warns, kicks or bans, depending on settings you use and DC/Suicide percentage player has (configurable also for tutorial role)
• Temporarily badges: Sometimes may be useful to give a player a temporarily role for event winners and donators (or anything else you want), with this plugin it's easy, see commands list.
• Custom nicknames: Admins with permission can set any nickname to any player in server using admin console, users with permission can set their own nickname using a simple command on User's console.
• Nickname Blacklist: You can prevent players joining with blacklisted nicknames and preventing them to change nicknames to restricted ones, users with bypassnickname permission bypass this limit!
• Badge colors: Admins can assign a color to every person, users with permissions can assign any color to themselves if it's not in restricted list!
• Permanently show/hide badges: Users with permission can permanently show or hide badge using a simple command (in user console)
• Playtime statistics: You can see each user playtime day per day or total playtime using a simple command, you can also see overwatch time!
• ASNs Bans: You can ban specific ASNs to avoid ban evaders and cheaters, you can whitelist legit users to bypass the ASNs bans using a simple command, to add an ASN to blacklist add it inside server config setting.
• Team protection: Editing configs you can set protection to the teams you want against the teams you want on specific zones or entire map.
• SCP-096 Target: Players gets notified via hint when they become a SCP-096 Target.
• Last Player: Players gets notified via hint when they are the last player of the Team.
• Custom Hints / Broadcast: You can save hints / broadcasts in the database and use them easily by the ID.
• Multi account detector: Auto-detects multi accounts and based on plugin settings it informs the administrators, you can also set a webhook for reports about mute evaders (you can also remute them automatically by changing configs), you can also exclude specific asns or players from the detector
• Handcuff ownership: By simply updating a config only who cuff the player will be able to uncuff it.
• SCP-Swap: By setting a config you can decide the max allowed time for SCP-Swap requests and if the SCP has to be full health for swap to be allowed, you can configure swap even for scps that are not spawned.
• Translations: You can translate the majority of parts of the plugin (with some exceptions on some staff commands), to use a translation head over to Localization folders on github and if it's present copy and paste the content inside Configs/port-translations.yml, if you wish you can contribute by sending your translation here so other users can use it (read at bottom to see how to do it)

To use this plugin you will have to install MongoDB and MongoDB Compass (the last one only if you want to manage your database).

LiteDb SCP-Utils version is still avaible but with limited support, check releases tab. It's advisable to use this version, for more info check pinned message in SCPUtils channel on Exiled.

Minimum requirements: Exiled version: 7.2.0 and MongoDB (depedencies are already included by base)

Configs:

You can see settings and edit them inside Exiled/port-config.yml file(example Exiled/7777-config.yml)

Commands

Admin commands and Game console commands

Console commands

Generic permissions

Pro tip: use scputils_speak.* to allow someone to speak with all the SCPs, set permission to default role to allow everyone to speak with that scp.

Console commands must be executed like .scputils_help in game console (press ò to open it)

Round Info

This command allows to show advanced round info and users are able to use it by default to see informations about their own team (using user console), if you don't like that just edit configs. It has also the following permissions (those bypass server config):

Online List

This command show online player list, it's also usable by users on normal console, it uses advanced permissions like past command.

Config Example

To edit your configs you must go into EXILED folder and edit port-config.yml file (example 7777-config.yml), and edit them

To edit permissions you must go into Plugins/Exiled Permissions folder and edit permissions.yml file, bellow you can see a sample config

    user:
    inheritance: []
        default: true
        permissions:
        - scputils_speak.scp049
    owner:
        permissions:
        - scputils.*
        - scputils_speak.*
    admin:
    inheritance: []
        permissions:       
        - scputils.playerinfo
        - scputils.playerlist
        - scputils.changecolor
        - scputils.changenickname
        - scputils.badgevisibility
        - scputils.playerresetpreferences
        - scputils_speak.*      
    vip:
    inheritance: []
        permissions:        
        - scputils.changecolor
        - scputils.changenickname     
        - scputils_speak.*    

Team protection

ClassD = Class-D
ChaosInsurgency = Chaos Insurgency
FoundationForces = MTF Team (included guards)
Dead = Spectators
Scientists = Scientist
SCPs = SCP
Tutorial = Tutorial

Sample Config for team protection:

In the following example we will protect Class-D against MTF team and Scientist, since they are listed on cuffed_protected_teams they require to be handcuffed to be protected. They also must be in Entrance or Surface to get protection.

  # You have to add the team you want to protect from the target as key and enemy teams on the list as value, on github documentation you can see all the teams.
  cuffed_immunity_players:
    CDP:
    - MTF
    - RSC
  # Indicates if the protected teams should be cuffed to get the protection, if you don't add a team it will get protection regardless
  cuffed_protected_teams:
  - CDP
  # Indicates in which zones the protected team is protected, Zone list: Surface, Entrance, HeavyContainment, LightContainment, Unspecified }
  cuffed_safe_zones:
    CDP:
    - Entrance
    - Surface

Using scputils. grants every permission that starts with prefix scputils Using '' grants every possible permission on the server
To verify if you yml file is valid paste it into this website: http://www.yamllint.com/
Note: you must add every group in permissions don't forget default one

Translations

To submit a translation head over to the Localizations folder, take the english one and translate it, after finishing review it and check if the yaml check passes on this website: https://www.yamllint.com/

If everything is fine open a pull requst for adding that file, the file name should be Language.yml

Thank you if you wish to help, don't forget to add yourself to TranslationCredits.

Data stored on database is intended only for internal use, sharing it is a violation of SCP:SL EULA and will cause your server delist.

Thanks to iopietro and Exiled community for the advices