SimpleCustomRoles (YML) | SCP: Secret Laboratory | Page 1

regal cape Feb 11, 2025, 2:38 PM

#

YML Based custom role creation.

Set damage to any source. (Tesla doesn't damage for example)
Set Stats like health, shield, ahp.
Spawns in specific place, room, or even coordinate.
Can set as revive only for SCP's.
SCP Specific actions to control.
Spawn role in a Wave.
Soon more and fixes.

Examples can be seen in here:
https://github.com/KadavasKingdom/SimpleCustomRoles/tree/main/SimpleCustomRoles.Example

Current Release:
https://github.com/KadavasKingdom/SimpleCustomRoles/releases

("simple" yeah, more like "confusing" am I right?)

low compass Feb 11, 2025, 2:45 PM

#

regal cape YML Based custom role creation. Set damage to any source. (Tesla doesn't damage...

Lemme yoink this code for yml's and use it in my thing trollface

regal cape Feb 11, 2025, 2:46 PM

#

have fun ClassDTrollHD I yoinked the YML parsing code too

low compass Feb 11, 2025, 2:46 PM

#

regal cape have fun <:ClassDTrollHD:994997595879510126> I yoinked the YML parsing code too

XD

#

How to see where you do where

regal cape Feb 11, 2025, 2:50 PM

#

YamlShinenigans.cs

#

that helps with parsing with comments

#

https://github.com/SlejmUr/SCPSL_PluginCollection/blob/34b375c0acc48a10a8b0563ed86439b8427ab462/SimpleCustomRoles/RoleInfo/RolesLoader.cs#L48

low compass Feb 11, 2025, 2:52 PM

#

regal cape https://github.com/SlejmUr/SCPSL_PluginCollection/blob/34b375c0acc48a10a8b0563ed...

What's the object of custom role info?

regal cape Feb 11, 2025, 2:52 PM

#

Its a class

#

https://github.com/SlejmUr/SCPSL_PluginCollection/blob/labapi/SimpleCustomRoles/RoleInfo/CustomRoleInfo.cs

low compass Feb 11, 2025, 2:56 PM

#

regal cape <https://github.com/SlejmUr/SCPSL_PluginCollection/blob/labapi/SimpleCustomRoles...

So you have to get everything from the yml and make it into a class as I see

#

Right?

regal cape Feb 11, 2025, 2:57 PM

#

If you didnt add something to a yml it will create the default value you set in the parameters. (and classes)

low compass Feb 11, 2025, 2:58 PM

#

regal cape If you didnt add something to a yml it will create the default value you set in ...

No way

#

That's cool

regal cape Feb 11, 2025, 2:58 PM

#

So if you for example doesnt want to do any health action or add any items you dont need to add that in yml

low compass Feb 11, 2025, 3:00 PM

#

regal cape So if you for example doesnt want to do any health action or add any items you d...

Oh, but you have to check in code if it doesn't exist right?

regal cape Feb 11, 2025, 3:05 PM

#

when creating a class you can set the parameters what should be the default value, when yml parsing it creaeting a class then filling the parametrs with stuff you inputed

for example you have a class like this:

public class FunnyYML
{
  public string name { get; set; } = "no_name";
  public FunnyYMLOther other { get; set; } = new();
  public FunnyYMLOther other2 { get; set; } = new();
}
public class FunnyYMLOther
{
public int SelectThis { get; set; } = 69;
public ItemTypeId ItemToUse { get; set; } = ItemTypeId.SCP500;
}

and a yml:

name: test
other:
 selectThis: 2

it will result that name, other:SelectThis is set but other2 and other:ItemToUse become default as you set in the last place

#

so if you would have been parse back to yml would look like:

name: test
other:
  selectThis: 2
  itemToUse: SCP500
other2:
  selectThis: 69
  itemToUse: SCP500

regal cape May 25, 2025, 9:44 AM

#

Update on this:
Applied many fixed and stuff.
Current issue being:
Excess item drops

Added custom escaping, can control in config yaml.
Will check if customrole if so then checks if the role has a custom escaping, otherwise doesn't do anything, if not custom role it will try to use the existing escaping config.

regal cape May 30, 2025, 11:20 AM

#

UPDATE!
Since wanted to do much more I started patching the game, also breaking some exiled stuff but I honestly do not care. (There will be no support for EXILED)

New stuff
In waves you can set only appear in once then never again.
In giving effects your can set the "canEnable" to false to disable getting this effect.
Added "keeping the inventory" this means as before the items stay in your stuff, uhh bugs can happen with this. (Getting more medkits, etc, it doesnt check any overflow!)

For Only 049
Can set/change these values:
Sesne Cooldown
Sense Target lost cooldown
Sense Attempt fail cooldown
Sense Effect duration.
Max Resurrection.
Human corpse revive duration
Target killed corpse revive duration
Attack cooldown time
attack distance
attack effect duration (CardiacArrest)

For Only 096
Can set/change these values:
Attack Cooldown (Left and right swing)
Charge duration
Charge Cooldown
Default Rage Activation time
Normal Hume shield generation
Max rage time
minimum enrage time
Time per extra target
calming / enraging shield multiplier

For Only 106
Can set/change these values:
Corroding effect time
Vigor bonus on kill
Sinkhole cooldown bonus on kill
Vigor cost per minute in stalk
min vigor usage for atlas
Stalk vigor regeneration amount
stalk cost stationary
stalk cost moving
minimum vigor to submerge
movement range to gain vigor
movement timer to check to gain again.

For Only 173
Can set/change these values:
Blink Cooldown
Breakneck recharge time
breaknake stare limit
tantrum usage cooldown
Blink distance
Blink distance multiplier when on breakneck

For Only 939
Can set/change these values:
Can create a cloud
Cloud fail cooldown
cloud place cooldown

regal cape Jun 19, 2025, 7:08 AM

#

[0.5.3] (YML) SimpleCustomRoles

#

Removed useless Movement stuff added some more stuff to Groups

agile surge Jul 18, 2025, 1:00 PM

#

regal cape Removed useless Movement stuff added some more stuff to Groups

How can I change the strangulation cooldown from scp 3114, and how do I create a subclass (sub-role) for Class-D? I created one using the template, but it's not working. I have to save it under "Roles", right?

regal cape Jul 18, 2025, 1:02 PM

#

I dont think 3114 works right now

#

if you enable debug log it should say what doesnt work.
you can also set it yourself (scr_set CLASSDNAME)

agile surge Jul 18, 2025, 1:05 PM

#

regal cape if you enable debug log it should say what doesnt work. you can also set it your...

I did it like this:

📎 Template.yml.d

regal cape Jul 18, 2025, 1:07 PM

#

fun fact, you dont need to specify all things.
since its a regular type you dont need to add waves and other things you didnt set.
also you should use

roleToSpawn: ClassD
replaceRole: ClassD

#

it will replace ClassD with itself

#

also you should rename the template to something like
Drug_Boss.yml
every file that has .d or .disable it will not load

agile surge Jul 18, 2025, 1:09 PM

#

okey thank you

agile surge Jul 18, 2025, 1:45 PM

#

regal cape fun fact, you dont need to specify all things. since its a regular type you dont...

Would this work like that? I removed all the unnecessary stuff

📎 Template.yml_1.d

regal cape Jul 18, 2025, 1:51 PM

#

rolename: Drogenboss
display:
  rARoleName: Drogenboss
  areaRoleName: Drogenboss
  colorHex: 'orange'
spawn:
  spawnChance: 4000
  spawnAmount: 3
roleToSpawn: ClassD
replaceRole: ClassD
hint:
  broadcast: "<size=40><color=orange><b>Du bist der Drogenboss!</b></color></size>\n<size=30>Zeig allen, wer hier das Sagen hat.</size>"
  broadcastDuration: 10
inventory:
  items:
    - Adrenaline
    - Medkit
deniable:
  items:
    Medkit:
      canUse: false
      canDrop: true

agile surge Jul 18, 2025, 1:53 PM

#

Thanks

viscid field Jul 21, 2025, 6:03 AM

#

Is there a way for a human role to not do any damage to SCPs and vice versa? I.e Serpent's hand, SCP035

📎 SCP035.yml

regal cape Jul 21, 2025, 6:07 AM

#

Currently no, but now added as a plan for it

viscid field Jul 21, 2025, 6:09 AM

#

Alr thank you

#

Does Trigger096 and Observe173 currently work? Im testing them but it still triggers/observes but i set them to false

regal cape Jul 21, 2025, 6:59 AM

#

Hmm, should work, i gonna check the yml

#

Oh my bad

#

I check the 096 Player not the target player

#

173 should work

muted forum Jul 22, 2025, 12:29 PM

#

how can i force myself into the custom role ingame because forceclass just sets me to the “none” role

#

this might be a little dumb

regal cape Jul 22, 2025, 12:35 PM

#

scr_set NameOfTheRole

#

for example
scr_set ClassD_Spy

#

It has to be a valid role & also might check the yml it is actually valid

muted forum Jul 22, 2025, 12:37 PM

#

oh okie

#

ty

regal cape Jul 22, 2025, 12:38 PM

#

If you encounter something like yml doesnt load property, enable debug, it will tell what yml will load next so you can see what actual role is wrong

muted forum Jul 22, 2025, 1:05 PM

#

regal cape If you encounter something like yml doesnt load property, enable debug, it will ...

can i force set other people as the role? everything works btw ty : )

regal cape Jul 22, 2025, 1:06 PM

#

Yes

muted forum Jul 22, 2025, 1:06 PM

#

what’s the command for it

regal cape Jul 22, 2025, 1:06 PM

#

scr_seto RoleName PlayerId

muted forum Jul 22, 2025, 1:06 PM

#

alr

#

thanks a lot

regal cape Jul 22, 2025, 1:07 PM

#

Dont remember if works with a group of player or just one, so use one

muted forum Jul 22, 2025, 1:07 PM

#

okay

regal cape Aug 12, 2025, 12:33 PM

#

Appearance is broken so I removed (commented out the thing( hopefully when fix comes it will work too.
Working on to make able to use
Any damage.
Also added atracker role so you can hurt twice as much your friend (?)

lofty spoke Aug 21, 2025, 2:35 PM

#

ER

regal cape Aug 21, 2025, 2:44 PM

#

?

low compass Aug 21, 2025, 5:23 PM

#

lofty spoke ER

RE

lofty spoke Aug 21, 2025, 5:23 PM

#

oops I didn't realise I sent that 💀

jagged oar Aug 23, 2025, 6:07 PM

#

Hey, I'm unable to add a scp049-2 custom role with more health:

#

rolename: Armoured_049-2
roleType: ScpSpecific
display:
roleCanDisplay: true
rARoleName: Armoured 049-2
areaRoleName: Armoured 049-2
colorHex: '#ff0000'
spawn:
spawnChance: 0
spawnAmount: 2
roleToSpawn: Scp0492
replaceRole: Scp0492
stats:
health:
value: 600
math: None
maxHealth:
value: 600
math: None
effects:

effect_type: Slowness
duration: -1
intensity: 5
removable: false
hint:
broadcast: "You are <color=#ff0f0f><b>Armoured SCP-049-2</b></color>! It seems that 049 has strengthened you! Go forth!"
broadcastDuration: 15
hintDuration: 16
fpc:
scale:
x: 1.05
y: 1
z: 1.05

#

I also tried your loot goblin subclass but no luck there either

#

I believe it may be due to the roleType as a custom D-class I made seemed to work?

regal cape Aug 23, 2025, 6:15 PM

#

Math: Set

#

and ScpSpecific only spawns if you set Scp0492.CanSpawnIfNoCustom094 true

#

in your own custom role

regal cape Aug 23, 2025, 6:17 PM

#

jagged oar I also tried your loot goblin subclass but no luck there either

those old has old schema didnt updated to latest yet

#

removed those so not be faulty

jagged oar Aug 23, 2025, 6:20 PM

#

regal cape and ScpSpecific only spawns if you set Scp0492.CanSpawnIfNoCustom094 true

Ill give it a go, cheers in advance

jagged oar Aug 23, 2025, 6:21 PM

#

regal cape and ScpSpecific only spawns if you set Scp0492.CanSpawnIfNoCustom094 true

btw to clarify should I just use 'Regular' then?

regal cape Aug 23, 2025, 6:26 PM

#

ye

jagged oar Aug 23, 2025, 6:31 PM

#

No luck

#

regal cape Aug 23, 2025, 6:31 PM

#

[0.5.5] (YML) SimpleCustomRoles

#

Try updating to this:
https://github.com/SlejmUr/SCPSL_PluginCollection/releases/tag/SCR-v0.5.5

GitHub

Release SimpleCustomRole v0.5.5 · SlejmUr/SCPSL_PluginCollection

What's Changed

New 1413 by @SlejmUr in #3

Full Changelog: SCR-V0.5.3...SCR-v0.5.5

#

0Harmony.dll
LabApiExtensions.dll
is a dependency put them there

jagged oar Aug 23, 2025, 6:37 PM

#

Ok Ill try again

#

Still no luck

regal cape Aug 23, 2025, 6:39 PM

#

??

#

check console

#

can you send the yml file here

jagged oar Aug 23, 2025, 6:42 PM

#

📎 Armoured_049-2.yml

regal cape Aug 23, 2025, 6:44 PM

#

how does the 0492 spawn?

#

if you spawn by RA doesnt work

#

roles that does not spawn first in the game does not get replaced
IF you want to spawn as a 0492 role, set Scp.Scp0492.CanSpawnIfNoCustom094 true and set to be SCP Specific, otherwise 0492 role doesnt do anything

jagged oar Aug 23, 2025, 6:49 PM

#

regal cape roles that does not spawn first in the game does not get replaced IF you want to...

Where would I set Scp.Scp0492.CanSpawnIfNoCustom094, the config file?

regal cape Aug 23, 2025, 6:50 PM

#

roleType: ScpSpecific
scp:
  scp0492:
    chanceForSpawn: 10000
    canSpawnIfNoCustom049: true

jagged oar Aug 23, 2025, 7:04 PM

#

Idk what I'm doing wrong its still not working

regal cape Aug 23, 2025, 7:06 PM

#

how does the 0492 spawn?

#

like what you do to see that 0492 role

jagged oar Aug 23, 2025, 7:10 PM

#

I spawn in a dummy, kill it as 049, resurrect it

regal cape Aug 23, 2025, 7:10 PM

#

ah

#

updated the yaml

jagged oar Aug 23, 2025, 7:20 PM

#

still no luck

#

so sorry, this must be infuriating

regal cape Aug 23, 2025, 7:22 PM

#

can you send again?

jagged oar Aug 23, 2025, 7:24 PM

#

📎 Armoured_049-2_2.yml

regal cape Aug 23, 2025, 7:25 PM

#

there is no error in console?

jagged oar Aug 23, 2025, 7:26 PM

#

none

#

even saying other non-scp custom roles have spawned

#

could it be with also having
spawn:
spawnChance: 10000
spawnAmount: 2

#

while also having

#

chanceForSpawn: 10000

regal cape Aug 23, 2025, 7:37 PM

#

nah one is to be in a list other is to get from that list

jagged oar Aug 23, 2025, 8:03 PM

#

Ah right, you know what it could be then?

regal cape Aug 23, 2025, 8:09 PM

#

no idea checking it

jagged oar Aug 23, 2025, 8:13 PM

#

Thx 🙏

regal cape Aug 23, 2025, 8:22 PM

#

in the config did you disabled
use_player_percent: false

#

also try this

📎 Armoured_0492.yml

#

player area seems to be fucked idk why

jagged oar Aug 23, 2025, 9:11 PM

#

That seems to have done the trick

#

tysm!!

jagged oar Aug 23, 2025, 9:33 PM

#

One last question - For spawn chance, do I use the one under "spawn:" or "scp049-2"

regal cape Aug 23, 2025, 9:47 PM

#

One spawns control how many should spawn in that round
Other chance is 049 how much chance can be that role once a random selected

lofty spoke Aug 26, 2025, 7:29 PM

#

Hello, just wanted to ask, does this plugin support subdirectories? Like in the "Roles" folder with all the yml files, can I add a subdirectory like "D-Class Roles" and put my yml files in there and have separate folders?

#

If not, I feel like that would be a good idea as it makes it easier to stay organised with roles

regal cape Aug 26, 2025, 8:16 PM

#

https://github.com/SlejmUr/SCPSL_PluginCollection/actions/runs/17249402751
This should contain that change

lofty spoke Aug 27, 2025, 12:13 AM

#

regal cape <https://github.com/SlejmUr/SCPSL_PluginCollection/actions/runs/17249402751> Thi...

damn updates on demand

#

fire

#

thanks!

lofty spoke Aug 28, 2025, 2:44 PM

#

Hey, how would I go about adding custom keycards to my custom roles?

regal cape Aug 28, 2025, 2:45 PM

#

Create a Plugin adding such keys, you can subscribe to the OnSpawn or something like that event

lofty spoke Aug 29, 2025, 5:02 PM

#

Minor issue with the plugin, roles that have spaces in them cannot be spawned in using the setscr command. For instance, I have a yml file consisting of rolename: "Nine-Tailed Fox Ninja" and I cannot spawn it in with /setscr "Nine-Tailed Fox Ninja" I get the error that Role "Nine-Tailed does not exist Would it be possible to make the setscr command consider whatever has spaces in it as long as it is surrounded by speech marks?

regal cape Aug 29, 2025, 5:05 PM

#

the rolename there is not a display name, use display class/field
IDK how wouly you even do that with the command so

lofty spoke Aug 29, 2025, 5:07 PM

#

regal cape the rolename there is not a display name, use display class/field IDK how wouly ...

It's just that my own plugin uses the rolename for hints 😂

#

I guess it's time for a rework on my own

regal cape Aug 29, 2025, 5:08 PM

#

there is literally a field for it

#

called display

#

display:
# Can the role display
  roleCanDisplay: true
  # Role area name
  areaRoleName: 'Armoured SCP-0492'
  # Role RA name
  rARoleName: 'Armoured SCP-0492'
  # Role Spectator name
  spectatorRoleName: 'Armoured SCP-0492'
  # Role color
  colorHex: '#ffffff'

lofty spoke Aug 29, 2025, 5:11 PM

#

Yeah it's just this is what my own plugin used

#

very easy rework tho

jagged oar Sep 6, 2025, 7:00 PM

#

Hey, again
I'm having trouble with damageDealt, as attached

📎 RoleQuery.txt

#

Am I missing something? I tried to refer to the template but no matter what I change, the plugin just wont work

regal cape Sep 6, 2025, 9:23 PM

#

damage:
  damageDealt:
    ?
      damageType: Universal
      damageSubType: UniversalSubType
      subType: Tesla
    : value: 0
      math: Set

#

Ye should be working wgat u sent

#

Check console log what is throwing as error

jagged oar Sep 7, 2025, 11:04 AM

#

Cheers, now running around 1 tapping scps with a com 18

regal cape Sep 7, 2025, 6:51 PM

#

SimpleCustomRoles (YML)

jagged oar Sep 11, 2025, 7:53 PM

#

Hey, I was trying to enable bypass for SCP049-2:

#

#

Am I using it wrong or is it just not available for scps?

regal cape Sep 11, 2025, 8:36 PM

#

it should work

#

check it on RA I guess

#

it is set with
Owner.IsBypassEnabled = Role.Extra.Bypass;

vocal robin Sep 11, 2025, 10:10 PM

#

here is a fun idea what if you added a thing called command on spawn so you can do stuff with that.

#

also at the moment can we do things with sss?

regal cape Sep 11, 2025, 10:30 PM

#

vocal robin here is a fun idea what if you added a thing called command on spawn so you can ...

There was that previously but i moved to events.
And since the command and parameters can be different between each person and usecase that just make it harder to add it back.
Like
Do you want the id of the player only, the role name too, in what order? Etc etc

regal cape Sep 11, 2025, 10:31 PM

#

vocal robin also at the moment can we do things with sss?

What do you mean by that?
Current it only does is show what your role hint and broadcast are

vocal robin Sep 11, 2025, 10:48 PM

#

regal cape What do you mean by that? Current it only does is show what your role hint and ...

I mean like play a sound, activate a ability ect

regal cape Sep 11, 2025, 10:50 PM

#

Oh, if you want to add ability and anything else you have to code it and do it yourself.
I don't believe there is any good scripting language that does much many things for you

#

I used SE but i didn't seen viable long run

regal cape Sep 19, 2025, 10:22 AM

#

Added new HideFromSpectators
Fixed Apperance
For 173:

Added ability to edit CanTeleport
Added DisableSoundPlay making a list to disable playing these sounds

Updated version can be downloaded here:
https://github.com/KadavasKingdom/SimpleCustomRoles/releases

jagged oar Oct 4, 2025, 11:15 PM

#

@regal cape Is it possible to change the spectators list role names

#

like:

#

regal cape Oct 5, 2025, 8:48 AM

#

Like? This is a pic for basegame and English, if you want to edit do it in translation

lofty spoke Nov 2, 2025, 8:21 PM

#

@regal cape I think the latest release of this plugin is borked? I install the V0.5.10 release and it shows up in my console as V0.5.9 and spits errors, refuses to load. I do have the LabAPIExtensions dependency installed. I can't work on my special ability roles bonkers

#

regal cape Nov 2, 2025, 8:45 PM

#

update labapi extension for this https://github.com/KadavasKingdom/LabApiExtensions/releases

regal cape Nov 7, 2025, 4:39 PM

#

Added hume shield related changing
Added option to able to change when gaining ticket

proud venture Nov 10, 2025, 11:05 AM

#

esla

#

gates

regal cape Nov 10, 2025, 2:15 PM

#

what

hollow crater Nov 19, 2025, 9:39 AM

#

you can set permissions to roles

regal cape Nov 19, 2025, 10:41 AM

#

Wdym

jagged oar Nov 25, 2025, 1:27 PM

#

I assume theres not a way to assign different SCRs to different factions i.e a tutorial SCR being a SCP?

regal cape Nov 25, 2025, 4:26 PM

#

Ye you cant do that rn, would need many patch and maintenance around that

jagged oar Nov 25, 2025, 5:36 PM

#

Yeah thought so - main reason to is for win conditions

jagged oar Nov 26, 2025, 9:37 PM

#

Hey, I've got an issue now I'm using the latest release where I'm getting no error messages, yet the plugin is not working (no commands working or anything)

#

Ive uploaded the labapiextension dependency too and have harmony also

regal cape Nov 26, 2025, 10:26 PM

#

Wdym command doesnt work?

#

did you add scr.* OR scr. Specific permissions to the permissions.yml file?

jagged oar Nov 28, 2025, 3:20 PM

#

regal cape did you add scr.* OR scr. Specific permissions to the permissions.yml file?

Ill check

jagged oar Nov 28, 2025, 3:57 PM

#

Ive set to scr*

#

still no luck

jagged oar Nov 28, 2025, 3:58 PM

#

regal cape did you add scr.* OR scr. Specific permissions to the permissions.yml file?

I did check and the plugin itself is working - roles are spawning

#

just no commands

regal cape Nov 28, 2025, 4:06 PM

#

owner:
  permissions:
  - scr.*

jagged oar Nov 28, 2025, 6:06 PM

#

#

Was anything changed to do with perms between updates

#

Ill be honest - I dont remember what ver i had before

twin pulsar Apr 22, 2026, 12:50 AM

#

where do i need to put done ymls

#

just got a new server and im new too coding so i would appreciate help very much

#

#

i just put it in simple custom roles is that right

#

like right there

regal cape Apr 22, 2026, 7:27 AM

#

LabApi/Configs/<port>/SimpleCustomRole/Roles/

#SimpleCustomRoles (YML)