UCR v9.5.1

UncomplicatedCustomRoles v9.5.1

🐛 Bug Fixes

• Fixed TeamPatch crashes, now it's working correctly also optimized it
  • Updated to Harmony 2.4.2, if you're getting error on load, download it from the release.
• Fixed CustomInfo Manager (Sometimes it was empty or didn't update)
• Fixed Spawn Protection preventing effects
• Fixed UnitIds not given
• Fixed MaxScp330Candy value
• Fixed UnitName appearing wrongly in CustomInfo. (New NoUnitName CustomFlag)

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

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 LabApi and EXILED.
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 😄

This release was made possible thanks to

• @pizzacat100 for their sponsorship with us (over and over ❤️)
• @foxworn, the UCR Lead Dev 😄

Contacts

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

UCR v9.5.0

UncomplicatedCustomRoles v9.5.0

✨ New Features

• Added UCT Integration for role_after_escape
  • Use CustomTeam or CT and the team's Id, for example: cuffed by CustomTeam 1: InternalRole ClassD

🐛 Bug Fixes

• Fixed Debug LogManager
• Fixed an ArugmentException in EvaluateRoleBase
• Fixed Last Human Tracker in TeamPatch
• Downgraded to Harmony version 2.2.2
• Updated for LabApi 1.1.7

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

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

This release was made possible thanks to

• @pizzacat100 for their sponsorship with us (over and over ❤️)
• @foxworn, the UCR Lead Dev 😄

Contacts

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

UCR v9.4.0

UncomplicatedCustomRoles v9.4.0

⚠️ Breaking Change

• ItemBan type changed from ItemCategory → ItemType

✨ New Features

• Added ECI (Exiled Custom Items) compatibility
• Added ChangeAppearanceOnKill module
• Added ucr cinfo command
• Added CustomKeycard module (see docs for details)
• Added LabApiExtensions integration
• Updated to the new UCS API
• Improved error handling

🐛 Bug Fixes

• Fixed Null Exceptions in: Remote Admin, Info & Percentages command, ItemBan module
• Fixed Stamina behaviour
• Fixed FullCandyBag and ItemBan modules — both now support lists
• Fixed SCP-914 exploit with ItemBan (banned items can no longer be obtained via SCP-914)
• Fixed Custom Info function
• Fixed Hume Shield behaviour + added Regeneration Speed option
• Fixed KeepInventoryOnEscape module
• Fixed ScriptedEvents integration
• Various TeamPatch fixes
• Fixed reloading external roles

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

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

This release was made possible thanks to

• @pizzacat100 for their sponsorship with us (over and over ❤️)
• @foxworn, the UCR Lead Dev 😄

Contacts

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

UCR v9.3.1

UncomplicatedCustomRoles v9.3.1

In this version we fixed some errors and updated the Documentation to LabApi.

What's Changed

• Fixed spawning at RoundStarts.
• Fixed massive log spamming in the LocalAdmin file.
• Fixed %unitname% placeholder.
• Fixed SLWardrobe.
• Fixed RequiredPermission. (It checks for base game permission and LabApi ones too, you can set string or a string[])
• Fixed Percentages command.
• Fixed Commands permissions.
• Changed a little bit how CustomInfo handled.
• Fixed AmnesiaResistance CustomModule.
• Fixed CustomPermissions CustomModule.

Note

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

---

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 LabApi.
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 ❤️)
• @foxworn, the UCR Lead Dev :D

Contacts

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

UCR v9.3.0

UncomplicatedCustomRoles v9.3.0

Important

⚠️ This is the last update for the EXILED version, from now on only LabApi will be supported. If you want to use the plugin in EXILED, just put UncomplicatedCustomRoles-LabAPI.dll inside the EXILED directory.⚠️

Caution

From now on you can delete Newtonsoft.Json.dll inside your dependencies because the plugin doesn't depend on it.

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

• Changed from Newtonsoft.Json to System.Text.Json (Removed external dependency)
• Refactored CustomScpAnnouncer and SilentAnnouncer
  • Now if multiple SCP killed with CustomScpAnnouncer and with the same reason, it will merge the announcements like in the base game.
• Refactored CustomInfo
  • Now you can set the color of the Nickname and RoleName without needing to set a CustomInfo.
• New CustomModule: CustomInfoOrder
  • You can set the order of the CustomInfo
  • Default: %custominfo%%nickname%%rolename%

Bug fixes

• Fixed GetModules function (ItemBan and PacifismUntilDamage CustomModules fixed)
• Fixed Christmas and Halloween Room names for Spawnpoints
• Fixed ucr version command. It will not display "RECALLED"
• Fixed Human SCPs interaction with doors
• Fixed AmnesiaResistance
• Fixed DropNothingOnDeath

Note

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

---

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 LabApi.
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 ❤️)
• @foxworn, the UCR Lead Dev :D

Contacts

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

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