RoleShuffle

English

Overview

RoleShuffle assigns every player a random role when a stage begins and clears all assigned roles when the stage ends. Each role specializes in a distinct gameplay theme built from vanilla upgrades or effects. Configurable base upgrade levels remain active between stages. When a role specializes in an upgrade, the role's configured level replaces that base level for the stage; every other managed upgrade stays at its base level.

Only the host needs RoleShuffle for gameplay effects. Players without the mod receive their role, upgrades, effects, and vanilla chat/TTS announcement normally. Participants who also install RoleShuffle can use the synchronized role HUD.

By default, upgrade items are removed from the shop pool so stage roles remain the source of temporary upgrades.

Requirements

• BepInExPack 5.4.2305 or a later compatible version
• REPOConfig 1.2.6 or a later compatible version
• MenuLib 2.5.2 or a later compatible version

Installation

Install with a compatible mod manager, or place RoleShuffle.dll in the profile's BepInEx/plugins directory. Only the host needs the mod for gameplay effects.

Multiplayer

• The host assigns roles and controls all gameplay settings.
• Vanilla participants are fully supported and do not need RoleShuffle.
• Installed participants receive the synchronized role HUD and the scrollable Roles page in the Escape menu; HUD layout settings are local to each installed player.
• Single-player uses the same role system, but Tracker, Ghost, Medic, Jobless, and Rescuer are excluded from random assignment when only one player is present.

Role command

• Enter /roles in the in-game chat to check your own assigned role.
• Vanilla participants can use this command when the host has RoleShuffle installed.
• Outside an active stage, the response is YourRole:Unavailable.

How roles are assigned

• One role is selected for each player at the start of a playable stage.
• Enabled roles are selected by relative Weight.
• With General.UniqueRoles = true, duplicate roles are avoided until every eligible role has been used once.
• King is assigned to at most one player per stage.
• Tracker, Ghost, Medic, Jobless, and Rescuer are not selected in single-player or a one-player session.
• During a stage, the host continuously verifies actual Photon participants. A player is removed after ten consecutive missing checks; the original role and its persistent state are restored if the same Steam ID returns. A newly detected player receives a new role, upgrades, announcement, and HUD entry.
• Roles, role-specific upgrade overrides, hazards, healing effects, revival state, and the role HUD are cleared when the stage ends or the active scene changes. A canceled ChangeLevel attempt does not clear them.

Roles

Role	Default upgrade or effect	Important limitation or risk	Configurable values
Tank	Health 21	No additional special effect.	Health target 0–100
Runner	Speed 6 and Stamina 46	No additional special effect.	Speed and Stamina targets 0–100
Jumper	Extra Jump 10	No additional special effect.	Extra Jump target 0–100
Lifter	Strength 25	No additional special effect.	Strength target 0–100
Launcher	Launch 10	No additional special effect.	Launch target 0–100
Climber	Tumble Climb 50 and Range 20	No additional special effect.	Tumble Climb and Range targets 0–100
Flyer	Tumble Wings 10	No additional special effect.	Tumble Wings target 0–100
Tracker	Map Player Count 1	The role target is fixed at 1. Never selected randomly when only one player is present.	Selection only
Ghost	Death Head Battery 50	No additional special effect. Never selected randomly when only one player is present.	Death Head Battery target 0–100
Bomber	Places an armed explosive, stun, shockwave, or duct-taped grenade at random after every 8 m traveled. Any player currently assigned Bomber can keep automatically generated Bomber grenades grabbed.	Grenades can injure players and damage valuables. Duct-taped grenades release additional human grenades. At most 30 parent grenades are tracked per player; truck placement is off by default. On vanilla clients, a rejected non-Bomber grab may appear briefly before the host releases it.	Distance, limit, truck placement, grenade types
Medic	Heals nearby teammates for 5 HP every 2 seconds within 5 m, up to 200 total HP per stage.	Never heals the Medic. Only living teammates within range are affected. Healing stops when that Medic's stage limit is exhausted. Never selected randomly when only one player is present.	Amount, interval, radius, total limit
Phoenix	Revives itself with 25 HP by default once per stage, at least 2 seconds after death.	One use per stage. A failed-stage transition is held for at most 5 seconds while revival initializes. Revival HP cannot exceed the player's maximum HP.	Revival HP, revival delay, failure grace
Jobless	Takes 1 damage every 0.1 seconds while outside the truck.	Can kill the player. Never selected randomly when only one player is present.	Damage, interval
Rescuer	Revives the nearest dead teammate within 3 m with 25 HP by default.	Up to 2 revivals per stage; the Rescuer must be alive and the target must have a Death Head. Revival HP cannot exceed the target's maximum HP. Never selected randomly when only one player is present.	Revival HP, delay, radius, maximum revivals
Vampire	Heals when an enemy dies within 10 m: Tier 1 = 5, Tier 2 = 10, Tier 3 = 50.	Uses the enemy's vanilla Danger Level. The Vampire must be alive and close to the dying enemy.	Amount per tier, radius
King	Receives the vanilla Crown for the stage.	Only one King can be assigned. The previous Crown holder is restored when the role ends.	Selection only
Tuna	After a 5-second grace period at stage start, standing still for 3 seconds causes 1 damage every 0.1 seconds until moving.	Can kill the player. The stationary timer starts after the initial grace period. Moving resets it immediately; lost health is not restored.	Delay, damage, interval
Musician	Each instrument note played by the Musician heals the Musician and living players within 10 m for 5 HP.	Requires a vanilla musical valuable to be played by the Musician.	Amount, radius
Mage	Casts by a case-insensitive chat keyword after trimming surrounding whitespace: star = Star Wand (10 HP), gravity = Zero Gravity Staff (10 HP), roll = Roll Staff (15 HP), void = Void Staff (30 HP), laser = Wizard Staff beam (50 HP). The beam begins 3 m in front of the player.	A cast is rejected when current HP is less than or equal to its cost, so casting cannot kill the Mage. HP is consumed only after a successful cast. All spells are real vanilla hazards and can injure players or damage valuables. Casts share a 5-second cooldown by default.	Cast cooldown, health cost per spell
Gambler	The first eligible valuable directly held while the effect is ready has a 50% chance to double its current value and is otherwise destroyed. A damaged valuable is doubled from its reduced value. The Gambler reacts with Jackpot! when the value doubles and Bust! when the valuable is destroyed. Gambit outcomes are changed for the Gambler: green heals 50 HP, red deals 100 damage, black kills, and white fully heals and adds 5 Health upgrade levels for the current stage only. Yellow keeps its vanilla behavior.	The valuable wager starts ready and is restored whenever the team completes an extraction. A newly restored effect can activate on another eligible valuable that is already being held. GamblerReady is announced only when a spent effect is restored.	Win chance, win multiplier, Gambit green heal, red damage, white temporary Health levels
Hunter	Weapons use 75% of their normal battery consumption. When Hunter deals the last damage to an enemy, there is a 0.01% chance to add enough orbs to reach 10 when the normal drop is lower; otherwise there is a 10% chance to double its normal orb count.	Only weapons currently equipped or held by Hunter receive the battery effect. The jackpot never reduces a normal drop that already exceeds its configured target. Whole-bar costs are accumulated so their average consumption matches the configured percentage.	Battery consumption, both orb chances, jackpot count
Stinker	Records the path every 1 m and creates vanilla uranium-tableware break clouds one at a time. Only the newest pending point waits until Stinker is at least 1 m away.	Uranium clouds can damage other players. Walking back into a cloud can still cause damage. Truck placement is off by default.	Distance, safety distance, truck placement
Engineer	Prevents supported held vanilla effect valuables from running their host-side trap, frame-update, and dedicated activation paths. For supported effect valuables grabbed by an Engineer, the host suppresses the activation-related grab path it receives.	A host-only mod cannot guarantee suppression of logic that runs only on an unmodded participant's client. Camera, Propane Tank, Snowmobile, Flashlight, Clown Doll, and Love Potion are therefore excluded. The Engineer must still be holding other supported valuables. Trap state is cleared while held and for 0.25 seconds after release.	Selection only
Trickster	Type decoy in chat to place one fixed vanilla Scream Doll 2 m ahead. It attracts enemies within 30 m every 2 seconds for 15 seconds.	The Trickster must be alive and outside the truck. The decoy cannot be grabbed, damaged, or delivered. Already engaged enemies may continue their current behavior. Successful placement has a 45-second cooldown.	Active time, cooldown, radius, pulse interval, placement distance
Mechanic	While directly holding damaged valuables, restores a shared 1% of original sale value per second, up to 50 percentage points per stage.	Fully repaired and non-valuable objects are ignored. Multiple held valuables share the same repair rate and stage limit. The sale value is restored; damaged visual appearance may remain.	Repair rate, total stage limit
Electrician	While directly holding inactive rechargeable items, restores a shared 5 battery percentage per second, up to 100 percentage points per stage.	Active, full, and unchargeable items are ignored. Multiple held items share the same charge rate and stage limit.	Charge rate, total stage limit
Warden	Adds 3 seconds to enemy stuns caused by Warden's weapons, grenades, or held damaging objects.	Applies only when the vanilla hit identifies Warden as the attacker and the hit normally stuns the enemy.	Additional stun time
Ninja	Prevents Ninja's footsteps, landings, voice chat, and chat TTS from creating enemy investigation events, including Huntsman's sound investigation. Enemies take twice as long to visually recognize Ninja by default.	Does not prevent detection through proximity or touch. Weapons, valuables, impacts, explosions, hazards, and other independently produced noises retain their vanilla behavior.	Visual recognition multiplier
Executioner	Deals 2x direct attack damage to enemies that were already stunned before the hit.	The hit that initially causes the stun receives no bonus. Physics-only collision damage is unchanged.	Stunned-enemy damage multiplier

Configuration

All settings are available through REPOConfig. Host-controlled settings affect the session. Local settings affect only the installed player's HUD.

When a configuration created before v4.1.2 is detected, RoleShuffle automatically retains compatible values, transfers supported renamed settings, and removes known obsolete entries. Before the first migration, the original file is saved beside the active configuration as REPOJP.RoleShuffle.cfg.pre-v4.1.2.bak.

General, notifications, and HUD

Key	Default	Range / values	Effect	Control
General.Enabled	true	true, false	Enables stage role assignment.	Host
General.UniqueRoles	true	true, false	Avoids duplicates until every enabled eligible role has been assigned once.	Host
General.ShopUpgradeItemCount	0	0–30	Requests this number of upgrade items for each shop. 0 removes upgrade items from the shop pool.	Host
Notifications.Enabled	true	true, false	Enables role-name and role-effect chat and TTS notifications.	Host
Notifications.AnnouncementDelaySeconds	2.5	0–30	Delay before role announcements without Stage Flux.	Host
Notifications.StageFluxAnnouncementDelaySeconds	5	0–30	Minimum delay before role announcements when Stage Flux is installed. RoleShuffle also waits for Stage Flux TTS to finish and for a 1.5-second quiet period.	Host
HUD.Enabled	true	true, false	Shows every synchronized role during a stage.	Local
HUD.Anchor	BottomLeft	TopLeft, TopCenter, TopRight, MiddleLeft, MiddleCenter, MiddleRight, BottomLeft, BottomCenter, BottomRight	Selects the HUD anchor.	Local
HUD.Alignment	Left	Left, Center, Right	Selects the role text alignment.	Local
HUD.OffsetX	0	-3840–3840	Horizontal offset from the anchor in pixels.	Local
HUD.OffsetY	0	-2160–2160	Vertical offset from the anchor in pixels.	Local
HUD.ScalePercent	70	50–200	HUD display scale percentage.	Local
HUD.PlayersPerPage	8	2–20	Maximum players shown at once, including the pinned local player.	Local
HUD.PageIntervalSeconds	5	1–30	Seconds each role page remains visible.	Local
HUD.TransitionDurationSeconds	0.2	0–1	Duration of the fade between role pages.	Local
HUD.PinLocalPlayer	true	true, false	Keeps the local player's role visible on every page.	Local

Base upgrades

These host settings define the upgrade target used whenever a role does not override that upgrade. Base levels remain active outside stages. Throw is excluded and is never changed by RoleShuffle.

Key	Default	Range / values	Effect	Control
Base Upgrades.HealthUpgradeLevels	1	0–100	Base Health level.	Host
Base Upgrades.StaminaUpgradeLevels	0	0–100	Base Stamina level.	Host
Base Upgrades.ExtraJumpUpgradeLevels	0	0–100	Base Extra Jump level.	Host
Base Upgrades.SpeedUpgradeLevels	0	0–100	Base Speed level.	Host
Base Upgrades.StrengthUpgradeLevels	0	0–100	Base Strength level.	Host
Base Upgrades.RangeUpgradeLevels	0	0–100	Base Range level.	Host
Base Upgrades.LaunchUpgradeLevels	0	0–100	Base Launch level.	Host
Base Upgrades.TumbleClimbUpgradeLevels	0	0–100	Base Tumble Climb level.	Host
Base Upgrades.TumbleWingsUpgradeLevels	0	0–100	Base Tumble Wings level.	Host
Base Upgrades.CrouchRestUpgradeLevels	0	0–100	Base Crouch Rest level.	Host
Base Upgrades.MapPlayerCountUpgradeLevels	0	0–1	Base Map Player Count level.	Host
Base Upgrades.DeathHeadBatteryUpgradeLevels	0	0–100	Base Death Head Battery level.	Host

Role selection

Every role has an Enabled switch and a relative Weight. A role with Enabled = false or Weight = 0 is excluded from random assignment.

Role	Enabled key and default	Weight key and default	Allowed values	Control
Tank	Tank.Enabled = true	Tank.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Runner	Runner.Enabled = true	Runner.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Jumper	Jumper.Enabled = true	Jumper.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Lifter	Lifter.Enabled = true	Lifter.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Launcher	Launcher.Enabled = true	Launcher.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Climber	Climber.Enabled = true	Climber.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Flyer	Flyer.Enabled = true	Flyer.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Tracker	Tracker.Enabled = true	Tracker.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Ghost	Ghost.Enabled = true	Ghost.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Bomber	Bomber.Enabled = true	Bomber.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Medic	Medic.Enabled = true	Medic.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Phoenix	Phoenix.Enabled = true	Phoenix.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Jobless	Jobless.Enabled = true	Jobless.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Rescuer	Rescuer.Enabled = true	Rescuer.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Vampire	Vampire.Enabled = true	Vampire.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
King	King.Enabled = true	King.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Tuna	Tuna.Enabled = true	Tuna.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Musician	Musician.Enabled = true	Musician.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Mage	Mage.Enabled = true	Mage.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Gambler	Gambler.Enabled = true	Gambler.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Hunter	Hunter.Enabled = true	Hunter.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Stinker	Stinker.Enabled = true	Stinker.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Engineer	Engineer.Enabled = true	Engineer.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Trickster	Trickster.Enabled = true	Trickster.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Mechanic	Mechanic.Enabled = true	Mechanic.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Electrician	Electrician.Enabled = true	Electrician.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Warden	Warden.Enabled = true	Warden.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Ninja	Ninja.Enabled = true	Ninja.Weight = 100	Enabled: true, false; Weight: 0–1000	Host
Executioner	Executioner.Enabled = true	Executioner.Weight = 100	Enabled: true, false; Weight: 0–1000	Host

Upgrade and special-role settings

Key	Default	Range / values	Effect	Control
Tank.HealthUpgradeLevels	21	0–100	Health levels granted to Tank.	Host
Runner.SpeedUpgradeLevels	6	0–100	Speed levels granted to Runner.	Host
Runner.StaminaUpgradeLevels	46	0–100	Stamina levels granted to Runner.	Host
Jumper.ExtraJumpUpgradeLevels	10	0–100	Extra Jump levels granted to Jumper.	Host
Lifter.StrengthUpgradeLevels	25	0–100	Strength levels granted to Lifter.	Host
Launcher.LaunchUpgradeLevels	10	0–100	Launch levels granted to Launcher.	Host
Climber.ClimbUpgradeLevels	50	0–100	Tumble Climb levels granted to Climber.	Host
Climber.RangeUpgradeLevels	20	0–100	Range levels granted to Climber.	Host
Flyer.WingsUpgradeLevels	10	0–100	Tumble Wings levels granted to Flyer.	Host
Ghost.DeathHeadBatteryUpgradeLevels	50	0–100	Death Head Battery levels granted to Ghost.	Host
Bomber.DistancePerGrenade	8	1–100	Travel distance in meters required for each grenade placement.	Host
Bomber.MaximumActiveGrenades	30	1–30	Maximum tracked grenades per Bomber.	Host
Bomber.AllowTruckSpawns	false	true, false	Allows grenade placement inside the truck.	Host
Bomber.ExplosiveGrenadesEnabled	true	true, false	Includes vanilla explosive grenades in the random selection.	Host
Bomber.StunGrenadesEnabled	true	true, false	Includes vanilla stun grenades in the random selection.	Host
Bomber.ShockwaveGrenadesEnabled	true	true, false	Includes vanilla shockwave grenades in the random selection.	Host
Bomber.DuctTapedGrenadesEnabled	true	true, false	Includes vanilla duct-taped grenades in the random selection.	Host
Medic.HealAmount	5	1–100	Health restored to each nearby teammate per tick.	Host
Medic.HealIntervalSeconds	2	0.1–30	Seconds between Medic healing ticks.	Host
Medic.HealRadius	5	1–30	Maximum healing distance in meters.	Host
Medic.TotalHealingLimit	200	1–10000	Maximum total health restored by each Medic per stage. Only health actually missing from a target consumes the limit.	Host
Phoenix.ReviveDelaySeconds	2	2–10	Seconds before Phoenix revival.	Host
Phoenix.FailureGraceSeconds	5	1–15	Maximum seconds to hold a failed-stage transition while revival initializes.	Host
Phoenix.RevivalHealth	25	1–1000	Health after Phoenix revival, capped at the player's maximum health.	Host
Jobless.Damage	1	1–100	Damage per tick outside the truck.	Host
Jobless.DamageIntervalSeconds	0.1	0.05–10	Seconds between damage ticks outside the truck.	Host
Rescuer.ReviveDelaySeconds	2	0–10	Seconds a target must remain dead before rescue.	Host
Rescuer.Radius	3	1–50	Maximum rescue distance in meters.	Host
Rescuer.MaximumRevives	2	1–10	Maximum revivals for each Rescuer per stage.	Host
Rescuer.RevivalHealth	25	1–1000	Health after a Rescuer revival, capped at the target's maximum health.	Host
Vampire.Tier1HealAmount	5	1–100	Health restored by a nearby Danger Level 1 enemy death.	Host
Vampire.Tier2HealAmount	10	1–100	Health restored by a nearby Danger Level 2 enemy death.	Host
Vampire.Tier3HealAmount	50	1–100	Health restored by a nearby Danger Level 3 enemy death.	Host
Vampire.Radius	10	1–50	Maximum distance in meters from the dying enemy.	Host
Tuna.StationaryDelaySeconds	3	0.1–30	Seconds without movement before damage begins.	Host
Tuna.Damage	1	1–100	Damage per stationary tick.	Host
Tuna.DamageIntervalSeconds	0.1	0.05–10	Seconds between stationary damage ticks.	Host
Musician.HealAmount	5	1–100	Health restored to the Musician and each living player in range per instrument note.	Host
Musician.HealRadius	10	1–50	Maximum healing distance in meters from the Musician.	Host
Mage.CastIntervalSeconds	5	0.1–30	Minimum seconds between chat-triggered casts.	Host
Mage.StarHealthCost	10	0–100	Health consumed after a successful star cast.	Host
Mage.GravityHealthCost	10	0–100	Health consumed after a successful gravity cast.	Host
Mage.RollHealthCost	15	0–100	Health consumed after a successful roll cast.	Host
Mage.VoidHealthCost	30	0–100	Health consumed after a successful void cast.	Host
Mage.LaserHealthCost	50	0–100	Health consumed after a successful laser cast.	Host
Gambler.WinChancePercent	50	0–100	Chance that a wager uses the win multiplier instead of destroying the valuable.	Host
Gambler.WinValueMultiplier	2	0–10	Valuable multiplier applied to a winning wager.	Host
Gambler.GambitGreenHealAmount	50	25–1000	Total HP restored by Gambit's green result for a Gambler.	Host
Gambler.GambitRedDamage	100	50–1000	Total damage dealt by Gambit's red result to a Gambler.	Host
Gambler.GambitWhiteHealthUpgradeLevels	5	0–100	Health upgrade levels added by Gambit's white result for the current stage only.	Host
Hunter.WeaponBatteryConsumptionPercent	75	0–100	Percentage of normal weapon battery consumption used by Hunter.	Host
Hunter.DoubleOrbChancePercent	10	0–100	Chance to double the normal orb count after Hunter defeats an enemy, checked only if the jackpot roll fails.	Host
Hunter.JackpotOrbChancePercent	0.01	0–100	Chance to use the jackpot target after Hunter defeats an enemy. Missing orbs are added, but a normal drop above the target is not reduced.	Host
Hunter.JackpotOrbCount	10	1–30	Target orb count used by Hunter's jackpot result.	Host
Stinker.DistancePerCloud	1	1–100	Travel distance in meters between recorded uranium-cloud trail points.	Host
Stinker.MinimumSafetyDistance	1	1–30	Minimum distance Stinker must be from the newest pending point before its cloud is created. Older queued points are emitted sequentially.	Host
Stinker.AllowTruckSpawns	false	true, false	Allows uranium-cloud trail points to be recorded and created inside the truck.	Host
Trickster.ActiveSeconds	15	1–120	Seconds before the active decoy is removed.	Host
Trickster.CooldownSeconds	45	1–300	Seconds between successful decoy placements.	Host
Trickster.InvestigateRadius	30	1–100	Enemy investigation radius around the decoy in meters.	Host
Trickster.PulseIntervalSeconds	2	0.25–10	Seconds between enemy investigation pulses.	Host
Trickster.PlacementDistance	2	0.5–10	Placement distance in front of Trickster in meters.	Host
Mechanic.RepairPercentPerSecond	1	0–100	Shared original-value percentage repaired per second while Mechanic directly holds damaged valuables.	Host
Mechanic.MaximumRepairPercentPerStage	50	0–100	Maximum cumulative original-value percentage repaired by each Mechanic per stage.	Host
Electrician.ChargePercentPerSecond	5	0–100	Shared battery percentage restored per second while Electrician directly holds inactive rechargeable items.	Host
Electrician.MaximumChargePercentPerStage	100	0–1000	Maximum cumulative battery percentage restored by each Electrician per stage.	Host
Warden.AdditionalStunSeconds	3	0–30	Seconds added to enemy stuns caused by Warden.	Host
Ninja.VisionRecognitionMultiplier	2	1–10	Multiplier applied to the time enemies need to visually recognize Ninja.	Host
Executioner.StunnedDamageMultiplier	2	1–10	Direct attack damage multiplier against enemies already stunned before the hit.	Host

The default base is Health 1 and 0 for every other managed upgrade. A role-specific upgrade is an absolute target, not a bonus added to the base. When that role ends, RoleShuffle restores the configured base target; upgrades not overridden by the role stay at their base targets. Levels are changed only when assignment or session state changes, including role assignment, role changes, returning-player restoration, and stage transitions, without continuous monitoring. Tracker always targets Map Player Count 1 and therefore has no role-level setting. Throw is not managed. King has no effect-strength setting.

Notifications and HUD

• At stage start, each player announces the assigned English role name through vanilla chat and TTS.
• RoleShuffle's forced notification TTS does not attract enemies. Ordinary microphone input and other world sounds keep their vanilla behavior unless suppressed by Ninja.
• When Stage Flux is present, RoleShuffle uses the separate Stage Flux announcement delay to avoid overlapping stage-start messages.
• RoleShuffle waits until Stage Flux TTS has finished and remains quiet for 1.5 seconds before announcing roles.
• Installed participants see a one-column ROLES HUD at the bottom left by default. Their own role stays pinned while up to seven other players rotate every 5 seconds.
• A ROLES button placed at the bottom-right of the Escape menu opens the Roles page. Its left column switches between CURRENT ROLES and ROLE GUIDE; the page always opens on current assignments.
• ROLE GUIDE shows every role description in English. In multiplayer, installed participants see the host's synchronized role settings. Until that snapshot is available, descriptions omit unconfirmed numeric values. Single-player uses the local settings.

Compatibility

Stage Flux is optional and is not required to install RoleShuffle.

• Stage Flux Second Chance is evaluated before RoleShuffle Phoenix.
• If Second Chance stops a failed-stage transition, Phoenix is preserved for later use and RoleShuffle does not clear the active roles.
• If Phoenix stops the transition, RoleShuffle also preserves all active role state.
• In the ChangeLevel compatibility path, RoleShuffle clears its stage state only when the game's original level transition actually runs. An active scene change also performs safety cleanup.
• Internal vanilla effect carriers used by RoleShuffle are marked for Stage Flux compatibility and do not interfere with player movement or grounded checks.

Gameplay notes

• Bomber creates live vanilla hazards. Explosions and physics effects may injure players or damage valuables.
• Mage fires live vanilla attacks selected by case-insensitive chat keywords after trimming surrounding whitespace. Projectiles and beams may injure players or damage valuables.
• Jobless and Tuna continuously deal real damage under their stated conditions and can kill their owner. The damage is not automatically restored.
• Medic never heals itself.
• Phoenix revives itself once per stage. Rescuer revives other nearby players up to the configured limit. Each role uses its own configurable revival HP, with a default of 25.
• Role-specific upgrade overrides return to their configured base levels at stage end. Other managed upgrades stay at their base levels, and Throw is untouched.
• Setting every role to disabled or weight 0 leaves no eligible random role to assign.

日本語

概要

RoleShuffleは、ステージ開始時に各プレイヤーへランダムな役職を1つ割り当て、ステージ終了時に役職を解除します。各役職はバニラのアップグレードや効果を使った固有のゲームプレイテーマに特化しています。設定可能な基礎アップグレードはステージ外でも維持します。役職が特化するアップグレードは、ステージ中だけ基礎値ではなく役職の設定値へ置き換え、それ以外は基礎値を維持します。

ゲームプレイ効果はホストだけの導入で利用できます。MODを導入していない参加者にも、役職、アップグレード、効果、バニラのチャット／TTS通知が適用されます。RoleShuffleを導入している参加者は、同期された役職HUDも利用できます。

デフォルトでは、役職による一時強化を中心にするため、ショップのアップグレードアイテム出現数は0です。

必須MOD

• BepInExPack 5.4.2305以降の互換バージョン
• REPOConfig 1.2.6以降の互換バージョン
• MenuLib 2.5.2以降の互換バージョン

導入方法

対応するMODマネージャーでインストールするか、RoleShuffle.dllをプロファイルのBepInEx/pluginsへ配置してください。ゲームプレイ効果はホストだけの導入で利用できます。

マルチプレイ

• 役職の抽選とゲームプレイ設定はホストが管理します。
• MOD未導入の参加者にも対応しており、RoleShuffleの導入は不要です。
• MOD導入済みの参加者には同期された役職HUDと、Escメニュー内のスクロール可能なRolesページが表示されます。HUD配置設定は各導入者のローカル設定です。
• シングルプレイでも同じ役職システムを使用しますが、参加者が1人だけのときはTracker、Ghost、Medic、Jobless、Rescuerがランダム抽選から除外されます。

役職確認コマンド

• ゲーム内チャットで/rolesを入力すると、自分に割り当てられた役職を確認できます。
• ホストがRoleShuffleを導入していれば、MOD未導入の参加者も使用できます。
• ステージ外ではYourRole:Unavailableと応答します。

役職の抽選

• プレイ可能なステージの開始時、各プレイヤーへ役職を1つ割り当てます。
• 有効な役職を相対的なWeightに基づいて抽選します。
• General.UniqueRoles = trueの場合、抽選可能な役職を一巡するまで重複を避けます。
• Kingは1ステージにつき最大1人です。
• Tracker、Ghost、Medic、Jobless、Rescuerはシングルプレイまたは1人のセッションでは抽選されません。
• ステージ中、ホストはPhoton上の実在参加者を継続的に確認します。10回連続で確認できなかったプレイヤーだけを一覧から外し、同じSteam IDが戻った場合は元の役職と維持対象の状態を復元します。新規に検出したプレイヤーには、新しい役職、アップグレード、通知、HUD表示を適用します。
• 役職、役職用アップグレードの上書き、ハザード、回復効果、復活状態、役職HUDは、ステージ終了時またはアクティブシーン変更時に解除します。中断されたChangeLevelでは解除しません。

役職一覧

役職	デフォルトのアップグレードまたは効果	主な制限・危険性	調整可能な値
Tank	Health 21	追加の特殊効果はありません。	Health目標値0～100
Runner	Speed 6、Stamina 46	追加の特殊効果はありません。	SpeedとStaminaの目標値0～100
Jumper	Extra Jump 10	追加の特殊効果はありません。	Extra Jump目標値0～100
Lifter	Strength 25	追加の特殊効果はありません。	Strength目標値0～100
Launcher	Launch 10	追加の特殊効果はありません。	Launch目標値0～100
Climber	Tumble Climb 50、Range 20	追加の特殊効果はありません。	Tumble ClimbとRangeの目標値0～100
Flyer	Tumble Wings 10	追加の特殊効果はありません。	Tumble Wings目標値0～100
Tracker	Map Player Count 1	役職の目標値は1固定です。参加者が1人だけの場合はランダム抽選されません。	抽選設定のみ
Ghost	Death Head Battery 50	追加の特殊効果はありません。参加者が1人だけの場合はランダム抽選されません。	Death Head Battery目標値0～100
Bomber	8 m移動するごとに、Explosive、Stun、Shockwave、Duct Tapedのいずれかの起動済みグレネードをランダム設置します。現在Bomberであるプレイヤーは、ほかのBomberが自動生成したグレネードも持ち続けられます。	プレイヤーや貴重品に被害を与える可能性があります。Duct Taped Grenadeは追加のHuman Grenadeを放出します。1人につき親グレネードを最大30個追跡し、トラック内設置はデフォルト無効です。バニラ参加者ではBomber以外の拒否された掴みが一瞬だけ表示される場合があります。	距離、上限、トラック内設置、グレネード種類
Medic	5 m以内の仲間を2秒ごとに5 HP回復し、1ステージにつき合計200 HPまで回復します。	Medic自身は回復しません。範囲内で生存している仲間だけが対象です。そのMedicの上限を使い切ると回復を停止します。参加者が1人だけの場合はランダム抽選されません。	回復量、間隔、範囲、合計上限
Phoenix	死亡から最低2秒後、デフォルト25 HPで1ステージに1回だけ自己復活します。	1ステージにつき1回です。復活準備中は、失敗時のステージ遷移を最大5秒保留します。復活後HPはプレイヤーの最大HPを超えません。	復活後HP、復活遅延、失敗時猶予
Jobless	トラック外にいる間、0.1秒ごとに1ダメージを受けます。	死亡する可能性があります。参加者が1人だけの場合はランダム抽選されません。	ダメージ、間隔
Rescuer	3 m以内で最も近い死亡中の仲間を、デフォルト25 HPで復活させます。	1ステージにつき最大2回です。Rescuerが生存し、対象のDeath Headが存在する必要があります。復活後HPは対象の最大HPを超えません。参加者が1人だけの場合はランダム抽選されません。	復活後HP、遅延、範囲、最大復活回数
Vampire	10 m以内で敵が死亡すると、Tier 1は5、Tier 2は10、Tier 3は50回復します。	敵のバニラDanger Levelを使用します。Vampireが生存し、死亡した敵の近くにいる必要があります。	Tier別回復量、範囲
King	ステージ中、バニラのCrownを受け取ります。	Kingは最大1人です。役職終了時に以前のCrown所有者へ戻します。	抽選設定のみ
Tuna	ステージ開始時の5秒間の猶予後、3秒間停止すると、移動するまで0.1秒ごとに1ダメージを受けます。	死亡する可能性があります。停止時間の計測は最初の猶予後に始まります。動くと即座にリセットし、失った体力は回復しません。	停止時間、ダメージ、間隔
Musician	Musicianが楽器で音を鳴らすたびに、本人を含む10 m以内の生存プレイヤーを5 HP回復します。	Musician本人がバニラの楽器系貴重品を演奏する必要があります。	回復量、範囲
Mage	前後の空白と大文字・小文字を無視したチャットキーワードで、star = Star Wand（10 HP）、gravity = Zero Gravity Staff（10 HP）、roll = Roll Staff（15 HP）、void = Void Staff（30 HP）、laser = Wizard Staffのビーム（50 HP）を発射します。ビームはプレイヤーの前方3 mから発射します。	現在HPがコスト以下の場合は発動しないため、魔法のHP消費でMage自身が死亡することはありません。発動に成功した場合のみHPを消費します。すべて実体のあるバニラ攻撃で、プレイヤーや貴重品へ被害を与える可能性があります。デフォルトでは全魔法で5秒のクールダウンを共有します。	発射クールダウン、魔法ごとのHP消費量
Gambler	効果が使用可能なとき、最初に直接保持している対象Valuableは50%の確率で現在価格が2倍になり、それ以外では破壊されます。傷ついている場合は、低下後の金額を基準に2倍にします。価格が2倍になるとJackpot!、破壊するとBust!とGambler本人がリアクションします。Gamblerに対するGambitの結果は、緑が50HP回復、赤が100ダメージ、黒が死亡、白が全回復とそのステージ中のみHealthアップグレード+5に変わります。黄色はバニラの挙動を維持します。	Valuableへの抽選効果はステージ開始時に使用可能で、チームが納品を完了するたびに回復します。回復時に別の対象Valuableをすでに保持している場合は、持ち直さなくても発動することがあります。使用済みの効果が回復した場合のみ、GamblerReadyと通知します。	勝率、勝利倍率、Gambitの緑回復量、赤ダメージ、白の一時Healthレベル
Hunter	武器のバッテリー消費量が通常の75%になります。Hunterが最後にダメージを与えて敵を倒すと、0.01%の確率で通常ドロップが10個未満の場合に不足分を追加し、それ以外では10%の確率で通常個数の2倍になります。	Hunter本人が装備または保持している武器だけが対象です。特賞の設定数を通常ドロップが上回っていても個数は減りません。バー単位の消費は蓄積計算し、平均消費量を設定割合へ合わせます。	バッテリー消費率、両方のオーブ確率、特賞個数
Stinker	通った経路を1 mごとに記録し、バニラのウラン食器破壊時の雲を1つずつ順番に発生させます。安全距離1 mは最新の発生待ち地点だけに適用します。	ウラン雲はほかのプレイヤーへダメージを与えます。自分から雲へ戻るとダメージを受ける可能性があります。デフォルトではトラック内に発生しません。	距離、安全距離、トラック内発生
Engineer	対応しているバニラの効果付きValuableについて、ホスト側の罠、フレーム更新、専用発動関数を抑止します。対応ValuableをEngineerが掴んだ場合、ホストが受信した発動条件となる掴み処理を抑止します。	ホストのみのMODでは、未導入参加者側だけで動く処理の抑止を保証できません。そのため、カメラ、プロパンガス、スノーモービル、懐中電灯、ピエロ人形、ラブポーションは対象外です。その他の対応ValuableはEngineerが保持している間と、離してから0.25秒間、罠状態をリセットします。	抽選設定のみ
Trickster	チャットでdecoyと入力すると、前方2 mに固定したバニラのScream Dollを1体設置します。15秒間、2秒ごとに半径30 mの敵を誘導します。	Tricksterが生存し、トラック外にいる必要があります。デコイは掴む、破壊する、納品することができません。すでに交戦中の敵は現在の行動を続ける場合があります。設置成功後のクールダウンは45秒です。	有効時間、クールダウン、範囲、誘導間隔、設置距離
Mechanic	破損したValuableを直接掴んでいる間、元の売却価格の合計1%を毎秒回復し、1ステージにつき合計50ポイントまで回復します。	修復済みのValuableとValuable以外は対象外です。複数を同時に掴んだ場合、回復速度とステージ上限を共有します。売却価格を回復する効果で、破損した外見は残る場合があります。	回復速度、ステージ合計上限
Electrician	使用していない充電可能なアイテムを直接掴んでいる間、合計5%のバッテリーを毎秒回復し、1ステージにつき合計100ポイントまで回復します。	使用中、満充電、充電不可能なアイテムは対象外です。複数を同時に掴んだ場合、充電速度とステージ上限を共有します。	充電速度、ステージ合計上限
Warden	Wardenの武器、グレネード、保持している攻撃用オブジェクトが敵をスタンさせた場合、スタン時間を3秒延長します。	バニラの攻撃判定がWardenを攻撃者として識別し、元の攻撃にもスタン効果がある場合だけ適用します。	追加スタン時間
Ninja	Ninjaの足音、着地音、VC、チャットTTSによる敵の調査行動を発生させず、Huntsmanの音による調査も防ぎます。敵が視覚でNinjaを認識するまでの時間は既定で2倍です。	近接や接触による発見は防ぎません。武器、Valuable、衝突、爆発、危険物などが独立して発生させる音はバニラ動作を維持します。	視認時間倍率
Executioner	攻撃前からスタンしている敵への直接攻撃ダメージが2倍になります。	最初にスタンさせる攻撃には倍率が適用されません。物理衝突だけで発生するダメージは変更しません。	スタン中ダメージ倍率

設定

すべての設定はREPOConfigから変更できます。ホスト設定はセッション全体へ、ローカル設定はMOD導入者本人のHUDだけに反映されます。

v4.1.2より前に作成された設定を検出すると、互換性のある値を維持し、対応している旧名称を現名称へ移行したうえで、既知の廃止項目を削除します。初回移行前の設定は、同じ場所へREPOJP.RoleShuffle.cfg.pre-v4.1.2.bakとして保存します。

一般、通知、HUD

キー	デフォルト	範囲・値	内容	管理
General.Enabled	true	true, false	ステージごとの役職割り当てを有効にします。	ホスト
General.UniqueRoles	true	true, false	抽選可能な役職を一巡するまで重複を避けます。	ホスト
General.ShopUpgradeItemCount	0	0～30	各ショップへ要求するアップグレードアイテム数です。0でショップの抽選対象から除外します。	ホスト
Notifications.Enabled	true	true, false	役職名と役職効果のチャット／TTS通知を有効にします。	ホスト
Notifications.AnnouncementDelaySeconds	2.5	0～30	Stage Flux未導入時の役職通知までの秒数です。	ホスト
Notifications.StageFluxAnnouncementDelaySeconds	5	0～30	Stage Flux導入時、役職通知までに最低限待つ秒数です。Stage FluxのTTS終了後、さらに1.5秒間の無音を確認します。	ホスト
HUD.Enabled	true	true, false	ステージ中、同期された全役職を表示します。	ローカル
HUD.Anchor	BottomLeft	TopLeft, TopCenter, TopRight, MiddleLeft, MiddleCenter, MiddleRight, BottomLeft, BottomCenter, BottomRight	HUDの基準位置を選択します。	ローカル
HUD.Alignment	Left	Left, Center, Right	役職テキストの揃え方を選択します。	ローカル
HUD.OffsetX	0	-3840～3840	基準位置からの水平オフセットです。単位はピクセルです。	ローカル
HUD.OffsetY	0	-2160～2160	基準位置からの垂直オフセットです。単位はピクセルです。	ローカル
HUD.ScalePercent	70	50～200	HUDの表示倍率です。	ローカル
HUD.PlayersPerPage	8	2～20	自分の固定表示を含め、同時に表示する最大人数です。	ローカル
HUD.PageIntervalSeconds	5	1～30	各役職ページを表示する秒数です。	ローカル
HUD.TransitionDurationSeconds	0.2	0～1	役職ページ切替時のフェード時間です。	ローカル
HUD.PinLocalPlayer	true	true, false	自分の役職をすべてのページへ固定表示します。	ローカル

基礎アップグレード

役職が置き換えない場合に使用するアップグレード目標値です。ホスト設定として動作し、基礎値はステージ外でも維持します。Throwは対象外で、RoleShuffleから変更しません。

キー	デフォルト	範囲・値	内容	管理
Base Upgrades.HealthUpgradeLevels	1	0～100	Healthの基礎値です。	ホスト
Base Upgrades.StaminaUpgradeLevels	0	0～100	Staminaの基礎値です。	ホスト
Base Upgrades.ExtraJumpUpgradeLevels	0	0～100	Extra Jumpの基礎値です。	ホスト
Base Upgrades.SpeedUpgradeLevels	0	0～100	Speedの基礎値です。	ホスト
Base Upgrades.StrengthUpgradeLevels	0	0～100	Strengthの基礎値です。	ホスト
Base Upgrades.RangeUpgradeLevels	0	0～100	Rangeの基礎値です。	ホスト
Base Upgrades.LaunchUpgradeLevels	0	0～100	Launchの基礎値です。	ホスト
Base Upgrades.TumbleClimbUpgradeLevels	0	0～100	Tumble Climbの基礎値です。	ホスト
Base Upgrades.TumbleWingsUpgradeLevels	0	0～100	Tumble Wingsの基礎値です。	ホスト
Base Upgrades.CrouchRestUpgradeLevels	0	0～100	Crouch Restの基礎値です。	ホスト
Base Upgrades.MapPlayerCountUpgradeLevels	0	0～1	Map Player Countの基礎値です。	ホスト
Base Upgrades.DeathHeadBatteryUpgradeLevels	0	0～100	Death Head Batteryの基礎値です。	ホスト

役職の抽選設定

全役職にEnabledと相対的なWeightがあります。Enabled = falseまたはWeight = 0の役職はランダム抽選から除外されます。

役職	Enabledキーとデフォルト	Weightキーとデフォルト	設定可能値	管理
Tank	Tank.Enabled = true	Tank.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Runner	Runner.Enabled = true	Runner.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Jumper	Jumper.Enabled = true	Jumper.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Lifter	Lifter.Enabled = true	Lifter.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Launcher	Launcher.Enabled = true	Launcher.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Climber	Climber.Enabled = true	Climber.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Flyer	Flyer.Enabled = true	Flyer.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Tracker	Tracker.Enabled = true	Tracker.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Ghost	Ghost.Enabled = true	Ghost.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Bomber	Bomber.Enabled = true	Bomber.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Medic	Medic.Enabled = true	Medic.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Phoenix	Phoenix.Enabled = true	Phoenix.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Jobless	Jobless.Enabled = true	Jobless.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Rescuer	Rescuer.Enabled = true	Rescuer.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Vampire	Vampire.Enabled = true	Vampire.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
King	King.Enabled = true	King.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Tuna	Tuna.Enabled = true	Tuna.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Musician	Musician.Enabled = true	Musician.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Mage	Mage.Enabled = true	Mage.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Gambler	Gambler.Enabled = true	Gambler.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Hunter	Hunter.Enabled = true	Hunter.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Stinker	Stinker.Enabled = true	Stinker.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Engineer	Engineer.Enabled = true	Engineer.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Trickster	Trickster.Enabled = true	Trickster.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Mechanic	Mechanic.Enabled = true	Mechanic.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Electrician	Electrician.Enabled = true	Electrician.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Warden	Warden.Enabled = true	Warden.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Ninja	Ninja.Enabled = true	Ninja.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト
Executioner	Executioner.Enabled = true	Executioner.Weight = 100	Enabled: true, false、Weight: 0～1000	ホスト

アップグレード・特殊役職設定

キー	デフォルト	範囲・値	内容	管理
Tank.HealthUpgradeLevels	21	0～100	Tankへ付与するHealthレベルです。	ホスト
Runner.SpeedUpgradeLevels	6	0～100	Runnerへ付与するSpeedレベルです。	ホスト
Runner.StaminaUpgradeLevels	46	0～100	Runnerへ付与するStaminaレベルです。	ホスト
Jumper.ExtraJumpUpgradeLevels	10	0～100	Jumperへ付与するExtra Jumpレベルです。	ホスト
Lifter.StrengthUpgradeLevels	25	0～100	Lifterへ付与するStrengthレベルです。	ホスト
Launcher.LaunchUpgradeLevels	10	0～100	Launcherへ付与するLaunchレベルです。	ホスト
Climber.ClimbUpgradeLevels	50	0～100	Climberへ付与するTumble Climbレベルです。	ホスト
Climber.RangeUpgradeLevels	20	0～100	Climberへ付与するRangeレベルです。	ホスト
Flyer.WingsUpgradeLevels	10	0～100	Flyerへ付与するTumble Wingsレベルです。	ホスト
Ghost.DeathHeadBatteryUpgradeLevels	50	0～100	Ghostへ付与するDeath Head Batteryレベルです。	ホスト
Bomber.DistancePerGrenade	8	1～100	グレネードを1個設置するために必要な移動距離です。単位はメートルです。	ホスト
Bomber.MaximumActiveGrenades	30	1～30	Bomberごとに追跡するグレネードの最大数です。	ホスト
Bomber.AllowTruckSpawns	false	true, false	トラック内でのグレネード設置を許可します。	ホスト
Bomber.ExplosiveGrenadesEnabled	true	true, false	ランダム抽選へバニラのExplosive Grenadeを含めます。	ホスト
Bomber.StunGrenadesEnabled	true	true, false	ランダム抽選へバニラのStun Grenadeを含めます。	ホスト
Bomber.ShockwaveGrenadesEnabled	true	true, false	ランダム抽選へバニラのShockwave Grenadeを含めます。	ホスト
Bomber.DuctTapedGrenadesEnabled	true	true, false	ランダム抽選へバニラのDuct Taped Grenadeを含めます。	ホスト
Medic.HealAmount	5	1～100	1回につき周囲の各プレイヤーを回復する量です。	ホスト
Medic.HealIntervalSeconds	2	0.1～30	Medicの回復間隔です。	ホスト
Medic.HealRadius	5	1～30	回復可能な最大距離です。単位はメートルです。	ホスト
Medic.TotalHealingLimit	200	1～10000	Medic一人が1ステージで回復できる合計HPです。対象が実際に失っているHPだけを消費します。	ホスト
Phoenix.ReviveDelaySeconds	2	2～10	Phoenixが復活するまでの秒数です。	ホスト
Phoenix.FailureGraceSeconds	5	1～15	復活準備中に、失敗時のステージ遷移を保留する最大秒数です。	ホスト
Phoenix.RevivalHealth	25	1～1000	Phoenix復活後のHPです。プレイヤーの最大HPが上限です。	ホスト
Jobless.Damage	1	1～100	トラック外で1回ごとに受けるダメージです。	ホスト
Jobless.DamageIntervalSeconds	0.1	0.05～10	トラック外でダメージを受ける間隔です。	ホスト
Rescuer.ReviveDelaySeconds	2	0～10	復活対象が死亡してから必要な秒数です。	ホスト
Rescuer.Radius	3	1～50	復活可能な最大距離です。単位はメートルです。	ホスト
Rescuer.MaximumRevives	2	1～10	Rescuer1人あたり、1ステージで復活できる最大回数です。	ホスト
Rescuer.RevivalHealth	25	1～1000	Rescuerによる復活後のHPです。対象の最大HPが上限です。	ホスト
Vampire.Tier1HealAmount	5	1～100	周囲でDanger Level 1の敵が死亡した際の回復量です。	ホスト
Vampire.Tier2HealAmount	10	1～100	周囲でDanger Level 2の敵が死亡した際の回復量です。	ホスト
Vampire.Tier3HealAmount	50	1～100	周囲でDanger Level 3の敵が死亡した際の回復量です。	ホスト
Vampire.Radius	10	1～50	死亡した敵からの最大距離です。単位はメートルです。	ホスト
Tuna.StationaryDelaySeconds	3	0.1～30	停止してからダメージが始まるまでの秒数です。	ホスト
Tuna.Damage	1	1～100	停止中に1回ごとに受けるダメージです。	ホスト
Tuna.DamageIntervalSeconds	0.1	0.05～10	停止中にダメージを受ける間隔です。	ホスト
Musician.HealAmount	5	1～100	楽器で音を鳴らすたびに、本人と範囲内の各生存プレイヤーを回復する量です。	ホスト
Musician.HealRadius	10	1～50	Musicianから回復可能な最大距離です。単位はメートルです。	ホスト
Mage.CastIntervalSeconds	5	0.1～30	チャット入力による魔法発射の最短間隔です。	ホスト
Mage.StarHealthCost	10	0～100	starの発動成功後に消費するHPです。	ホスト
Mage.GravityHealthCost	10	0～100	gravityの発動成功後に消費するHPです。	ホスト
Mage.RollHealthCost	15	0～100	rollの発動成功後に消費するHPです。	ホスト
Mage.VoidHealthCost	30	0～100	voidの発動成功後に消費するHPです。	ホスト
Mage.LaserHealthCost	50	0～100	laserの発動成功後に消費するHPです。	ホスト
Gambler.WinChancePercent	50	0～100	Valuableを破壊せず、勝利倍率を適用する確率です。	ホスト
Gambler.WinValueMultiplier	2	0～10	勝利時にValuableへ適用する価格倍率です。	ホスト
Gambler.GambitGreenHealAmount	50	25～1000	Gamblerに対するGambitの緑結果で回復する合計HPです。	ホスト
Gambler.GambitRedDamage	100	50～1000	Gamblerに対するGambitの赤結果で受ける合計ダメージです。	ホスト
Gambler.GambitWhiteHealthUpgradeLevels	5	0～100	Gambitの白結果で、そのステージ中のみ追加するHealthアップグレードレベルです。	ホスト
Hunter.WeaponBatteryConsumptionPercent	75	0～100	Hunterが使用する武器バッテリー消費量の通常時に対する割合です。	ホスト
Hunter.DoubleOrbChancePercent	10	0～100	Hunterが敵を倒した際、特賞に外れた場合に通常のオーブ個数を2倍にする確率です。	ホスト
Hunter.JackpotOrbChancePercent	0.01	0～100	Hunterが敵を倒した際、特賞目標を使用する確率です。不足分は追加しますが、通常ドロップが目標を上回る場合は減らしません。	ホスト
Hunter.JackpotOrbCount	10	1～30	Hunterの特賞で使用する目標オーブ個数です。	ホスト
Stinker.DistancePerCloud	1	1～100	ウラン雲の通過地点を記録する間隔です。	ホスト
Stinker.MinimumSafetyDistance	1	1～30	最新の発生待ち地点にウラン雲を発生させるために必要なStinker本人との最低距離です。古い待機地点は順番に発生します。	ホスト
Stinker.AllowTruckSpawns	false	true, false	トラック内でウラン雲の地点記録と発生を許可します。	ホスト
Trickster.ActiveSeconds	15	1～120	設置したデコイを削除するまでの秒数です。	ホスト
Trickster.CooldownSeconds	45	1～300	デコイの設置成功後、次に設置できるまでの秒数です。	ホスト
Trickster.InvestigateRadius	30	1～100	デコイを中心に敵へ調査を指示する半径です。単位はメートルです。	ホスト
Trickster.PulseIntervalSeconds	2	0.25～10	敵へ調査を指示する間隔です。	ホスト
Trickster.PlacementDistance	2	0.5～10	Tricksterの前方へデコイを設置する距離です。単位はメートルです。	ホスト
Mechanic.RepairPercentPerSecond	1	0～100	Mechanicが破損Valuableを直接保持している間、毎秒修復する元価格に対する合計割合です。	ホスト
Mechanic.MaximumRepairPercentPerStage	50	0～100	Mechanic一人が1ステージで修復できる元価格に対する合計割合です。	ホスト
Electrician.ChargePercentPerSecond	5	0～100	Electricianが使用していない充電可能アイテムを直接保持している間、毎秒回復する合計バッテリー割合です。	ホスト
Electrician.MaximumChargePercentPerStage	100	0～1000	Electrician一人が1ステージで回復できる合計バッテリー割合です。	ホスト
Warden.AdditionalStunSeconds	3	0～30	Wardenが敵へ発生させたスタンに追加する秒数です。	ホスト
Ninja.VisionRecognitionMultiplier	2	1～10	敵が視覚でNinjaを認識するまでの時間へ適用する倍率です。	ホスト
Executioner.StunnedDamageMultiplier	2	1～10	攻撃前からスタンしている敵への直接攻撃ダメージ倍率です。	ホスト

デフォルトの基礎値はHealthが1、その他の管理対象アップグレードが0です。役職用アップグレード値は基礎値への加算ではなく、ステージ中の絶対的な目標値です。役職終了時は設定された基礎値へ戻し、役職が置き換えないアップグレードは基礎値を維持します。変更処理は役職付与、役職変更、復帰参加者の復元、ステージ遷移など、割り当てまたはセッション状態が変化した場合だけ行い、常時監視はしません。TrackerはMap Player Countを常に1へ設定するため、役職用レベル設定はありません。Throwは管理対象外です。Kingには効果強度の設定がありません。

通知とHUD

• ステージ開始時、各プレイヤーは割り当てられた英語の役職名をバニラのチャット／TTSで発言します。
• RoleShuffleが生成する通知TTSでは敵が反応しません。通常のマイク入力やその他のワールド音は、Ninjaで抑止される場合を除いてバニラの動作を維持します。
• Stage Flux導入時は、ステージ開始通知が重ならないようStage Flux用の通知遅延を使用します。
• Stage FluxのTTS終了後、1.5秒間の無音を確認してから役職を通知します。
• MOD導入済みの参加者には、1列のROLES HUDがデフォルトで左下に表示されます。自分の役職を固定し、ほかのプレイヤーを最大7人ずつ5秒ごとに切り替えます。
• Escメニュー右下のROLESボタンからRolesページを開けます。左カラムのCURRENT ROLESとROLE GUIDEで表示を切り替え、ページを開いた直後は必ず現在の割り当てを表示します。
• ROLE GUIDEでは全役職の説明を英語で表示します。マルチプレイでは、MOD導入済み参加者にホストから同期された役職設定値を表示します。設定情報をまだ受信していない間は、未確認の数値を含まない説明を表示します。シングルプレイではローカル設定値を使用します。

互換性

Stage Fluxは任意の対応MODであり、RoleShuffleの必須MODではありません。

• Stage FluxのSecond ChanceをRoleShuffleのPhoenixより先に判定します。
• Second Chanceが失敗時のステージ遷移を中断した場合、Phoenixは消費されず、RoleShuffleも現在の役職を解除しません。
• Phoenixが遷移を中断した場合も、RoleShuffleは現在の役職状態を維持します。
• ChangeLevelの互換処理では、ゲーム本来のレベル遷移が実際に実行された場合だけステージ状態を解除します。アクティブシーン変更時にも安全のため解除処理を行います。
• RoleShuffleが内部利用するバニラ効果用オブジェクトはStage Flux互換として扱われ、プレイヤーの移動や接地判定へ干渉しません。

ゲームプレイ上の注意

• Bomberは起動済みのバニラハザードを生成します。爆発や物理効果によってプレイヤーや貴重品へ被害が出る可能性があります。
• Mageは前後の空白と大文字・小文字を無視したチャットキーワードで選択した、実体のあるバニラ攻撃を発射します。発射体とビームはプレイヤーや貴重品へ被害を与える可能性があります。
• JoblessとTunaは条件を満たしている間、実際に継続ダメージを与え、死亡する可能性があります。受けたダメージは自動回復しません。
• Medicは自身を回復しません。
• Phoenixは1ステージに1回だけ自己復活します。Rescuerは設定された回数まで周囲の別プレイヤーを復活させます。復活後HPは役職ごとに設定でき、デフォルトは25です。
• 役職が置き換えたアップグレードはステージ終了時に基礎値へ戻ります。その他の管理対象アップグレードは基礎値を維持し、Throwには触れません。
• すべての役職を無効化するか、すべてのWeightを0にすると、ランダム抽選できる役職がなくなります。