UCR v9.2.0

UncomplicatedCustomRoles v9.2.0

It's been a VERY long time but we're here with a new, incredible version of UCR for both EXILED and LabAPI!

Important

It might be stupid to say but if you are using EXILED download and install the UncomplicatedCustomRoles-EXILED.dll, otherwise download and install the UncomplicatedCustomRoles-LabAPI.dll!
Yeah, Custom Roles configuration files can be used with both versions

Here's the changelog:

What's new

• Updated the RespawnTimer integration
• Added the support to MapEditorReborn and ProjectMER through the Schematic Custom Flag
• Added the support to SLWardrobe through the Wardrobe Custom Flag
• The Team config param now actually works as intended (almost)
• Added the AmnesiaResistance, DamageResistance and KeepInventoryOnEscape Custom Flags

Bug fixes

• Now the HTTP requests use the HttpQuery for a better optimization
• The escape checker is now more optimized

Note

Remember to check always out UCR's official documentation: https://docs.ucr.ucserver.it/

---

Caution

If you don't have the file Newtonsoft.Json.dll inside your dependencies folder please download the following one and put it in the folder!

Needs support?

Join our official Discord support server to ask question(s)!

Wants to support the project?

UncomplicatedCustomServer Collective is a no-profit organization that develops free and open-source plugins for EXILED and NWAPI.
Because of that we don't get paid and you know how useful moneys are (they even boost our morale!), so please consider donating somehting through our OpenCollective official page!
Thank you :D

This release was made possible thanks to

• @pizzacat100 for their sponsorship with us (over and over ❤️)
• @medvemarci, our UCR Developer that maintains the LabAPI version - thanks! :D

Contacts

Email: contact @ ucserver.it
Discord server: https://discord.gg/dpvHzC5mst
My discord: @foxworn

UCR v9.0.0

UncomplicatedCustomRoles v9.0.0

It's been a long time but we're here with a new, incredible version of UCR for both EXILED and LabAPI!

Important

It might be stupid to say but if you are using EXILED download and install the UncomplicatedCustomRoles-EXILED.dll, otherwise download and install the UncomplicatedCustomRoles-LabAPI.dll!
Yeah, Custom Roles configuration files can be used with both versions

Here's the changelog:

What's new

• Added the FullCandyBag Custom Flag that will allow you to add to the Custom Role's inventory a CandyBag with all candies you want
• Added the ColorfulNickname to allow Custom Roles to have a colored nickname in their info areas
• Added the ColorfulRaName to allow Custom Roles to have a colored nickname on the Remote Admin player list
• Added the OnRemoved() method inside the EventCustomRole class
• Now you can color every part of the player info area by using the <color=></color> tag (for the nickname please use the Custom Flag)

Bug fixes

• Fixed the performance issues (TPS loss) caused by UCR D1
• Now custom appearance and custom scale of a spawned Custom Role will be "visible" to all players, even those who joined after.
• Fixed the cuff bug D2
• Fixed the Player Info button on the remote admin by using LabAPI events [EXILED Version]
• Fixed the OnSpawned() method inside the EventCustomRole class not being called
• Fixed RoundStart spawning [LabAPI version]

Removed

• The team configuration param COULD not work as intended and cause errors in the console/server crash: please avoid using it in production!

Note

There's a new official documentation (wiki) that you should follow instead of the GitHub's one: https://docs.ucr.ucserver.it/

---

Caution

If you don't have the file Newtonsoft.Json.dll inside your dependencies folder please download the following one and put it in the folder!

Needs support?

Join our official Discord support server to ask question(s)!

Wants to support the project?

UncomplicatedCustomServer Collective is a no-profit organization that develops free and open-source plugins for EXILED and NWAPI.
Because of that we don't get paid and you know how useful moneys are (they even boost our morale!), so please consider donating somehting through our OpenCollective official page!
Thank you :D

This release was made possible thanks to

• @pizzacat100 for their sponsorship with us (over and over ❤️)
• @medvemarci, our new UCR Developer that will maintain the LabAPI version - thanks! :D

Contacts

Email: contact @ ucserver.it
Discord server: https://discord.gg/dpvHzC5mst
My discord: @foxworn

UCR v7.0.0 for EXILED 9.5 - SCP:SL 14.0

UncomplicatedCustomRoles v7.0.0 for EXILED 9.5 and SCP:SL 14.0

This is probably the best version of UCR I've ever released haha.
It contains lots of user-friendly improvements :D

What's new?

• Added the compatibility manager: now you won't have to update anymore your roles as UCR will automatically load them (without modifying them) and make them work as best as possible.
• Almost every command now has a freshly new user-friendly and more compact UI.
• Added the ucr errors command to see which roles were not loaded due to YAML errors.
• Added the ucr update command to update old UCR roles without losing your configuration.
• Added the ucr percentages command to see the percentages spawn of every Custom Role depending on vanilla roles.
• Added the ucr debug command to allow a better debugging to developers (DON'T USE IT IF YOU DON'T KNOW WHAT ARE YOU DOING).
• Added the CustomPermissions flag to give the player more EXILED permissions.
• Added multiple pointers for ucr spawn: read more here
• Now the ucr reload command does reload no matter what.
• Now the custom_inventory_limits can also be greater than the vanilla ones!
• Revamped the console messages, now they are more user-friendly and beautiful :3 (yeah I've changed colors)

Bug fix

• Fixed the ammo drop when spawn if you exceeded the maximum capacity.
• Generic bug fix

Removed

• Removed the Id assigner: now if two roles have the same Id only one will be loaded, the other will throw an error.

Note

There's a new official documentation (wiki) that you should follow instead of the GitHub's one: https://docs.ucr.ucserver.it/

---

Caution

If you don't have the file Newtonsoft.Json.dll inside your dependencies folder please download the following one and put it in the folder!

Needs support?

Join our official Discord support server to ask question(s)!

Wants to support the project?

UncomplicatedCustomServer Collective is a no-profit organization that develops free and open-source plugins for EXILED and NWAPI.
Because of that we don't get paid and you know how useful moneys are (they even boost our morale!), so please consider donating somehting through our OpenCollective official page!
Thank you :D

This release was made possible thanks to

• @naxefir for some testings :3
• @pizzacat100 for their sponsorship with us (over and over ❤️)
• @.piwnica2137 for being our first UCR Reliability Analyst and for countless (<3) testings!
• @shadowarisu527 for testing the version as our second UCR Reliability Analyst
• @yourfate420_ for testing the version as our third UCR Reilability Analyst. Welcome!

Contacts

Email: contact @ ucserver.it
Discord server: https://discord.gg/dpvHzC5mst
My discord: @foxworn

UCR v6.0.0 for EXILED 9

UncomplicatedCustomRoles v6.0.0 for EXILED 9

Finally after like 2 months the new version everyone was waiting for!

Caution

This new release comes with a different YAML configuration of Custom Roles.
Luckly for y'all I've added an "auto updater" that will automatically convert your Custom Roles only from v5.0.0 to v6.0.0.

It will work automatically, just keep everything as-it-is :)

What's new?

• Now you can deny the escape in role_after_escape by using the Deny key
• Added support for Custom Roles loading inside folders. Now you can put every Custom Role you want inside like UncomplicatedCustomRoles/BasicClasses and they will be loaded anyways (the folder CAN'T BE A NUMBER!)
• Updated the Custom Flag and Custom Module thing: now other plugins can register their own Custom Modules and they can be used by Custom Roles through Custom Flags (and now they support args!)
• Updated the ucr list command: now you can search the role by name using ucr list <search param> (example: ucr list jan)

Bug fix

• Fixed the ucr list error
• Fixed the ucr base command error
• Fixed every custom flag that now can work with their logic correctly
• Fixed the debugging: now it's more easy to read (changed also colors)
• Fixed the EXILED Custom Items integration error
• Fixed some generic error related to the spawn code

Removed

Nothing :)

---

Caution

If you don't have the file Newtonsoft.Json.dll inside your dependencies folder please download the following one and put it in the folder!

Note

If you are a Developer and you are using UCR APIs please DM me IMMEDIATLY (Discord)!

Needs support?

Join our official Discord support server to ask question(s)!

Wants to support the project?

UncomplicatedCustomServer Collective is a no-profit organization that develops free and open-source plugins for EXILED and NWAPI.
Because of that we don't get paid and you know how useful moneys are (they even boost our morale!), so please consider donating somehting through our OpenCollective official page!
Thank you :D

This release was made possible thanks to

• @naxefir for some testings :3
• @pizzacat100 for their sponsorship with us (over and over ❤️)
• @.piwnica2137 for being our first UCR Reliability Analyst and for countless (<3) testings!
• @shadowarisu527 for testing the version as our second UCR Reliability Analyst

Contacts

Email: contact @ ucserver.it
Discord server: https://discord.gg/dpvHzC5mst
My discord: @foxworn

bangwI' SoH, Sashimi

UCR v5.0.0 for EXILED 9

UncomplicatedCustomRoles v5.0.0 for EXILED 9

The first version of 2025 yeee

What's new?

• Added the new ucr list page: it will show more info about the roles in a more eye-friendly way!
• Added the error logger: now every role that doesn't get loaded due to a YAML error is also shown inside the role list with the error
• Added the new version checker: through our central servers the plugin will check if everything is OK (it will check also if the hashes are the same, in order to prevent malicious versions from being used)
• Added the version recaller: through the new version checker a version can be "recalled" and in the console a message that highly suggest to change the version will appear periodically
• Added the new setting ignore_npcs that will allow the server owner to decide whether the NPCs (so also Dummies) should be evaluated for a natural spawn

Bug fix

• Fixed the override_role_name bug that had a conflict with the custom_info field D4
• Fixed the override_role_name logic in order to mimic the game's one
• Fixed the SCP-096 bug where custom roles weren't evaluated as targets for SCP-096 D1
• Fixed the removal of items from the inventory that were banned by custom flags: the feature only prevents users from picking up these items, not the server owner to give them D3
• Fixed the debug spam when a custom role can't escape but it's standing inside the escape area D2
• Fixed other logic bugs

Removed

Nothing :)

---

Caution

If you don't have the file Newtonsoft.Json.dll inside your dependencies folder please download the following one and put it in the folder!

Needs support?

Join our official Discord support server to ask question(s)!

Wants to support the project?

UncomplicatedCustomServer Collective is a no-profit organization that develops free and open-source plugins for EXILED and NWAPI.
Because of that we don't get paid and you know how useful moneys are (they even boost our morale!), so please consider donating somehting through our OpenCollective official page!
Thank you :D

This release was made possible thanks to

• @naxefir for some testings - you are the best and I wish you the best 😸
• @pizzacat100 for their sponsorship with us (over and over ❤️)
• @.piwnica2137 for being our first UCR Reliability Analyst and for countless (<3) testings!
• @shadowarisu527 for testing the version as our second UCR Reliability Analyst

Contacts

Email: contact @ ucserver.it
Discord server: https://discord.gg/dpvHzC5mst

Iv'e' vIbang 'ar Sov neH Qun

UCR v4.1.1 for EXILED 8.12

UncomplicatedCustomRoles v4.1.1 for EXILED 8.12

Important

Every server owner with a server inside the public list whit v4.1.0 HAS to upgrade to that version!

What's new?

Nothing.

Bug fixes

• Fixed the server name bug, now the UCR name is not visible anymore
• Fixed the spawn of the custom roles at the start of the round
• Fixed the escape bug, now players can escape more than once per round

Removed

Nothing :)

Caution

If you don't have the file Newtonsoft.Json.dll inside your dependencies folder please download the following one and put it in the folder!

Needs support?

Join our official Discord support server to ask question(s)!

Wants to support the project?

UncomplicatedCustomServer Collective is a no-profit organization that develops free and open-source plugins for EXILED and NWAPI.
Because of that we don't get paid and you know how useful moneys are (they even boost our morale!), so please consider donating somehting through our OpenCollective official page!
Thank you :D

This release was made possible thanks to

• @naxefir for some testings - you are the best and I wish you the best 😸
• @pizzacat100 for their sponsorship with us (over and over ❤️)
• @.piwnica2137 for being our first UCR Reliability Analyst and for countless (<3) testings!
• @shadowarisu527 for testing the version as our second UCR Reliability Analyst

Contacts

Email: contact @ ucserver.it
Discord server: https://discord.gg/dpvHzC5mst

JBMP

UCR v4.1.0 for EXILED 8.12

UncomplicatedCustomRoles v4.1.0 for EXILED 8.12

Finally lots of changes 🥂

Warning

This version DOES NOT introduce any changes within the custom roles configuration, so you'll be able to update it without updating every single custom role 😎

What's new?

• Lots of new custom flags such as TutorialRagdoll, DoNotTrigger096, BanKeycards, BanMedicals, BanRadios, BanFirearms, BanGrenades, BanSCPItems, BanMicroHID and BanArmors, to allow y'all an even more customizable experience!
• Is now possible to save the spawnpoints locally inside a .json file instead of inside our central servers

Bug fix

• Updated the API endpoint to the new UCS domanin (ucserver.it)
• Fixed the PacifismUntilDamage
• Fixed the error on OnHurting
• Fixed the Events property of the EventCustomRole class: now devs can use it!
• Fixed the round begin bug, now SCP-016 will pass through doors
• Fixed the infinite effect not working after a restart
• Fixed the role name bug, now it will be able to set it even if the custom_info is empy!
• Fixed the UncomplicatedCustomItems and EXILED CustomItems integrations
• Fixed the team thing, now someone in the SCP team won't make SCP-096 trigger
• Fixed the version checker bug that slowed down the server start: now it's async
• Fixed the command bug: now if you don't have permissions it will show a different error than "Command not found!"

Removed

• Removed the HTTP presence feature and the mailbox feature: now every server will run even more smoothly!

Caution

If you don't have the file Newtonsoft.Json.dll inside your dependencies folder please download the following one and put it in the folder!

Needs support?

Join our official Discord support server to ask question(s)!

Wants to support the project?

UncomplicatedCustomServer Collective is a no-profit organization that develops free and open-source plugins for EXILED and NWAPI.
Because of that we don't get paid and you know how useful moneys are (they even boost our morale!), so please consider donating somehting through our OpenCollective official page!
Thank you :D

This release was made possible thanks to

• @naxefir for some testings - you are the best and I wish you the best 😸
• @pizzacat100 for their sponsorship with us (over and over ❤️)
• @.piwnica2137 for being our first UCR Reliability Analyst and for countless (<3) testings!
• @shadowarisu527 for testing the version as our second UCR Reliability Analyst

Contacts

Email: contact @ ucserver.it
Discord server: https://discord.gg/dpvHzC5mst

:3

UCR v4.0.0 for EXILED 8.11.0

UncomplicatedCustomRoles v4.0.0 for EXILED 8.11.0

This version brings a few changes for those who use the plugin but many nice changes for developers!

Update specifics

Configs: 🔴 BREAKING CHANGES
API: 🔴 BREAKING CHANGES

Caution

This version brings LOTS OF CHANGES from the previous one and every current custom role is not compatible with the v4.0.0!
As I love y'all I've created another online web page where you'll be able to convert role from v3.5.0 to v4.0.0 without big issues!
Suggest you to check the page if you don't want to get crazy: https://ucs.fcosma.it/cgi/converter/350-400

What's new?

• Added the team configuration param: now you'll be able to override the vanilla team of the selected role!
• Added the override_role_name configuration param: if true the vanilla role name in the player info will be hidden and instead the name will be shown
• Added the custom_flags configuration param: you'll be able to add "hard-coded abilities" or apply some special configuration settings with this!
• Added the ucr generate command to make the plugin generate a default configuration file with the given name
• Added the ucr show command to allow you visualize a loaded custom role
• Now you'll be able to see if a player is a custom role and the custom role informations directly from the Remote Admin by requesting player informations - NOTE: it won't work if you have CedMod installed on your server!
• UCR parent command help page now show also the required permission for every subcommand listed
• From now on if you will use a version of UCR that is "greater" than the latest from here debug logs will be automatically enabled
• You can now use [br] in your custom info to invoke the escape char \n

Bug fix

• Fixed every bug that appeared while spawning: now the plugin catches the OnChangingRole event args so you will directly be spawned as a Custom Role without being first spawned as the normal one!
• Fixed the appearance bug: now it's applied from the beginning!
• Fixed the inventory issue when spawning from a Spawn Wave
• Fixed ScriptedEvents support: now it will work without any error - the latest version of SE is required!
• Fixed the OnFinishingRecall bug: now SCP-049 won't be spawned as the custom role instead of the target!
• Fixed the SCP-049-2 spawning bug: now they will spawn without any problem!
• Fixed the OnHurting error and logic: now is_friend_of won't have skill issues
• Now SCP-3114 won't even be able to try to strangle you if is_friend_of has SCPs as a teammates.
• Now random numbers for the role spawning are from Unity.Random -> more randomic
• Now the download URL for the command ucr spawnpoint download it's also sent on the server console
• Now SpawnPoints can also be in the void (not linked to a room) - the coords will be static!
• Now the ucr spawnpoint list command won't give a skill issue error if a SpawnPoint doesn't have a room
• Fixed the Newtonsoft.Json bug and added an assembly check: if the dependency is not installed it prevent some features from being activated!
• Fixed the version checker bug that won't find any new version also if the plugin version was updated
• Fixed the credit system: now Credit Tags will actually load!

Remvoed

Nothing ig :)

Need help?

Our official Discord server is the right place to ask for help to the developers and the community!

This release was made possible thanks to

• @naxefir for some testings - you are the best and I wish you the best 😸
• @pizzacat100 for their sponsorship with us
• @shibusek for their contribution as "Big Supporters"
• @.piwnica2137 for being our first UCR Reliability Analyst and for countless testings!

Check our OpenCollective

https://opencollective.com/ucs
A contribution is always welcomed!

UCR v3.5.0 for EXILED 8.11.0

UncomplicatedCustomRoles v3.5.0 for EXILED 8.11.0

The great version that serves to fix the bugs of the other great version is here!

Read more about this release in the official post:

https://opencollective.com/ucs/updates/ucr-update-preview-version-v3-5-0

Update specifics

Configs: 🔴 BREAKING CHANGES
API: 🟠 CHANGES

Caution

This version brings LOTS OF CHANGES from the previous one and every current custom role is not compatible with the v3.5.0
As I love y'all I've created another online web page where you'll be able to convert role from v3.0.0 to v3.5.0 without big issues!
Suggest you to check the page if you don't want to get crazy: https://ucs.fcosma.it/cgi/converter/300-350

What's new?

• Added the SpawnPoint feature
• New loading and saving system for CustomRoles
• Updated the role_after_escape param
• Added the CreditTags feature
• Added the custom_inventory_limits param
• Added the chance to hide the role's badge by adding @hidden at the end of the name
• Added placeholders for nicknames %unitname% and %unitid%

Bug fix

• Fixed the is_friend_of and uptated it's logic
• Fixed the error bug in OnRoundStarted and OnSpawning method
• Fixed the max_players bug
• Fixed the infinite effect system
• Fixed the infinite effect assign system
• Fixed the inventory and custom_items_inventory skill issue that prevent them from being applied
• Fixed the ucrlogs bug that causes the server to freeze: now the operation is async
• Fixed the bug on OnVerified (for CreditTags)
• Fixed the %nick% bug
• Fixed the bug that override a local tag with an UCS global one
• Fixed bug that did not allow a player to be a customrole more than once per round
• Addressed the custom_info format bug -> NW fault :(
• Fixed the role_appearance bug (as far as I could)
• Fixed the spawn from the revival of SCP-049
• Fixed the fact that ammo were falling out at the CustomRole spawn

Removed

Nothing :D

Need help?

Ask the community on our official Discord server!

Watch out our OpenCollective for news and maybe for a donation!

https://opencollective.com/ucs

This release was made possible thanks to

• @naxefir for countless testing
• @pizzacat100 for their sponsorship with us
• @shibusek and @.piwnica2137 for their contribution as "Big Supporters"

UCR v3.0.0 for EXILED 8.9.6

UncomplicatedCustomRoles v3.0.0 for EXILED 8.9.6

I've worked for 2 full days in order to get that version completed!
We've fixed and added lots of things!

Update specifics

Configs: 🔴 BREAKING CHANGES
API 🟢 Nothing changed

Caution

This version brings LOTS OF CHANGES from the previous one and every current custom role is not compatible with the v3.0.0
As I love y'all I've created a online web page where you'll be able to convert role from v2.2.0 to v3.0.0 without big issues!
Suggest you to check the page if you don't want to get crazy: https://ucs.fcosma.it/cgi/converter/220-300

What's new?

• Added a new health management system, now the healt stats are in a different param (health:)
• Added a new AHP management system, now the ahp stats are in a different param (ahp:) and they are even more customizable!
• Added a new stamina management system, now you can manage also the regeneration and consume multiplier!
• Now every param related to the spawn settings is inside a different param (spawn_settings)
• Added the support with ScriptedEvents, now you can use the functions SET_UCR_ROLE< <PLAYER ID> <ROLE ID> and REMOVE_UCR_ROLE <PLAYER ID>
• Added (again yee) the nickname feature, now roles can have one (or more) nicknames, no needs for the extension and we also have placeholders!
• Added a param that allow you to choose how many candies can this role take before losing the hands (max_scp_330_candies)
• Added the is_friend_of param that allow you to choose which teams can't damage (and can't be damaged too) by the custom role!
• Updated the spawn system, now it's more fast to choose the right custom role
• Updated the role_after_escape, now you can also handle different scenarios (like escaping while being cuffed by NTFs!)
• Added the "Admin Message" or "Mailbox" function: our central servers will be able to broadcast (every 8.3min) a message (will be shown only important messages and you can disable this function in the mailbox)

Bug fix

• Fixed "SCPs can't escape" B1
• Fixed "The jumping ability of the SCP-939 custom role is broken." B2
• Fixed "Escape" B3
• Fixed "Role keeps names" [B4])(https://discord.com/channels/1170301876990914631/1250738553462194266)
• Fixed "After escaping, the person's effects, size and name of the past role that was before the escape are retained.", "Arrival of MTF and Chaos Insurgency gives roles to players incorrectly", " If you do not restart the server after a round, then plugin will spawn people with an error, and the roles given to them will not be what they should be", "Changing the class through Force Role does not work correctly, a person will only display his "role", but in fact he will be a standard role, even with the option enabled in the plugin config" BS1
• Fixed role_appearance

Removed

Nothing :D

Needs help?

Join our Discord server!

Watch out our OpenCollective!

https://opencollective.com/ucs