RoleShuffle

English

Overview

RoleShuffle assigns every player a random role when a stage begins and clears all assigned roles and stage-only temporary upgrade levels when the stage ends. Each role specializes in a distinct gameplay theme built from vanilla upgrades or effects. Health upgrades are the exception: Tank keeps its configured Health level and every other role keeps Health +1 between stages until the next role assignment.

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

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; HUD layout settings are local to each installed player.
• Single-player uses the same role system, but Jobless is 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 Your role: 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.
• Jobless is not selected in single-player or a one-player session.
• Roles, temporary upgrades, hazards, healing effects, revival state, and the role HUD are cleared only when the stage actually transitions.

Roles

Role	Default upgrade or effect	Important limitation or risk	Configurable values
Tank	Health +21	No additional special effect.	Health levels 0–100
Runner	Health +1, Speed +6, Stamina +46	No additional special effect.	Speed and Stamina levels 0–100; Health is fixed at 1
Jumper	Health +1, Extra Jump +10	No additional special effect.	Extra Jump levels 0–100; Health is fixed at 1
Lifter	Health +1, Strength +25	No additional special effect.	Strength levels 0–100; Health is fixed at 1
Launcher	Health +1, Launch +10	No additional special effect.	Launch levels 0–100; Health is fixed at 1
Climber	Health +1, Tumble Climb +50, Range +20	No additional special effect.	Tumble Climb and Range levels 0–100; Health is fixed at 1
Flyer	Health +1, Tumble Wings +10	No additional special effect.	Tumble Wings levels 0–100; Health is fixed at 1
Tracker	Health +1, Map Player Count +1	Both levels are fixed and have no level setting.	Selection only
Ghost	Health +1, Death Head Battery +50	No additional special effect.	Death Head Battery levels 0–100; Health is fixed at 1
Bomber	Health +1; places an armed explosive, stun, or shockwave grenade at random after every 8 m traveled.	Grenades can injure players and damage valuables. At most 30 are tracked per player; truck placement is off by default.	Distance, limit, truck placement, grenade types; Health is fixed at 1
Medic	Health +1; 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.	Amount, interval, radius, total limit; Health is fixed at 1
Phoenix	Health +1; revives itself with 25 HP 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 delay, failure grace; revival HP is fixed at 25; Health is fixed at 1
Jobless	Health +1; 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; Health is fixed at 1
Rescuer	Health +1; revives the nearest dead teammate within 3 m after 2 seconds with 25 HP.	Up to 2 revivals per stage; the Rescuer must be alive and the target must have a Death Head.	Delay, radius, maximum revivals; revival HP is fixed at 25; Health is fixed at 1
Vampire	Health +1; 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; Health is fixed at 1
King	Health +1; 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; Health is fixed at 1
Tuna	Health +1; 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; Health is fixed at 1
Musician	Health +1; 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; Health is fixed at 1
Mage	Health +1; automatically casts forward every 5 seconds: a Star Wand projectile normally, or a Wizard Staff beam with a 10% chance. Beams begin 3 m in front of the player.	Both attacks are real vanilla hazards and can injure players or damage valuables.	Interval, beam chance; Health is fixed at 1

Configuration

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

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 chat and TTS announcements.	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

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

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
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
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
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	Seconds between automatic forward casts.	Host
Mage.BeamChancePercent	10	0–100	Chance that a cast uses the vanilla Wizard Staff beam instead of a Star Wand projectile.	Host

Every role except Tank receives Health +1 as a fixed bonus with no setting. Health upgrades are not reset at stage end: Tank keeps its configured level and other roles keep Health +1 until the next role assignment. RoleShuffle then applies only the difference required by the new role, without first resetting Health to 0. Health is not continuously monitored. Tracker always grants Map Player Count +1 and therefore has no upgrade-level setting. 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.
• 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 Classic-style ROLES HUD containing every synchronized player assignment. It appears at the bottom left by default.
• No role descriptions are displayed in-game.

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.
• RoleShuffle clears its stage state only when the game's level transition actually runs.
• 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. Star 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. Both roles restore revived players at exactly 25 HP.
• Non-Health role upgrades are reset at stage end. The current role's Health upgrade remains until the next role assignment and is changed by the required level difference without resetting it to 0 first.
• Setting every role to disabled or weight 0 leaves no eligible random role to assign.

日本語

概要

RoleShuffleは、ステージ開始時に各プレイヤーへランダムな役職を1つ割り当て、ステージ終了時に役職とステージ限定の一時アップグレードレベルを解除します。各役職はバニラのアップグレードや効果を使った固有のゲームプレイテーマに特化しています。Healthアップグレードだけは例外で、Tankは設定されたHealthレベル、その他の役職はHealth +1を、次の役職抽選までステージ外でも維持します。

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

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

必須MOD

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

導入方法

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

マルチプレイ

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

役職確認コマンド

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

役職の抽選

• プレイ可能なステージの開始時、各プレイヤーへ役職を1つ割り当てます。
• 有効な役職を相対的なWeightに基づいて抽選します。
• General.UniqueRoles = trueの場合、抽選可能な役職を一巡するまで重複を避けます。
• Kingは1ステージにつき最大1人です。
• Joblessはシングルプレイまたは1人のセッションでは抽選されません。
• 役職、一時アップグレード、ハザード、回復効果、復活状態、役職HUDは、ステージが実際に遷移したときだけ解除されます。

役職一覧

役職	デフォルトのアップグレードまたは効果	主な制限・危険性	調整可能な値
Tank	Health +21	追加の特殊効果はありません。	レベル0～100
Runner	Health +1、Speed +6、Stamina +46	追加の特殊効果はありません。	SpeedとStaminaは0～100、Healthは1固定
Jumper	Health +1、Extra Jump +10	追加の特殊効果はありません。	Extra Jumpは0～100、Healthは1固定
Lifter	Health +1、Strength +25	追加の特殊効果はありません。	Strengthは0～100、Healthは1固定
Launcher	Health +1、Launch +10	追加の特殊効果はありません。	Launchは0～100、Healthは1固定
Climber	Health +1、Tumble Climb +50、Range +20	追加の特殊効果はありません。	Tumble ClimbとRangeは0～100、Healthは1固定
Flyer	Health +1、Tumble Wings +10	追加の特殊効果はありません。	Tumble Wingsは0～100、Healthは1固定
Tracker	Health +1、Map Player Count +1	両レベル固定のため、レベル設定はありません。	抽選設定のみ
Ghost	Health +1、Death Head Battery +50	追加の特殊効果はありません。	Death Head Batteryは0～100、Healthは1固定
Bomber	Health +1。8 m移動するごとに、Explosive、Stun、Shockwaveのいずれかの起動済みグレネードをランダム設置します。	プレイヤーや貴重品に被害を与える可能性があります。1人につき最大30個を追跡し、トラック内設置はデフォルト無効です。	距離、上限、トラック内設置、グレネード種類。Healthは1固定
Medic	Health +1。5 m以内の仲間を2秒ごとに5 HP回復し、1ステージにつき合計200 HPまで回復します。	Medic自身は回復しません。範囲内で生存している仲間だけが対象です。そのMedicの上限を使い切ると回復を停止します。	回復量、間隔、範囲、合計上限。Healthは1固定
Phoenix	Health +1。死亡から最低2秒後、25 HPで1ステージに1回だけ自己復活します。	1ステージにつき1回です。復活準備中は、失敗時のステージ遷移を最大5秒保留します。	復活遅延、失敗時猶予。復活後HPは25固定。Healthは1固定
Jobless	Health +1。トラック外にいる間、0.1秒ごとに1ダメージを受けます。	死亡する可能性があります。参加者が1人だけの場合はランダム抽選されません。	ダメージ、間隔。Healthは1固定
Rescuer	Health +1。3 m以内で最も近い死亡中の仲間を、死亡から2秒後に25 HPで復活させます。	1ステージにつき最大2回です。Rescuerが生存し、対象のDeath Headが存在する必要があります。	遅延、範囲、最大復活回数。復活後HPは25固定。Healthは1固定
Vampire	Health +1。10 m以内で敵が死亡すると、Tier 1は5、Tier 2は10、Tier 3は50回復します。	敵のバニラDanger Levelを使用します。Vampireが生存し、死亡した敵の近くにいる必要があります。	Tier別回復量、範囲。Healthは1固定
King	Health +1。ステージ中、バニラのCrownを受け取ります。	Kingは最大1人です。役職終了時に以前のCrown所有者へ戻します。	抽選設定のみ。Healthは1固定
Tuna	Health +1。ステージ開始時の5秒間の猶予後、3秒間停止すると、移動するまで0.1秒ごとに1ダメージを受けます。	死亡する可能性があります。停止時間の計測は最初の猶予後に始まります。動くと即座にリセットし、失った体力は回復しません。	停止時間、ダメージ、間隔。Healthは1固定
Musician	Health +1。Musicianが楽器で音を鳴らすたびに、本人を含む10 m以内の生存プレイヤーを5 HP回復します。	Musician本人がバニラの楽器系貴重品を演奏する必要があります。	回復量、範囲。Healthは1固定
Mage	Health +1。5秒ごとに前方向へ自動発射します。通常はStar Wandの星弾、10%の確率でWizard Staffのビームになります。ビームはプレイヤーの前方3 mから発射します。	どちらも実体のあるバニラ攻撃で、プレイヤーや貴重品へ被害を与える可能性があります。	間隔、ビーム確率。Healthは1固定

設定

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

一般、通知、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の表示倍率です。	ローカル

役職の抽選設定

全役職に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	ホスト

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

キー	デフォルト	範囲・値	内容	管理
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を含めます。	ホスト
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	復活準備中に、失敗時のステージ遷移を保留する最大秒数です。	ホスト
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ステージで復活できる最大回数です。	ホスト
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.BeamChancePercent	10	0～100	Star Wandの星弾ではなく、バニラのWizard Staffビームを発射する確率です。	ホスト

Tank以外の全役職には、設定項目のない固定ボーナスとしてHealth +1を付与します。Healthアップグレードはステージ終了時にリセットせず、Tankは設定値、その他の役職はHealth +1を次の役職抽選まで維持します。次の役職決定時はHealthを一度0へ戻さず、新しい役職に必要なレベルとの差分だけ変更します。常時監視は行いません。TrackerはMap Player Count +1固定のため、アップグレードレベル設定はありません。Kingには効果強度の設定がありません。

通知とHUD

• ステージ開始時、各プレイヤーは割り当てられた英語の役職名をバニラのチャット／TTSで発言します。
• RoleShuffleが生成する通知TTSでは敵が反応しません。通常のマイク入力やその他のワールド音はバニラの動作を維持します。
• Stage Flux導入時は、ステージ開始通知が重ならないようStage Flux用の通知遅延を使用します。
• Stage FluxのTTS終了後、1.5秒間の無音を確認してから役職を通知します。
• MOD導入済みの参加者には、同期された全プレイヤーの役職を表示するClassic形式のROLES HUDが表示されます。デフォルト位置は左下です。
• ゲーム内に役職説明は表示しません。

互換性

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

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

ゲームプレイ上の注意

• Bomberは起動済みのバニラハザードを生成します。爆発や物理効果によってプレイヤーや貴重品へ被害が出る可能性があります。
• Mageは実体のあるバニラ攻撃を発射します。星弾とビームはプレイヤーや貴重品へ被害を与える可能性があります。
• JoblessとTunaは条件を満たしている間、実際に継続ダメージを与え、死亡する可能性があります。受けたダメージは自動回復しません。
• Medicは自身を回復しません。
• Phoenixは1ステージに1回だけ自己復活します。Rescuerは設定された回数まで周囲の別プレイヤーを復活させます。どちらも復活したプレイヤーのHPを25に設定します。
• Health以外の役職アップグレードはステージ終了時にリセットします。Healthアップグレードは次の役職抽選まで維持し、一度0へ戻さず必要なレベル差分だけ変更します。
• すべての役職を無効化するか、すべてのWeightを0にすると、ランダム抽選できる役職がなくなります。