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

UCR v2.2.0 for EXILED 8.9.4

UncomplicatedCustomRoles v2.2.0 for EXILED 8.9.4

As EXILED 8.9.4 just came out here is a relase for the version with some improvements.

Update specifics

Type: 🟢 No config changes
API 🟢 Nothing changed

What's new

Added the Share the Logs feature

Status: BETA
Type: 🔵 No action required

From now on reporting a bug will be 100 times more easy!
With the Share the Log feature with a simple command you'll be able to send us automatically every information that we needs to address the reported bug!
These data will be shared only with our development team, they will be private and they will be used only to address the error:

• Exiled version
• UCR version
• Server IP
• Server port
• Every log message sent in the console only by UCS even if the debug mode is turn off
• Every Custom Role created by you and loaded by the plugin
  In order to report a bug you'll simply have to execute the command ucrlogs ONLY IN THE SERVER CONSOLE and in the bug report send the ID provided by the reponse of the command!

Added the reload command

Status: ALPHA
Type: 🔵 No action required

You'll be finally able to reload the registered roles by using ucr reload in the RA.
With this command new role created after the plugin load and edits of already registered roles will be loaded inside the plugin without the need of restarting the server!
⚠You won't be able to remove roles with the reload command: if you do this nothing will change and the role will still be registered until the server will be restarted!

Bug fixes

Nothing :)

Removed

Nothing :)

---

Discord server: https://discord.gg/5StRGu8EJV

---

NOTE about Share the Logs

Unless you do the command, UCR logs and custom roles WON'T BE SHARED with the development team!

UCR v2.1.0 for EXILED 8.8.1

UncomplicatedCustomRoles v2.1.0 for EXILED 8.8.1

A new version of UCR is now out with lots of changes for server owners!

Update specifics

Type: 🔴CONFIG BREAKING
API: 🟢 Nothing changed

What's new?

Added the Badge support

Status: BETA
Type: 🟠 Config Breaking.

Now you'll be able to add badges with custom name and custom color to the custom roles!
You'll have to add badge_name and badge_color to every custom role.
If you don't want to use a badge just leave these values empty (badge_name: '')

Added the RespawnTimer support

Status: BETA
Type: 🟡 Main Config changes

We've added the support to the RespawnTimer plugin but as we needed some APIs we've created a modified version: until our pull request won't be accepted in order to have the RespawnTimer compatibility and support you'll need to download our version.
If you don't want to use the RespawnTimer don't worry: the plugin will work also without it as it's a soft-dependency.

Added the KeepCurrentPositionSpawn to the SpawnLocationType enum

Status: FULL
Type: 🔵 No action required

Added the KeepCurrentPositionSpawn for the spawn param of every Custom Role: you can use this if you want the role to spawn in the exact same position of the old role.

Bug fix

• Changed the .NET version to 4.8.0
• Fixed the System.NullReferenceException: Object reference not set to an instance of an object at UncomplicatedCustomRoles.Plugin.OnEnabled()
• Fixed the role_after_escape config param
• Fixed the version checker

Removed

Removed the custom_roles object from the main config

Status: ULTIMATE
Type: 🟡 Main Config changes

From now on you won't be able to create custom roles inside the main EXILED config (<port>-config.yml) but you'll need to create them inside the UncomplicatedCustomRoles folder.

---

Discord server: https://discord.gg/5StRGu8EJV

---

New Contributors

• @Robocnop made their first contribution in #22
• @warquys made their first contribution in #20

Full Changelog: v2.0.0...v2.1.0

UCR v2.0.0 for EXILED 8.8.1

UncomplicatedCustomRoles v2.0.0 for EXILED 8.8.1

Finally a new version of the plugin came out (after only 2 months of work)!

What's new?

• Added the infinite_stamina option to make roles not use stamina while running.
• Changed the command system, now there's a parent command (ucr) with subcommands like list, spawn, etc.
• Now the role inside outisde the default EXILED yaml config works correctly (yeah, even the scale!)
• SCPs escape events are now evaulated by the plugin.
• Added support for UncomplicatedCustomItems.
• Added the sync option for the command ucr spawn.

Bug fix

• Fixed the escaping bug: now you won't became the escaped role 190393243487293492872398792387 times (yee)
• Fixed some skill issues in the APIs.
• Now when you set a different scale in an external role you won't fall into the void!
• The command ucr spawn now works.

Removed

• Removed the CustomFiream feature as now we have UncomplicatedCustomItems.
• Removed the nickname feature as it can be added with other plugins.

Developers changelog (IMPORTANT)

Yeah we made lots of changes also for the developers

Changed the API class name

Before that the main API file was UncomplicatedCustomRoles.API.Manager, now you must use UncomplicatedCustomRoles.API.Features.CustomRole only to manage the ICustomRole instances!
Examples at the end of the message

Removed the Event API

As UncomplicatedCustomRoles.API.Features.CustomRole now exists you can do a fast and easy check if a player have a custom role (and retrive the custom role) using your own registered events!
Examples at the end of the message

Removed the ExternalCustomRole and IExternalCustomRole class and interface

That's true!
Now we are using the built-in EXILED YAML parser so no more skill issues from YamlDotNet!

Changed the interfaces namespace

Before that the namespace was UncomplicatedCustomRoles.Structures for classes like ICustomRole and IUCREffect but now it's UncomplicatedCustomRoles.Interfaces

Removed Custom Roles handling for players from the APIs

But don't worry, now you can easily handle the custom roles for a player with the new built-in extension!
Examples at the end of the message

Now you can also not register a Custom Role

You'll have to register a custom role only if you want it to get evaluated while evaluating spawn roles for players. (So natural spawn).

EXAMPLES

Finally!

Check if a player has a custom role and retrive it

if (player.TryGetCustomRole(out ICustomRole role)) 
{
  Log.Info($"Player {player.Nickname} has a custom role!\nRole: {role.Id}");
}
else
{
  // Nah the player does not have the custom role :(
}

Set a custom role for a player

player.SetCustomRole(ICustomRole role);
player.SetCustomRole(int roleId);

Check if a custom role is registered and try to retrive it

// We'll try the custom role with the Id 25
if (UncomplicatedCustomRoles.API.Features.CustomRole.TryGet(25, out ICustomRole role)) 
{
  // Yeah the role exists!
}
else
{
  // Nop
}

Full Changelog: v1.8.0...v2.0.0
Discord server: https://discord.gg/dpvHzC5mst

UCR v1.8.0 for EXILED 8.8.0

UncomplicatedCustomRoles v1.8.0 for EXILED 8.8.0

Finally here is one of the most important releases for UCR, which brings many changes.

What's new?

• The recall event of SCP-049 is now evaluated as an event that allows spawning of custom roles.
• Now UCR will load every config from the config inside the folder UncomplicatedCustomRoles while if the role is inside another folder (always inside the UCR base folder) the roles inside it will be loaded only if the current port is equal to the folder name.
• Now UCR Effects can be infinite and can be immune to SCP-500.
• Updated the Id fixer, now if you try to register a role with the same Id of another UCR will automatically assign a free one.
• Added the ucrowner command to get the "Server Owner" role on our discord server.
• Added the damage_multiplier param to the custom role config.
• You'll be able to decide the role after escape by the role_after_escape param.
• Now the display_nickname is dynamic, you can decide multiple names by splitting it with , , read more here.
• Now APIs are documented also in-code.
• Updated the APIs.

Bug fix

• Now the blue info log for the HTTP presence is every 50 times.
• Now the external role scale works correctly
• Fixed the keycard issue, now custom roles won't be able to open everything
• Now HP can be over the Max HP

Developer dream

Finally, the plugin includes in its APIs an internal event management system that allows the creation of extensions.
Read more HERE

Automatic changelog: v1.6.9...v1.8.0
Discord server: https://discord.gg/zAVhfXf84U
Donation: https://paypal.me/foxworn

⚠ THIS VERSION CAN HAVE SOME BUG, BE AWARE IF A NEW VERSION WILL BE RELASED!

UCR v1.6.9 for EXILED 8.8.0

UncomplicatedCustomRoles v1.6.9 for EXILED 8.8.0

Alleluja!

What's new

• Now NPCs won't be considered while evaluating spawn.
• Now effects can be infinite and you'll be able to decide if an item like SCP-500 can remove or not the infinite effect
• In the UCR folder will be created another folder for each port that you use, in this way you can put the file in the base folder and will be always loaded or you can put it in a specific port folder so it will be loaded only when the server is running on the specific port

Bug fix

• Fixed the conflict with RPNames
• Now the Custom Info are more clear if you don't choose anything
• Fixed the scale bug in external UCS file
• Fixed the max limit bug, now the number of people that have a custom role is well handled.

Donate a dollar if you found that plugin useful! https://paypal.me/foxworn
Join our discord server for support: https://discord.gg/X5WUG5PCDV
Automatic changelog: v1.6.1...v1.6.9

UCR v1.6.1 for EXILED 8.7.0

UncomplicatedCustomRoles v1.6.1 for EXILED 8.7.0

Yeah guys, the v1.6.1 is finally here!

What's new

• The Spawn behaviour has been changed due to a problem with other plugins [D1]
• The max_players has been fixed, now the Player counter for each custom roles has been implemented in a different way, more precise [D2]
• Cleaned up the custom info for a player, yey [D3]
• Added the integration with the UCS DOMINATION SYSTEM, or UCSDS that track how many EXILED servers uses our plugin - Only the IP, the server port and the core count will be shared (with the plugin version)!
• Removed the movement_boost element in the config! ⚠You should remove it from your YAML configs before updating the plugin or all the config will like explode.
• Effects, broadcasts and hints from the Custom Role configs in the UncomplicatedCustomRoles folder whould now work well.

Note

This is a kinda of a BETA version, has been fully tested but you should expect one or more bug and if you encounter one, report it on our Discord server: https://discord.gg/g6cZFGPgdC

GitHub generated changelog: v1.5.0...main

UCR v1.5.0 for EXILED 8.4.3

Finally the v1.5 is HERE!

What's new?

New features

• Now roles can also be created and configured in separate files, inside the plugin folder
• You will be able to decide to allow only players with a certain permission to spawn as a certain role

Bug fix

• Fixed the MTF and Chaos bug
• Fixed other small bug
• Optimized the code

Also, the new docs is here!

Go and take a look: https://github.com/FoxWorn3365/UncomplicatedCustomRoles/wiki

Oh, almost forgot!

This release is public only thanks to @timmeyxd who've motivated me with moneys mmmm, so you should thank him!