Easy, fully configurable and customizable custom roles for your SCP:SL Server!
- LabAPI >=
v1.x - Harmony (
0Harmony.dll) >=v2.x
Note
The localized READMEs are written and updated by volunteers from the community, so they can fall behind this one. If a translation is missing something, or says something different, this English README is the one that is up to date.
UncomplicatedCustomRoles or UCR is a plugin for LabAPI that lets you create fully configurable and customizable custom roles with YAML.
A custom role starts from a normal SCP:SL role and changes whatever you want about it: health, items, effects, spawn point, team, custom info and much more.
With UCR, you can fully customize your Custom Roles by modifying almost every setting, allowing you to create whatever you can imagine: the only limit is your imagination
Health, AHP, hume shield, stamina, scale, nickname, badge, role name, custom info, effects, damage multiplier, inventory, ammo, item limits and custom items: make your SCP:SL server one-of-a-kind!
Pick how every role spawns: a random room, a whole zone, specific rooms, a spawn point you saved in-game, the position of another role, the Class-D cells, or simply wherever the player already is.
Then tune when it happens: spawn chance, spawn delay, how many can be alive at the same time, the minimum amount of players, which vanilla roles it may replace and the permission a player needs to get it.
Add extra mechanics to a role with a single line of config: damage resistance, life stealing, custom keycard permissions, item bans, pacifism until the role takes damage, silent footsteps, tesla gates and SCP-096 that ignore the role, a fake team, a custom custom info layout, a schematic attached to the player, and many more.
Decide whether a role can escape and which role it becomes afterwards — with a different outcome depending on whether it escaped free or cuffed, and by whom — and let it keep its inventory on the way out.
UCR integrates out of the box with UncomplicatedCustomItems, UncomplicatedCustomTeams, Exiled CustomItems, ScriptedEvents, SLWardrobe, RespawnTimer and LabApiExtensions.
Every role is checked while it is being loaded, and UCR tells you in the console what is wrong with it, so a typo in a config does not turn into a broken round.
Manage your custom roles using the many built-in commands provided by UCR:
ucr list, ucr info, ucr role, ucr spawn, ucr cinfo, ucr reload, ucr spawnpoint, ucr percentages, ucr errors, ucr generate, ucr update, ucr version and more.
You don't need to know how to code to use UCR: custom roles are created using yml (YAML) files, an extremely easy and intuitive serialization language!
Check out the official UCR documentation, where you'll find everything you need to use the plugin: from getting started to advanced settings!
UCR was also designed to make life easier for developers: integrating with the plugin is simple, intuitive, and well-documented!
Check it out!
Join our Discord community to chat with other users and even the developers!
Interact, ask for help, share your knowledge and your roles: we’d love to have you!
To track bugs and UCR planning, UCSC has made a FlySpray instance available.
bugs.ucserver.it
Check the documentation
UCR is a plugin made by UCS Collective.
Every plugin we create is free and open-source, and it always will be.
What there is, is the time we spend writing the plugin, answering your questions on Discord and keeping everything working after every SCP:SL update.
If UCR is running on your server, please consider donating something through OpenCollective — every contribution, however small, goes straight back into the plugins you are using:
DonateDiscord: https://discord.gg/5StRGu8EJV
Discord: @foxworn
Email: foxworn3365@gmail.com
Discord: medvemarci
Discord: dr.agenda
Français: @robocnop
Italiano: @foxworn
Русский: @naxefir
Deutsch: @seekedstroy
Polski: @.piwnica2137
简体中文: @Raiden-Yayi