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.
• By default, Showcase roles (Bomber, Stinker, Mage, Gambler, Trickster, King) and Support roles (Medic, Rescuer, Mechanic, Electrician, Warden) receive configurable minimum guarantees based on party size.
• By default, at most one Danger role (Bomber, Stinker) and one Hardship role (Jobless, Tuna) are assigned. A party of four or fewer receives at most one role across both groups.
• A player normally cannot receive the same role in consecutive stages. After receiving Jobless or Tuna, that player is excluded from both Hardship roles for the next stage. These restrictions are relaxed only when needed to avoid leaving a player without a role.
• 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

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.2.2 is detected, RoleShuffle automatically retains compatible customized values, transfers supported renamed settings, removes known obsolete entries, and updates unchanged legacy defaults. Before migration, the original file is saved beside the active configuration as REPOJP.RoleShuffle.cfg.pre-v4.2.2.bak.

General, notifications, and HUD

Role balance

Showcase roles are Bomber, Stinker, Mage, Gambler, Trickster, and King. Support roles are Medic, Rescuer, Mechanic, Electrician, and Warden. Danger roles are Bomber and Stinker; Hardship roles are Jobless and Tuna. Minimum guarantees are soft requirements and are skipped when no eligible assignment can satisfy them. Risk limits are relaxed only as a final fallback when otherwise no role can be assigned.

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.

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.

Upgrade and special-role settings

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 or Japanese. Use the language toggle inside the guide to switch immediately; English is selected whenever the Roles page is opened. Japanese descriptions use the Checkpoint Revenge font. In multiplayer, installed participants see the host's synchronized role settings in either language. 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人です。
• デフォルトでは、Showcase役（Bomber、Stinker、Mage、Gambler、Trickster、King）とSupport役（Medic、Rescuer、Mechanic、Electrician、Warden）を、参加人数に応じて設定された最低人数まで優先的に割り当てます。
• デフォルトでは、Danger役（Bomber、Stinker）とHardship役（Jobless、Tuna）をそれぞれ最大1人に制限します。4人以下では両グループを合わせて最大1人です。
• 同じプレイヤーへ前ステージと同じ役職を通常は連続で割り当てません。JoblessまたはTunaの次ステージでは、そのプレイヤーを両方から除外します。役職未割り当てを防ぐ必要がある場合だけ制限を緩和します。
• Tracker、Ghost、Medic、Jobless、Rescuerはシングルプレイまたは1人のセッションでは抽選されません。
• ステージ中、ホストはPhoton上の実在参加者を継続的に確認します。10回連続で確認できなかったプレイヤーだけを一覧から外し、同じSteam IDが戻った場合は元の役職と維持対象の状態を復元します。新規に検出したプレイヤーには、新しい役職、アップグレード、通知、HUD表示を適用します。
• 役職、役職用アップグレードの上書き、ハザード、回復効果、復活状態、役職HUDは、ステージ終了時またはアクティブシーン変更時に解除します。中断されたChangeLevelでは解除しません。

役職一覧

設定

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

v4.2.2より前に作成された設定を検出すると、変更済みの互換値を維持し、対応している旧名称を現名称へ移行し、既知の廃止項目を削除したうえで、変更されていない旧デフォルト値を更新します。移行前の設定は、同じ場所へREPOJP.RoleShuffle.cfg.pre-v4.2.2.bakとして保存します。

一般、通知、HUD

役職バランス

Showcase役はBomber、Stinker、Mage、Gambler、Trickster、Kingです。Support役はMedic、Rescuer、Mechanic、Electrician、Wardenです。Danger役はBomber、Stinker、Hardship役はJobless、Tunaです。最低保証は条件を満たす候補がない場合には適用しません。危険役制限は、ほかに割り当て可能な役職がなくなる場合だけ最終手段として緩和します。

基礎アップグレード

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

役職の抽選設定

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

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

デフォルトの基礎値は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では全役職の説明を英語または日本語で表示します。ガイド内の言語トグルですぐに切り替えられ、Rolesページを開いた時点では毎回英語が選択されます。日本語の説明には「チェックポイント★リベンジ」を使用します。マルチプレイでは、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にすると、ランダム抽選できる役職がなくなります。

4.3.4

• Mage spells cast by participants now follow that player's own view direction instead of changes in the Semibot's head direction.
• Trickster now announces when the decoy is ready to use again.
• Mechanic now uses its stage repair allowance only when valuable price is actually restored.

4.3.3

• Added optional host-only compatibility with Elite Enemy Variants. Living Ninjas avoid attacks that specifically seek unseen players, Enhanced enemies can improve Vampire and Hunter rewards, and Gambler effects stay attached to the correct roulette target.
• Improved compatibility with Stage Flux. Mechanic works correctly with value-changing events, revival effects resolve in a consistent order, announcements no longer overlap, Enemy Purge does not activate Hunter rewards, and Dangerous Valuables respects Engineer protection.

4.3.2

• Prevented Influencer and Berserker scaling from lowering upgrades below their pre-role levels, and excluded Influencer from random assignment when none of its reachable configured targets exceed the current Base Upgrades.

4.3.1

• Changed Influencer so it remains a Showcase role but no longer counts toward Danger-role limits.
• Expanded RoleShuffle support and role-balance configuration ranges to sessions of up to 30 players.
• Base Upgrade values can now change with the run level.
• Prevented Tank, Runner, Jumper, Lifter, Launcher, Climber, Flyer, Tracker, and Ghost from being randomly assigned when a matching Base Upgrade target is already higher than the role's configured target.
• Rebalanced role assignment for larger groups with an extra-large Showcase and Support tier, party-size-scaled Danger and Hardship limits, longer personal Hardship cooldowns, and adjusted default role weights.
• Prevented Musician, Engineer, Electrician, and Rider from being randomly assigned when the stage has no vanilla object their ability can use.

4.3.0

• Added Rider. Rider increases vehicle impact damage against enemies and existing vehicle knockback against players.
• Added Influencer. Influencer gains stronger upgrades near more teammates, produces louder player noises, and periodically speaks audible TTS.
• Added Werewolf. Werewolf deals increased damage to other players when identified as the attacker.
• Added Berserker. Berserker gains stronger upgrades as remaining health becomes lower.
• Added Bodyguard. Bodyguard gains additional Health and absorbs part of nearby teammates' enemy damage while retaining at least 1 HP.
• Added configurable per-upgrade scaling for Influencer and Berserker.

4.2.3

• Improved Bomber's automatic grenade placement: Duct Taped Grenades no longer spawn directly under the player, and the oldest generated grenade is replaced when the active limit is reached.
• Increased Stinker's default cloud spacing and minimum safety distance from 1 m to 2 m.
• Fixed Medic healing errors and repeated Stinker warning messages.

4.2.2

• Added configurable role-selection rules that help larger teams receive a mix of event-focused and support roles. Hosts can also limit difficult role combinations, prevent the same role from repeating, and stop Jobless or Tuna from being assigned to the same player again too soon.
• Increased Hunter's default jackpot chance from 0.01% to 0.5%, Mechanic's repair speed from 1% to 2% per second, and Electrician's charge speed from 5% to 10% per second.
• Reduced Jobless's default selection weight from 100 to 20.
• Reduced Medic's default total healing limit from 200 HP to 150 HP per stage.

4.2.1

• Added an English and Japanese language toggle to the in-game Role Guide. English is shown first.

4.2.0

• Added Mechanic. Mechanic repairs damaged valuables while directly holding them, up to a configurable total per stage.
• Added Electrician. Electrician restores rechargeable item batteries while directly holding them, up to a configurable total per stage.
• Added Warden. Warden extends enemy stuns caused by their weapons, grenades, or held damaging objects.
• Added Ninja. Ninja suppresses personal movement, voice, and chat TTS noises and makes enemies take longer to visually recognize them.
• Added Executioner. Executioner deals increased direct attack damage to enemies that were already stunned before the hit.
• Added Trickster. Type decoy in chat to place a temporary fixed Scream Doll that attracts nearby enemies.
• Improved one-player role selection by excluding Tracker, Ghost, Medic, Jobless, and Rescuer from random assignment.
• Enhanced Gambler interactions with Gambit: green heals 50 HP, red deals 100 damage, black kills, and white fully heals and grants 5 Health upgrade levels for the current stage only.

4.1.4

• Fixed role upgrades occasionally overlapping when a stage began.
• Fixed dead players temporarily disappearing from role displays and having their role or purchased upgrades reapplied after revival.
• Fixed Rescuer range detection so it follows the dead player's current death head position.

4.1.3

• Added an English in-game Role Guide to the Roles page. The left column switches between current assignments and role descriptions, and current assignments are shown first whenever the page opens.
• In multiplayer, installed participants now see Role Guide values based on the host's settings.

4.1.2

• Older configuration files now keep compatible customized values, carry supported renamed settings forward, and create a one-time backup before being updated.
• Improved role handling when players leave, return, or join during a stage. Returning players regain their previous role, while new players receive a role, upgrades, an announcement, and a HUD entry.
• Engineer no longer affects Camera, Propane Tank, Snowmobile, Flashlight, Clown Doll, or Love Potion, preventing problems for players without RoleShuffle.

4.1.1

• Gambler's spent effect is now restored whenever the team completes an extraction. Gambler reacts when a valuable doubles or is destroyed and is notified when the effect is restored.

4.1.0

• Added configurable base upgrade levels for every supported vanilla player upgrade except Throw. Role-specific levels temporarily replace the matching base levels during a stage.
• Added Hunter. Hunter weapons use 75% of their normal battery, and enemies defeated by Hunter can drop additional orbs.
• Added Stinker. Stinker leaves sequential uranium clouds along the path traveled.
• Added Engineer. Effect valuables held by Engineer are prevented from activating whenever possible.
• Added Mage with five chat-selected vanilla spells: star, gravity, roll, void, and laser. Each spell has a configurable health cost and cannot be cast when it would kill the Mage.
• Added separate configurable revival health values for Phoenix and Rescuer.
• Redesigned the role HUD as a rotating one-column display that keeps the local player's role visible and supports large groups.
• Added a scrollable Roles page to the Escape menu. The HUD and role list now remove players who leave during a stage.
• Automatically generated Bomber grenades can now be held only by players currently assigned Bomber.
• Changed Gambler's losing outcome from reducing a valuable's price to destroying the valuable.

4.0.3

• Added /roles, allowing each player to check their own assigned role through in-game chat. Vanilla participants can use it when the host has RoleShuffle installed.
• Added Duct Taped Grenades to Bomber's automatic grenade selection.
• Added Gambler, which can randomly increase or decrease the value of a directly grabbed valuable.

4.0.2

• Base Health upgrades now remain active between stages.
• Role changes now adjust only the required upgrade difference instead of resetting Health to zero.

4.0.1

• Added Health +1 to every role except Tank.
• Phoenix and Rescuer now revive players with 25 HP by default.
• Improved documentation consistency.

4.0.0

• First Release