Skip to content

Repository files navigation

VERSIONDOWNLOADSDISCORD

Round Reports

An SCP:SL Exiled plugin which generates reports at the end of each round, and shares them in your Discord server. Also includes end-of-round broadcasts, with support for over 20 different round statistics displayed in these broadcasts. This plugin supports Serpent's Hand and UIU Rescue Squad, and will display stats accordingly.

This plugin uses paste.ee for hosting reports. This service is not affiliated with RoundReports, and they have their own Terms of Service you must abide by when using this plugin. By default, reports automatically expire after 30 days; however, this can be configured, and reports can be saved with a simple tool like the Wayback Machine.

Important Notes:

  • This plugin requires Newtonsoft.json in your plugin's dependencies folder in order to work. Click here to download it.
  • Statistics from users with Do Not Track (DNT) enabled are treated differently, please see "Note on DNT Players" section below.

Supported Plugins

  • SCP-008-X (User must have "IsScp008" session variable)
  • SCP-035 (User must have "IsScp035" session variable)
  • Serpent's Hand (User must have "IsSH" session variable)
  • UIU (Unusual Incidents Unit) (User must have "IsUIU" session variable)

Commands

pausereport

Permission: rr.pause
Disables reporting for the duration of the round. Automatically unpauses at the start of the next round.

addremark / remark

Permission: rr.remark
Adds a remark to the report. Can be used to specify event rounds & etc.

mvp

Permission: N/A
Parent command to add and remove MVP points.

mvp add

Permission: rr.mvp.add
Grants the amount of points to the player.

mvp remove

Permission: rr.mvp.remove
Removes the amount of points from the player.

Note on DNT Players

Players with Do Not Track enabled will never have their username present on reports. How their stats are handled is based on the ExcludeDNTUsers config. If this config is set to true, no stats at all will be recorded except for kill logs (in which case their name will be removed). If this config is set to false, their stats will still be included but their name will be removed. Do Not Track players will never be included in the MVP statistics, regardless of this setting's value.

MVP Statistic Info

MVP is calculated by granting players points for specific actions. These points can also be taken away by other actions. There are two separate point systems, and as such two separate MVPs: One for SCPs, and one for humans. Full list of actions and the default points they grant or remove below (can be configured).

Human Points

ActionPoint Change
Kill SCP+10
Escape+5
Kill Scientist+3
Kill Player (Not Scientist)+2
Open Warhead Panel (Surface)+2
Unlock Generator+1
Escape (cuffed as Class-D)+0
Escape (cuffed)-1
Die (Most Causes)-1
Die (Warhead, Decontamination, Tesla)-2
Take 3 Candies-10
Kill Teammate-10

SCP Points

ActionPoint Change
Level Up (SCP-079)+5
Tesla Gate Kill (SCP-079)+5
Kill Scientist+3
Kill Player (Not Scientist)+2
Open Door (SCP-079)+0-2**
Kill Assist (SCP-079)+1*
Capture Player (SCP-106)+1
Die (Most Causes)-5
Die (Warhead, Decontamination, Tesla)-10

*+1 for each player in a room that SCP-079 has blacked out/locked down. Does not include SCPs, Tutorials, and Serpent's Hand (if the plugin is installed).
**+1 if the door is a keycard door and there is an SCP nearby. +2 for keycarded gate with SCP nearby.

Stats

Every stat below can be disabled in the config by adding its respective key to the IgnoredStats config (with the exception of stats denoted with a *). Some of the following stats can be used in end-of-round broadcasts, and the Discord embed footer config. Note that arguments must be surrounded by curly braces and capitalized (eg. {HUMANMVP}).

KeyAvailable in BroadcastsDescription
AdrenalinesConsumedThe total amount of adrenalines consumed.
AllActivationsEach SCP-914 mode and the total amount of activations.
AllUpgradesEach item type and the amount of times it's been upgraded in SCP-914.
AverageDamagePerPlayerThe average amount of damage dealt per player (total damage divded by amount of players)
AverageShotsPerFirearmThe average amount of shots per firearm (total shots divded by amount of firearms)
ButtonUnlockedYes/No if the warhead button was opened.
ButtonUnlockerYesThe name of the player who unlocked the warhead.
CandiesByPlayerEach player and the amount of candies they've taken from SCP-330.
CandiesTakenYesThe total amount of candies taken from SCP-330.
ChaosKillsYesThe total amount of Chaos Insurgency kills in the round.
DamageByPlayerEach player and the amount of damage they've dealt.
DamageByTypeEach damage type and the amount of damage dealt.
DClassKillsYesThe total amount of Class-D kills in the round.
DetonatedYes/No if the warhead was detonated.
DetonationTimeThe time the warhead was detonated.
DoorsClosedYesThe total amount of closed door interactions.
DoorsDestroyedYesThe total amount of destroyed doors.
DoorsOpenedYesThe total amount of open door interactions.
DropsEach item type and the amount of times it's been dropped.
EndTimeThe end time of the round.
ExpireDate*YesThe date that the report will expire, in Discord time formatting.
FirearmUpgradesThe total amount of times a firearm was upgraded.
First330UseThe time in the round the first SCP-330 candy was obtained.
First330UserYesThe name of the player who used SCP-330 first.
First914ActivationThe time in the round the first SCP-914 cycle was activated.
First914ActivatorYesThe name of the player who activated SCP-914 first.
FirstWarheadActivatorYesThe name of the player who activated the warhead first.
HumanMVPYesThe human MVP of the round.
HumanKills*YesThe total amount of human kills in the round.
HumanPointsEach player who has played a human role and the amount of points they've received.
Id*YesUnique ID of the round-specific report.
KeycardScansYesThe total amount of keycard scans.
KeycardUpgradesThe total amount of times a keycard was upgraded.
KillsByPlayerEach player and their amount of kills.
KillsByTypeEach death type and the total amount of kills of that type.
MedkitsConsumedThe total amount of medkits consumed.
MostTalkativePlayerThe person who used voice chat the most. Overwatch players not included.
MTFKillsYesThe total amount of MTF kills in the round.
PainkillersConsumedThe total amount of painkillers consumed.
PlayerCount*YesThe total amount of players currently connected to the server.
PlayerDamageThe total amount of damage dealt by players.
PlayerDoorsClosedEach player and the amount of doors they've closed.
PlayerDoorsOpenedEach player and the amount of doors they've opened.
PlayerDropsEach player and the amount of items they've dropped.
PlayerKillsEach player and the amount of players they've killed.
PointLogsA log for each time points are added or removed.
PostDate*YesThe date that the report was posted, in Discord time formatting.
RespawnsEach respawn that occurs.
ReportLink*YesLink to the report.
RoomsByZoneA list of each zone and the amount of rooms it contains.
RoundTimeYesThe total time of the round.
ScientistKillsYesThe total amount of scientist kills in the round.
Scp018sThrownThe total amount of SCP-018s thrown.
Scp049RevivesThe total amount of revivals by SCP-049.
Scp079CamerasUsedThe total amount of cameras SCP-079 has visited. Only shown if value is greater than 0.
Scp079MostUsedCameraThe camera SCP-079 used the most. Will not be shown if not applicable (no SCP-079).
Scp079TierThe highest tier that SCP-079 reached.
Scp096ChargesThe total amount of SCP-096 charges. Only shown if value is greater than 0.
Scp096EnragesThe total amount of SCP-096 enrages. Only shown if value is greater than 0.
Scp106TeleportsThe total amount of SCP-106 teleports. Only shown if value is greater than 0.
Scp173BlinksThe total amount of SCP-173 blinks. Only shown if value is greater than 0.
Scp173TantrumsThe total amount of SCP-173 tantrums. Only shown if value is greater than 0.
Scp1853UsesThe total amount of SCP-1853 uses.
Scp207sDrankThe total amount of SCP-207s drank.
Scp268UsesThe total amount of SCP-268 uses.
SCP500sConsumedThe total amount of SCP-500s consumed.
Scp939LungesThe total amount of SCP-939 lunges. Only shown if value is greater than 0.
Scp939CloudsThe total amount of SCP-939 amnestic clouds. Only shown if value is greater than 0.
SCPKillsYesThe total amount of SCP kills in the round.
SCPMVPYesThe SCP MVP of the round.
SCPPointsEach player who has played an SCP and the amount of points they received.
SerpentsHandKillsThe total amount of Serpent's Hand kills (only if the plugin is installed).
ShotsByFirearmA list of each firearm and the amount of times it was fired.
SeveredHandsThe total amount of hands severed from SCP-330. Only shown if value is greater than 0.
SpawnWavesYesList of each spawn wave. Converts to the total amount of respawn waves in broadcasts.
StartClassDThe amount of Class-D personnel at the start of the round.
StartFacilityGuardThe amount of Facility Guards at the start of the round.
StartPlayersThe total amount of players at the start of the round.
StartScientistThe amount of Scientists at the start of the round.
StartSCPA list of every SCP at the start of the round.
StartTimeYesThe time that the round started.
SurvivingPlayersEach player that is alive at the end of the round.
TeslaDamageTotal amount of tesla damage delt in the round.
TeslaShocksTotal amount of tesla activations in the round.
Total914ActivationsYesThe total amount of times SCP-914 was activated.
TotalCandiesTakenYesThe total amount of candies taken.
TotalDamageYesThe total amount of damage dealt.
TotalDeathsYesThe total amount of deaths.
TotalCamerasThe total amount of cameras on the map.
TotalDoorsThe total amount of doors on the map.
TotalDropsYesThe total amount of items dropped.
TotalInteractionsYesThe total amount of interactions that took place (doors, elevators, Scp330, etc)
TotalItemUpgradesYesThe total amount of item upgrades.
TotalKillsYesThe total amount of kills in the round.
TotalReloadsYesThe total amount of firearm reloads.
TotalRespawnedYesThe total amount of respawned players.
TotalRoomsThe total amount of rooms generated.
TotalShotsFiredYesThe total amount of shots fired.
TotalTeslaGatesTotal amount of tesla gates in the round.
TutorialKillsThe total amount of tutorial kills. Only shown if value is greater than 0.
UIUKillsThe total amount of UIU kills (only if the plugin is installed).
UptimeRound*YesThe number of rounds since the server has last restarted.
WinningTeamYesThe winning team of the round.

* Stat is only available as broadcast/embed arguments. This stat cannot be used in IgnoredStats and will not show up on the round report.

Note: The StartSCP stat is updated 60 seconds into the round to account for early SCP deaths, SCPSwap, etc.

About

SCP:SL Plugin which generates reports at the end of each round.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages