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

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

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

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は、ステージが実際に遷移したときだけ解除されます。

役職一覧

設定

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

一般、通知、HUD

役職の抽選設定

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

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

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にすると、ランダム抽選できる役職がなくなります。