A custom role module, Director (base role: Scientist), that has a chance to replace an existing Scientist player at round start with its own loadout, name tag, and spawn point.
⚠️ Requires theCustomRolesModuleSystemcore plugin. This module registers itself againstCoreModule<TConfig, TTranslation>/CustomRoleModuleSystemclasses from theCustomRolesModuleSystemcore framework, which is not included in this archive. It will not compile or load standalone — seeCRMS README.mdfor details. Priority4(lowest load priority among the six modules) determines its order relative to the others when the core loads them.
- On module enable, registers a
Directorcustom role (CustomRoleModuleSystem) with the core framework and unregisters it on disable. - Each round start, rolls a configured spawn chance (gated behind a minimum player count) to select one existing player of the base role (Scientist) and convert them into the Director.
- Overrides the player's nickname display (hides role tag, shows nickname + custom info) and sets a custom console message visible via the player's console (
~). - Grants a custom loadout (weapon, ammo, armor, keycard, radio) that replaces the player's inventory on conversion. Does not keep the player's prior position or inventory on spawn (
KeepPositionOnSpawn/KeepInventoryOnSpawnbothfalse). - Spawns via a
SpawnProperties/DynamicSpawnPointentry at a configurable location and chance, drawn from a configurable source team. - Defines a
TeammatesToThisRolelist so other roles/teammate custom roles are recognized as friendly for name/info display purposes.
IsEnabled(bool, defaulttrue) — enables/disables the module.Debug(bool, defaultfalse) — debug logging toggle.HintDuration(uint, default5) — seconds the spawn hint is displayed.CustomRoleId(uint, default59) — the custom role's internal ID.MaxHealth(int, default100) — max HP of the Director.Role(RoleTypeId, defaultScientist) — base role this custom role replaces.Scale(Vector3, default(1, 1, 1)) — player model scale.SpawnChance(float, default100) — percentage chance the role spawns each round.SpawnFromTeam(Team, defaultScientists) — team from which the replaced player is selected.SpawnProperties(SpawnProperties) — dynamic spawn points atInsideGateA(50%),InsideGateB(50%), andInsideIntercom(50%), limited to 1 spawn, plus a role spawn point override targetingFacilityGuard(100%).SpawnLocation(RoomType, defaultEzGateB) — additional configured spawn room.MinPlayersForSpawn(uint, default4) — minimum connected players required for the role to be eligible to spawn.Ammo(Dictionary<AmmoType, ushort>, default{ Ammo44Cal: 18 }) — ammo granted on spawn.Inventory(List<string>, default["KeycardFacilityManager", "Radio", "GunRevolver"]) — starting inventory item names.ShowCustomInfoToEveryone(bool, defaulttrue) — iffalse, only teammates see the role's custom info.TeammatesToThisRole(Teammates) — default teammate roles:Scientist,FacilityGuard,NtfCaptain,NtfPrivate,NtfSergeant,NtfSpecialist; default teammate custom roles:"UTR","Doctor","Guard Supervisor".
custom_role_director:
is_enabled: true
debug: false
hint_duration: 5
custom_role_id: 59
max_health: 100
role: SCIENTIST
scale:
x: 1.0
y: 1.0
z: 1.0
spawn_chance: 100.0
spawn_from_team: SCIENTISTS
spawn_properties:
limit: 1
dynamic_spawn_points:
- chance: 50
location: INSIDE_GATE_A
- chance: 50
location: INSIDE_GATE_B
- chance: 50
location: INSIDE_INTERCOM
role_spawn_points:
- chance: 100
role: FACILITY_GUARD
spawn_location: EZ_GATE_B
min_players_for_spawn: 4
ammo:
Ammo44Cal: 18
inventory:
- KeycardFacilityManager
- Radio
- GunRevolver
show_custom_info_to_everyone: true
teammates_to_this_role:
teammates_role:
- SCIENTIST
- FACILITY_GUARD
- NTF_CAPTAIN
- NTF_PRIVATE
- NTF_SERGEANT
- NTF_SPECIALIST
teammates_custom_roles:
- UTR
- Doctor
- Guard Supervisor# Translation
custom_name: Director
custom_info: <color=#FAFF86>Directeur</color>
name_translation: <color=#FAFF86>Directeur</color>
description: You are <color=#FAFF86>Directeur</color>, check console for more info (~)
console_msg: <size=60%>You are <color=#FAFF86>Directeur</color></size>None
- Drop
CustomRoleDirector.dll, together with theCustomRolesModuleSystemcore plugin DLL, into%appdata%/EXILED/Plugins(Windows) or~/.config/EXILED/Plugins(Linux). This module will not load without the core plugin present.