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 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 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.
• Jobless is not selected in single-player or a one-player session.
• Roles, role-specific upgrade overrides, hazards, healing effects, revival state, and the role HUD are cleared only when the stage actually transitions.

Roles

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

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 at assignment, role changes, 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.
• 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 anchored to the bottom-right corner of the full screen in the Escape menu opens a scrollable list of all synchronized player assignments.
• 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 selected by exact chat keywords. 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人だけのときはJoblessがランダム抽選から除外されます。

役職確認コマンド

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

役職の抽選

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

役職一覧

設定

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

一般、通知、HUD

基礎アップグレード

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

役職の抽選設定

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

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

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

通知とHUD

• ステージ開始時、各プレイヤーは割り当てられた英語の役職名をバニラのチャット／TTSで発言します。
• RoleShuffleが生成する通知TTSでは敵が反応しません。通常のマイク入力やその他のワールド音はバニラの動作を維持します。
• Stage Flux導入時は、ステージ開始通知が重ならないようStage Flux用の通知遅延を使用します。
• Stage FluxのTTS終了後、1.5秒間の無音を確認してから役職を通知します。
• MOD導入済みの参加者には、1列のROLES HUDがデフォルトで左下に表示されます。自分の役職を固定し、ほかのプレイヤーを最大7人ずつ5秒ごとに切り替えます。
• Escメニュー表示中は、画面全体の右下に固定されたROLESボタンから、同期された全プレイヤーの役職をスクロール表示できます。
• ゲーム内に役職説明は表示しません。

互換性

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です。
• 役職が置き換えたアップグレードはステージ終了時に基礎値へ戻ります。その他の管理対象アップグレードは基礎値を維持し、Throwには触れません。
• すべての役職を無効化するか、すべてのWeightを0にすると、ランダム抽選できる役職がなくなります。

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