RoleShuffle

English

Overview

RoleShuffle assigns every player a random role when a stage begins and clears all assigned roles and temporary upgrade levels when the stage ends. Each role specializes in one vanilla upgrade or effect.

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.

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

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.
• Role upgrades are temporary and are reset at stage end.
• Setting every role to disabled or weight 0 leaves no eligible random role to assign.

日本語

概要

RoleShuffleは、ステージ開始時に各プレイヤーへランダムな役職を1つ割り当て、ステージ終了時に役職と一時的なアップグレードレベルをすべて解除します。各役職は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がランダム抽選から除外されます。

役職の抽選

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

役職一覧

設定

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

一般、通知、HUD

役職の抽選設定

全役職にEnabledと相対的なWeightがあります。Enabled = falseまたはWeight = 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は設定された回数まで周囲の別プレイヤーを復活させます。
• 役職によるアップグレードは一時的で、ステージ終了時にリセットされます。
• すべての役職を無効化するか、すべての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