RoleShuffle

English

Overview

RoleShuffle assigns stage roles. Base Upgrades persist and can grow between stages.

Supports up to 30 players with only the host installed. Vanilla guests receive roles, upgrades, effects and chat/TTS notices. Installed guests also get the role HUD.

Upgrade items are removed from shops by default; roles grant temporary upgrades.

Contact

Feedback: GitHub Issues. GitHub account required.

Requirements

• R.E.P.O. v0.5.0
• BepInExPack 5.4.2305
• REPOConfig 1.2.7
• MenuLib 2.6.0

Later compatible MOD versions are also supported.

Installation

Install with a mod manager or place RoleShuffle.dll in the profile's BepInEx/plugins.

Multiplayer

• The host controls roles and gameplay settings.
• Vanilla participants do not need RoleShuffle.
• Installed guests get the role HUD and scrollable Roles page in the Escape menu, with individual HUD layouts.
• Mage and Trickster do not activate abilities when an expression is cleared. The host's own menu expression restoration is also ignored; other players' expressions restored after closing a menu can still activate an ability.

Role selection and presets

Lobby/Escape → ROLES → ROLE SETTINGS: host toggles, including secrets, share MOD settings and affect future assignments. Guests can view supported hosts’ settings.

PRESETS changes role ON/OFF only; weights, abilities, balance, Base Upgrades and HUD stay. Weight 0 stays excluded. Save the current selection in Custom 1–3, apply it later, or confirm an overwrite. Slots persist across restarts in the current profile.

Party-size, context and balance restrictions apply; presets preserve General.Enabled and zero weights.

Role command

• Chat /roles announces only your assigned role name; vanilla guests can also use it.
• Negotiator holders can check their role in shops. Otherwise outside stages: 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.
• General.UniqueRoles = true avoids duplicates until all eligible roles have been used.
• King is assigned to at most one player per stage.
• Showcase and Support groups have configurable minimum assignments by party size; see Role balance.
• Party-size limits are listed under Role balance. Small parties receive fewer hazardous roles.
• Roles in a player's last five assignments use half weight for that player; others' histories have no effect.
• No consecutive repeat roles. After Courier, Tuna, or Influenza, that player avoids all three for two stages. Restrictions relax only as needed to assign everyone a role.
• Jumper, Launcher, Climber, and Flyer are excluded from random assignment whenever any matching base upgrade target is equal to or higher than that role's configured target, including increases from truck draws.
• Influencer is excluded from random assignment when none of the upgrade targets reachable with the current party size exceed the current Base Upgrades.
• Tracker, Ghost, Medic, Courier, Rescuer, Influencer, Werewolf, Bodyguard, Imitator, Avenger, Influenza, and Twins are not selected in single-player or a one-player session.
• Imitator requires another active player with a copyable role.
• Context roles normally require their objects: Musician/Engineer/Electrician/Rider; Sniper needs a gun or melee weapon, Brawler/DualWielder a melee weapon, Rigger a Human Adventure Cable. Weapon-like valuables and staffs do not count.
• Leaving removes a player from the role list. Returning restores their role; new arrivals receive a role, upgrades and announcement.
• Roles and effects end with the stage. They stay if revival cancels a failed-stage transition.

Roles

Role	Function and default effect	Important limitation or risk	Configurable values
Tank	Raises maximum HP to 1.5 times Base, up to the 4,100 HP growth limit.	Health minimum 21.	Minimum, multiplier, cap
Runner	Raises sprint speed and stamina to 1.5 times Base, with growth limits of 205 and 2,040.	Minimum Speed 6, Stamina 46.	Minimums, multipliers, caps
Jumper	Adds up to 10 extra jumps before landing by setting Extra Jump to level 10.	Passive upgrade.	Extra Jump target 0–200
Lifter	Strength becomes Lv200, making heavy objects, carts and bikes easier to handle.	Normal Strength returns when the role ends. Excluded if Base already provides the same heavy-object strength (default: Lv50).	Strength level
Launcher	Launches the player farther forward when starting a Tumble. Launch is level 10.	Passive upgrade.	Launch target 0–200
Climber	Improves Tumble climbing and allows objects to be grabbed from farther away. Tumble Climb is level 50 and Range is level 20.	Passive upgrade.	Tumble Climb and Range targets 0–200
Flyer	Keeps Tumble Wings active longer for extended movement through the air. Tumble Wings is level 10.	Passive upgrade.	Tumble Wings target 0–200
Tracker	Passively reports the nearest enemy within 25m, warns within 8m, and tracks the nearest teammate's Death Head at any distance. Health minimum 3; Map Player Count minimum 1; preserves stronger Base upgrades.	Private reports only on meaningful changes, normally 20s apart. Close warnings bypass the wait without repeating while danger stays nearby. Straight-line directions relative to your view, including above/below. No item or command needed; requires 2+ players.	Health 0–200; detection, warning, interval and distance-change settings below.
Ghost	Boosts Death Head Battery. While dead, heals living allies near its head within a stage budget. Head carriers gain Speed.	Revival does not replenish healing. Multiple heads do not stack; the stronger King Speed bonus takes priority. Excluded with one player; high Base levels do not exclude it.	Battery, healing, carrier Speed
Bomber	Drops a random armed grenade every 8 m traveled. Up to 30 generated grenades remain active per Bomber, and the oldest is removed at the limit.	Grenades can injure players and damage valuables. Only Bomber can hold generated grenades. Movement inside the truck does not count while truck placement is disabled.	Distance, limit, truck placement, grenade types
Medic	Heals nearby teammates for 5 HP every 2 seconds within 5 m, up to 150 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. Requires 2+ players for random assignment.	Amount, interval, radius, total limit
Phoenix	Automatically revives itself with 25 HP once per stage after dying.	Requires a stationary Death Head. An unused revival prevents game over without a time limit. Revival HP cannot exceed maximum HP.	Revival HP, revival delay
Courier	Carry a valuable worth money 5 m while holding it outside delivery areas, then place it in the truck or an extraction point. Delivery heals HP and pauses HP loss by size (below).	120-second pause at stage start/revival. Otherwise loses 1 HP/0.1 s outside the truck; can die. Automatic HP loss stops after the final extraction until stage end. Other damage still applies. Unlimited deliveries; each item rewards each player once per stage. Early drops reset distance. Not selected solo.	Delivery and HP loss
Rescuer	While alive, grab a dead teammate's Death Head to revive them with 25 HP, even while the head is moving.	Keep holding until revival; releasing while waiting cancels the rescue. Up to 2 revivals per stage. Revival HP cannot exceed the target's maximum HP. Requires 2+ players for random assignment.	Revival HP, delay, maximum revivals
Vampire	Heals when an enemy dies within 10 m: Tier 1 = 5, Tier 2 = 10, Tier 3 = 50.	Uses the enemy's vanilla Danger Level. When Enhanced enemy rewards are enabled with Elite Enemy Variants, Enhanced enemies count one tier higher up to Tier 3. The Vampire must be alive and close to the dying enemy.	Amount per tier, radius
King	Crown; grants nearby allies Speed/Range +2 and up to Strength +5 within 12 m.	No self-buff or stacking. Level cap 200; Strength cannot weaken grip/rotation. Leaving removes only King bonuses. One King per stage.	Radius and bonus levels
Tuna	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
Musician	Playing heals self and living allies within 10 m for 5 HP. All instruments share a 1-second cooldown and 1000 HP stage budget.	Piano, Harp, Guitar, Banjo; Pan Flute, Harmonica and Mouth Harp while sounding at the mouth. Normally excluded without instruments. Death/role changes preserve the budget.	Amount, radius, cooldown, budget
Mage	Uses star, gravity, roll, void, or laser in chat or configured facial expressions to cast HP-consuming attacks. After a damage-free delay, gradually heals within a stage budget. Held-staff magic lasts 1.3x as long.	Shared cast cooldown; must survive the HP cost. Spells can harm players/valuables. Selecting a matching expression casts; clearing it does not. Staff bonus excludes chat/expression casts and the Star Wand’s instant attack.	Expressions, cooldown, HP costs, recovery toggle/delay/interval/amount/budget
Gambler	A held valuable has a 50% chance to double its value; otherwise it breaks. Gambit: green heals 50 HP, red deals 100 damage, black kills, white fully heals and adds 5 Health levels for the stage.	One wager is available at a time and returns after extraction. Damaged valuables use their reduced value.	Win chance, win multiplier, Gambit green heal, red damage, white temporary Health levels
Hunter	Reduces weapon battery use. Personal kills of orb-dropping enemies can give doubled/jackpot drops; repeated qualifying kills guarantee extra orbs.	Random extras satisfy the guarantee. Count resets each stage. Only held/equipped weapons and confirmed personal kills qualify. Enhanced rewards affect extra-orb quality only.	Battery, orb chances/count, guarantee interval
Stinker	Leaves harmful uranium clouds after moving the required distance, one at a time after clearing the newest spawn’s safety radius. Spawned uranium breaks after a short grace period.	Clouds can damage other players, and Stinker can be hurt by walking back into one. Truck placement is disabled by default.	Distance, safety distance, truck spawning, break delay
Engineer	Prevents supported effect valuables from activating while the Engineer holds them.	Camera, Propane Tank, Snowmobile, Flashlight, Clown Doll, and Love Potion are not affected. By default, not randomly selected if no supported effect valuable is present. Some effects fade gradually; vanilla players may still see or hear effects.	Selection only
Trickster	Type decoy or select its expression to place a fixed Scream Doll that repeatedly attracts nearby enemies.	One active decoy. Cooldown starts when it ends, with a shorter wait if no enemy was attracted. Cannot be grabbed, damaged or delivered.	Expression, active time, both cooldowns, radius, pulse interval, placement distance
Mechanic	Directly holding damaged valuables restores a shared 2% of original value per second, up to 50 percentage points per stage.	Only restored value counts. Ignores fully repaired and non-valuable objects. Multiple objects share the repair rate and limit. Visual damage may remain.	Repair rate, total stage limit
Electrician	Holding inactive rechargeable items restores a shared 10 battery percentage per second, up to 100 per stage.	Active, full, and unchargeable items are ignored. By default, not randomly selected if no rechargeable item is present.	Charge rate, total stage limit
Warden	Extends enemy stuns caused by Warden's weapons, grenades, or held damaging objects by 3 seconds.	Requires a normally stunning attack.	Additional stun time
Ninja	Footsteps, landings, voice chat, and chat TTS do not draw enemy investigation. Enemies take twice as long to recognize Ninja visually.	Close contact and noises from weapons, valuables, impacts, explosions, or hazards can still reveal Ninja.	Visual recognition multiplier
Executioner	Deals 2x direct attack damage to enemies that were already stunned before the hit.	No bonus for the initial stunning hit or collisions alone.	Stunned-enemy damage multiplier
Rider	While driving a vanilla vehicle, deals 3x impact damage to enemies and doubles existing Tumble knockback against players.	Player damage is not increased. By default, not randomly selected if no vanilla vehicle is present.	Enemy damage and player knockback multipliers
Influencer	Gains stronger upgrades as more living teammates enter a 20 m radius and periodically speaks an English TTS line.	Its footsteps, landings, VC, and chat TTS reach enemies from twice as far away.	Radius, check rate, per-upgrade player-count scaling, noise multiplier, TTS timing and radius
Werewolf	Deals 2x damage to another player when Werewolf can be identified as the attacker.	Self-damage, environment damage, and damage with no identifiable player attacker are unchanged. Requires 2+ players for random assignment.	Player damage multiplier
Berserker	Gains stronger upgrades as remaining HP becomes lower.	Bonuses decrease again when healed.	Per-upgrade HP-percentage scaling
Bodyguard	Sets Health to level 11 and absorbs 50% of enemy damage dealt to a teammate within 15 m.	Transferred damage cannot reduce Bodyguard below 1 HP.	Health target, radius, damage share
Rammer	Tumble Attack deals 100 damage to enemies and deals 15 damage to Rammer after a successful hit.	Launch, Tumble Climb, and Tumble Wings are fixed at level 0 for the stage regardless of Base Upgrades.	Tumble Attack and self damage
Diver	Tumbling while continuing to look down at a fixed floor enables movement below it for up to 10 seconds.	Failing to return through a floor in time kills Diver. Returning above the floor starts a cooldown equal to 1.5 times the previous dive time. The countdown and ready state are announced by TTS.	Underfloor duration, movement force
Sniper	Enemy damage scales with distance: 0.5x at point-blank range, 1x at 6 m, and up to 2x at 18 m.	Requires an identifiable attacker. Vehicle impacts and Tumble Attacks are unchanged.	Distances and multipliers
Imitator	Starts with Base Upgrades. Grab a teammate’s health-transfer point to copy their upgrades, abilities and drawbacks for the stage; the role list identifies the copy.	Cannot copy Imitator/King/Bomber/Stinker/Werewolf/Courier/Tuna/Influenza/Twins/???1/???2; invalid attempts announce CannotCopy. First valid copy is fixed. Requires 2+ players for random assignment.	Selection only
Avenger	Enemy hits on nearby allies and nearby ally deaths temporarily increase your damage against enemies.	Activation/expiry notices. Only the stronger bonus applies. Deaths refresh the death bonus without the hit cooldown. Self-damage/friendly fire cannot trigger the hit bonus; own death grants nothing. Excluded with one player.	Hit/death range, threshold, multipliers, durations, cooldown
Brawler	Melee hits on the same enemy rise from 1.25x by 0.25 per hit, up to 2x. Guns, staff projectiles and lasers deal 0.75x.	Changing enemy or 4 seconds without a hit resets the combo. Friendly fire stays at 1.25x. Vehicle impacts, Tumble Attacks, grenades and ordinary objects are unchanged.	Melee/ranged multipliers, combo step/cap/timeout
Influenza	After incubation, forces maximum HP to the configured value. Automatic sneezes can infect teammates in front and alert enemies in every direction. Ordinary voice utterances and chat messages can also infect nearby teammates in front. Only symptomatic players spread infection.	Infection immediately replaces the teammate’s role with Influenza, followed by their incubation. Death/revival preserves the timer; stage end clears infection. Continuous speech counts as one utterance. Enemy hearing changes sneeze audibility. Excluded from solo draws.	Onset, HP, sneeze timing, infection range/angle/chance, hearing
Twins	Shares combined current/max HP between two players. Co-carrying a valuable grants temporary Strength upgrades (cap Lv200) and reduces collision loss. Crouching still together heals shared HP and fully restores stamina. Sprinting toward a distant partner grants a temporary speed boost. Joint delivery adds value once per item, within the stage budget; both partners must be near the cargo.	Requires 2+ players; at most one fixed pair. Either death kills both; one revival revives both with one revival’s HP. Infection changes both to Influenza and ends sharing. Stage end/disconnect ends sharing and preserves HP proportion. No HP transfers within the pair, copying, or shop-equipment carry bonus.	Selection, carry, rest, reunion, delivery
Porter	Solo-hold a Tiny/Small/Medium valuable for 3 s outside delivery areas to store it. Capacity 15 by weight, no count limit. In delivery areas or aboard a cart, unload in 10 s at full load or 5 s at half.	Enemy HP damage scatters all cargo. Speed levels fall with weight (rounded down): 0 at full load, restored on unloading. Leaving or spilling resets the wait. Death/role change/disconnect/stage end returns cargo. No shop gear. Private capacity/unload notices.	Capacity, sizes, hold/unload time, enemy-hit drop
DualWielder	A second melee weapon 0.5 m left repeats movement/attacks 0.3 s later, hitting all targets under vanilla rules. Both consume shared battery/durability.	Hold alone. Copy vanishes on release, switch, death or role loss; cannot be picked up or kept. Excluded without melee weapons.	Delay, left offset
Rigger	Human Adventure Cable: 2x enemy hit damage, 1.5x enemy restraint time, 50% hit/throw durability cost.	Automatic. Player effects unchanged. Requires a cable for normal draws. Standard/Cooperative/Challenge.	All three multipliers
Negotiator	Starts at 0. Qualifying personal delivery at extraction: +1; personal kill of the selected tier: +1. Each once/stage, max 2. In the next shop, present items yourself for guaranteed normal discounts without rejection damage or shared attempts.	Truck delivery excluded. Death/ability loss revokes all and blocks re-earning that stage. Shop exit expires rights; interruptions free. Shop role/HUD, /roles, entry notice. Standard/Cooperative.	Selection, delivery distance/sizes, exact enemy tier
???1	???	???	???
???2	???	???	???

Role growth and support settings

Ability resources appear below stamina in one column and shrink to fit when necessary. The role list shows each player's role. The resource HUD requires the host's RoleShuffle version.

Ability tuning

Host: REPOConfig → RoleShuffle → role name. Defaults are listed above. Strength, HP and infection checks use current settings. Incubation changes affect new infections; scheduled sneezes keep their deadlines. Stinker delay affects new valuables. Existing settings stay.

Configuration

Edit through REPOConfig. All settings are host-controlled except HUD.*, which affects only your display. Grouped keys share the first section.

General, notifications, and HUD

Role balance

Showcase roles are Bomber, Stinker, Mage, Gambler, Trickster, King, Rider, Influencer, and Diver. Support roles are Medic, Rescuer, Mechanic, Electrician, Warden, Bodyguard, Porter, Rigger, and Negotiator. Danger roles are Bomber, Stinker, Werewolf, and Influenza; Hardship roles are Courier, Tuna, and Influenza. Influencer is not a Danger role. If these rules leave no eligible role, RoleShuffle gradually loosens the limits so every player can still receive a role.

Base upgrades

Item retention starts when enabled; earlier uses are not recovered. Saved levels add to role/base targets; Lifter/Rammer fixed levels and Influenza HP take priority. BASE UPGRADES excludes item bonuses; these appear in vanilla stats. To sell upgrades, set General.ShopUpgradeItemCount above 0.

Base targets stay active between stages and apply to upgrades not overridden by the current role. Use comma-separated run level:value pairs: 1:1,5:3,10:6 means 1 on levels 1–4, 3 on levels 5–9, and 6 from level 10. Run levels accept 1–999999. Blank settings and levels before the first entry use 0. Values are clamped to the allowed range; malformed pairs are ignored. Base settings and truck draws do not change Throw.

Truck draws occur after leaving the shop, during truck preparation. They select an upgrade and change amount using relative weights. Amounts that no eligible target can receive within its limits are excluded. Positive results can select All Upgrades, affecting enabled types with room below their limits. Results persist for the run and are announced by the host.

Open ROLES → BASE UPGRADES → BASE UPGRADE SETTINGS to toggle the draw and its 13 entries (12 types plus All Upgrades). These switches share the saved REPOConfig values. Hosts edit; installed participants view the host's settings. Apply pending REPOConfig edits before leaving its page; Roles UI saves immediately.

OFF excludes a type from future individual and All Upgrades draws without removing its base levels or acquired bonuses. An active draw keeps its starting selection. No individual draw means weight 0; an ON type can still receive All Upgrades. No draw on All Upgrades means its weight is 0. Disabling that entry affects only combined results. All-off selections produce no result.

Manual adjustments persist per save. Each +/- click changes the total by 1, within 0–200 (Map Player Count: 0–1). The host needs a save-supported lobby.

Higher weights are more likely; weights fall near the draw limit. Shop stock does not affect draw weights.

Role selection

Each standard role has host settings <Role>.Enabled = true and <Role>.Weight = 100 (range 0–1000). OFF or weight 0 excludes it from random assignment. Use Courier for Courier's section. The two hidden roles use ???1.Enabled and ???2.Enabled, both true by default, with fixed weights. These switches apply from the next assignment. Twins is selected as one pair of two players, even when unique roles are enabled.

Upgrade and special-role settings

The default Base level is Health 1 and 0 for other upgrades. Role upgrade settings specify the level used during that role; they are not levels added to Base. Influencer and Berserker preserve stronger upgrades when their conditions change. Tracker keeps stronger Base upgrades and remains eligible at high Base levels. Rammer sets Launch, Tumble Climb and Tumble Wings to 0 during the stage. Throw is unaffected.

Player tools

Open ROLES in the top-right of the Escape or lobby menu, then select TOOLS or DRAW HISTORY.

• Role guide: Overview summarizes abilities; Details shows host-configured values and limits. Draw eligibility shows your current candidates and exclusion reasons. Conditions may depend on other players; stage items remain unconfirmed until generation.
• HUD editor: in TOOLS, drag the HUD sample and adjust its anchor, alignment, text/icon size, scale, mode and visibility. SAVE keeps local settings; CANCEL or Esc discards them; RESET previews defaults. Mouse controls also work in the lobby.
• Bug report: in TOOLS, copy or open the report, review it, add reproduction steps and submit through OPEN GITHUB ISSUES. Reports include mod versions/settings/recent activity, save to BepInEx/RoleShuffleReports, and are never sent automatically.
• Language: Menus support all 21 R.E.P.O. languages, including Arabic, Thai and regional Spanish/Portuguese. They follow the game setting. Roulette upgrade names use the game’s translations. Role names, setting identifiers, commands and diagnostics stay English.
• Sync status: TOOLS shows whether roles, guide, Base Upgrades and history are current. REFRESH DISPLAY DATA refreshes these displays without changing roles or upgrades.
• Draw history: shows the latest 50 completed truck draws, including level, target, rolled change and actual before/after targets. Zero/capped results are retained; cancelled draws are omitted. History is saved with the host’s run and shared with installed participants.

HUD.FontSize defaults to 28 (range 16–48) and is a personal setting. The default HUD display mode is NameOnly.

Dynamic scaling (<Upgrade>UpgradeScaling): comma/semicolon-separated pairs. Influencer uses the last reached player count (0–30); Berserker the lowest reached HP threshold (0–100%). Last duplicate wins; invalid pairs are ignored. Levels: 0–200 (MapPlayerCount 0–1). Blank/0 grants no role levels; stronger Base levels stay. Defaults: — blank, N/A unavailable.

Notifications and HUD

• Resources: the remaining healing, revives, repair, charge and wagers appear below stamina as cyan icons and numbers in one column. The display fits the available space, and empty resources turn red. It appears while you are alive and have the mod installed. Adjust it with HUD.ResourceHud*.
• Mod users see role emblems in CURRENT ROLES, ROLE GUIDE and optionally the HUD. Icons have transparent exteriors; unrevealed secrets share a question mark.
• At stage start, players announce their English role names via vanilla chat/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.
• With Stage Flux, uses its separate announcement delay and waits for its TTS to end plus 1.5 s of silence.
• Initial role announcements play one at a time. Later notices and replies wait only for the same player's chat/TTS; different players can speak together.
• Influencer speech and Influenza sneezes wait for their own player's messages and remain audible to enemies. Diver counts at 15-second marks (30, 15), then every second from 10 to 0, interrupting previous speech; normal notices wait.
• The local ROLES list defaults to names at the bottom left, with your role pinned and pages rotating every 5 seconds. It fits six multilingual/icon rows when HUD.PlayersPerPage is 6 or higher; smaller limits are respected. Long player names are shortened to keep role names visible. See HUD settings above.
• Installed players see the Base Upgrade draw animation.
• Open ROLES at the top-right of Escape (CURRENT ROLES) or the lobby (ROLE GUIDE; current roles unavailable). Your role appears first with its overview expanded; click players to toggle overviews. The left column also opens BASE UPGRADES: host targets, configured targets and accumulated truck-draw bonuses.
• ROLE GUIDE explains enabled roles in your selected language. In multiplayer, descriptions use the host's settings. If a description is unavailable in your language, it appears in English. Single-player uses your own settings.

Compatibility

Stage Flux is optional and not required.

• Second Chance takes priority over Phoenix, Rescuer, and Bodyguard revival effects. Revival effects that are not needed remain available.
• If Second Chance or Phoenix prevents a failed stage transition, current roles remain active.
• During Value Surge or Value Crash, Mechanic repairs only the value that was actually lost.
• Initial roles wait for Stage Flux announcements. Later messages wait for Stage Flux speech by the same player.
• Enemy Purge defeats do not activate Hunter rewards.
• Dangerous Valuables respects valuables protected by Engineer.

Elite Enemy Variants is optional and not required.

• Living Ninja players are excluded from Elite Enemy Variants attacks that specifically require an unseen player target. Dead Ninjas and all other players remain eligible.
• When Compatibility.EnhancedEnemyRewardsEnabled is true, Enhanced enemies provide stronger Vampire healing and better Hunter bonus orbs, up to the Tier 3 reward. This does not change the normal number of orbs.
• Gambler's roulette effect stays attached to the correct player even when an Enhanced Gambit moves after capture.
• RoleShuffle does not add Elite Enemy Variants enemy counts, state, or defeat notices to its HUD or menu.

Gameplay notes

• Twins supports host-only play. Simultaneous damage or healing can cause some difference in the shared HP result.

• Mage spells can harm players and valuables; spell names ignore case. The laser follows the caster's view. RoleShuffle users see only the beam; unmodded guests still see its temporary staff.

• Courier and Tuna continuously deal real damage under their stated conditions and can kill their owner. The damage is not automatically restored.

• Role upgrades end at stage end. Base levels include retained item amounts when enabled. Throw remains permanent.

• When a role's maximum HP bonus ends, remaining HP keeps its proportion, rounded down (at least 1 HP while alive): 300/520 becomes 69/120.

• Setting every role to disabled or weight 0 leaves no eligible random role to assign.

日本語

概要

RoleShuffleはステージごとに役職を抽選し、移動・回復・戦闘などの能力を付与。基礎アップグレードはステージ外でも維持され、ランの進行に応じて強化可能です。

ホストのみの導入で最大30人に対応。未導入の参加者にも役職・アップグレード・効果・チャット／TTS通知が適用されます。導入済みの参加者は全員の役職を確認できるHUDも利用できます。

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

お問い合わせ

ご質問、不具合報告、ご意見はGitHub Issuesからお送りください。投稿にはGitHubアカウントが必要です。

必須MOD

• R.E.P.O. v0.5.0
• BepInExPack 5.4.2305以降の互換バージョン
• REPOConfig 1.2.7以降の互換バージョン
• MenuLib 2.6.0以降の互換バージョン

導入方法

MODマネージャーで導入するか、RoleShuffle.dllをプロファイルのBepInEx/pluginsへ配置してください。

マルチプレイ

• 役職の抽選とゲームプレイ設定はホストが管理します。
• MOD未導入の参加者にも対応しており、RoleShuffleの導入は不要です。
• 導入済みの参加者は役職HUDとEscメニューのスクロール可能なRolesページを利用できます。HUD配置は個別に変更可能です。
• MageとTricksterは表情の解除では能力を発動しません。ホスト自身のメニュー終了時の表情復帰も除外しますが、参加者のメニュー終了時に復帰した表情では能力が発動する場合があります。

ロール選択とプリセット

ロビー／EscのROLES→ロール設定で、ホストがシークレットを含む各役職のON/OFFを保存できます。途中参加者を含む次の抽選から適用し、現在の役職は維持。参加者は閲覧のみで、旧ホストの未対応データは未受信と表示します。

プリセットは役職のON/OFFだけを変更し、重み・能力値・バランス・Base Upgrade・HUDは維持します。重み0は抽選されません。「カスタム1～3」に現在の構成を保存して再適用でき、上書きは確認後に実行します。保存枠は同じプロファイルの再起動後も保持します。

人数・状況・バランスによる抽選制限は引き続き適用されます。全体の抽選が無効の場合や候補がない場合は画面に表示。プリセットを適用してもGeneral.Enabledや重み0は変更しません。

役職確認コマンド

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

役職の抽選

• プレイ可能なステージの開始時、各プレイヤーへ役職を1つ割り当てます。
• 有効な役職を相対的なWeightに基づいて抽選します。
• General.UniqueRoles = trueの場合、抽選可能な役職を一巡するまで重複を避けます。
• Kingはステージごとに最大1人です。
• Showcase役とSupport役を、人数に応じた最低人数まで優先して割り当てます。対象は「役職バランス」を参照。
• デフォルトでは、24人以上でShowcaseとSupportをそれぞれ最低4人保証します。Danger上限は8人で2人、16人で3人へ増え、Hardship上限は12人で2人へ増えます。InfluencerはShowcase役であり、Danger役として扱いません。4人以下では両リスクグループを合わせて最大1人です。
• 各プレイヤーが直近5回に割り当てられた役職は、そのプレイヤーの次回抽選時に通常の半分のWeightで扱います。他のプレイヤーの履歴は影響しません。
• 同じプレイヤーへ前ステージと同じ役職を通常は連続で割り当てません。Courier、Tuna、Influenzaのいずれかの後、2ステージはそのプレイヤーをこれらの役職から除外します。役職未割り当てを防ぐ必要がある場合だけ制限を緩和します。
• Jumper、Launcher、Climber、Flyerは、トラック抽選分を含む基礎アップグレード目標値のいずれかが、対応する役職の設定値以上の場合、ランダム抽選から除外されます。
• Influencerは、現在の参加人数で到達可能なアップグレード目標値が現在のBase Upgradeを1項目も上回らない場合、ランダム抽選から除外されます。
• Tracker、Ghost、Medic、Courier、Rescuer、Influencer、Werewolf、Bodyguard、Imitator、Avenger、Influenza、Twinsはシングルプレイまたは1人のセッションでは抽選されません。
• Imitatorは、コピー可能な役職を持つ他の参加者が確保された場合だけ抽選されます。
• デフォルトでは、能力を使える対象がない状況依存役を抽選から除外します。必要なオブジェクトがないMusician、Engineer、Electrician、Riderと、近接武器も銃もない場合のSniper、近接武器がない場合のBrawler・DualWielderが対象。これらの抽選判定では、武器として使える貴重品も武器に含めません。Sniperの抽選判定では杖も対象外です。
• 退出したプレイヤーは役職一覧から外れます。再参加すると以前の役職に戻り、新しい参加者には役職・強化・通知が適用されます。
• 役職とステージ中の効果は、ステージが実際に終了した場合だけ解除します。復活効果によって失敗時のステージ移行が中断された場合は維持。

役職一覧

役職	機能とデフォルト効果	主な制限・危険性	調整可能な値
Tank	基礎の最大HPを1.5倍に強化します。倍率強化の上限は4,100HPです。	最低Health 21。	最低値・倍率・上限
Runner	基礎の走行速度・スタミナを1.5倍に強化します。倍率強化の上限は205・2,040です。	最低Speed 6・Stamina 46。	最低値・倍率・上限
Jumper	Extra Jumpがレベル10になり、着地するまでに最大10回の追加ジャンプを使えます。	常時有効の強化。	Extra Jump目標値0～200
Lifter	StrengthをLv200に変更し、重い物・カート・バイクを扱いやすくします。	役職終了で本来のStrengthに戻ります。基礎値が重量物に対して同等の力に達すると抽選対象外（初期設定ではLv50）。	Strengthレベル
Launcher	Tumble開始時にプレイヤーをより遠く前方へ飛ばします。Launchはレベル10です。	常時有効の強化。	Launch目標値0～200
Climber	Tumble中の登りやすさが増し、より遠くの物を掴めます。Tumble Climbはレベル50、Rangeはレベル20です。	常時有効の強化。	Tumble ClimbとRangeの目標値0～200
Flyer	Tumble Wingsの効果時間が延び、空中をより長く移動可能です。Tumble Wingsはレベル10です。	常時有効の強化。	Tumble Wings目標値0～200
Tracker	25m以内の最も近い敵を自動通知し、8m以内への接近を警告。死亡した仲間の最も近い頭は距離制限なく追跡。Health最低3、Map Player Count最低1となり、高い基礎強化を維持。	有意な変化があると本人だけに通常20秒間隔で通知。接近警告は待ち時間中も届きますが、危険が近くに留まる間は連発しません。視点基準の直線方向と上下を案内。アイテム・操作不要、2人以上で抽選。	Health 0～200。検知距離・警告距離・通知間隔・距離変化は下表。
Ghost	Death Head BatteryはLv50。死亡中、頭から5m以内の味方を2秒ごとに1HP回復し、1ステージで合計50HPまで回復。頭を持つ味方はSpeed＋1。	蘇生しても回復上限は戻りません。複数の頭では重複せず、KingのSpeed支援とは強い方を優先。1人では抽選されません。Baseが高くても抽選対象。	Battery、回復、運搬者のSpeed
Bomber	8 m移動するごとに起動済みグレネードをランダム設置します。Bomber 1人につき最大30個まで残り、上限では最も古いものを削除します。	グレネードはプレイヤーやValuableにも危険です。生成されたグレネードを持てるのはBomberだけです。トラック内設置が無効な場合、トラック内の移動距離は加算されません。	距離、上限、トラック内設置、グレネード種類
Medic	5 m以内の仲間を2秒ごとに5 HP回復し、ステージごとに合計150 HPまで回復します。	Medic自身は回復しません。範囲内で生存している仲間だけが対象。そのMedicの上限を使い切ると回復を停止します。参加者が1人だけの場合はランダム抽選されません。	回復量、間隔、範囲、合計上限
Phoenix	死亡すると、1ステージに1回だけデフォルト25 HPで自動復活します。	頭が静止していることが条件です。復活回数が残っている間は、時間制限なくゲームオーバーを防ぎます。復活後HPは最大HPを超えません。	復活後HP、復活遅延
Courier	価値のある貴重品をつかんだまま搬入先の外で5m運び、トラックか納品所に入れると配達完了。サイズ別にHP回復・自動HP減少の一時停止（下表）。	開始・蘇生時は120秒停止。効果切れ中はトラック外で0.1秒ごと1HP減少、死亡あり。最終納品後はステージ終了まで自動HP減少が停止。敵の攻撃等は防げません。配達回数無制限、同じ品の報酬は各自1ステージ1回。途中で放すと運搬やり直し。1人では抽選対象外。	配達・自動HP減少
Rescuer	生存中に、死亡した仲間のDeath Headをつかむと、デフォルト25 HPで復活させます。頭が動いていても使用可能です。	復活まで頭をつかみ続けてください。待機中に手を離すと中止します。ステージごとに最大2回です。復活後HPは対象の最大HPを超えません。参加者が1人だけの場合はランダム抽選されません。	復活後HP、遅延、最大復活回数
Vampire	10 m以内で敵が死亡すると、Tier 1は5、Tier 2は10、Tier 3は50回復します。	敵のバニラDanger Levelを使用します。Elite Enemy Variants導入時にEnhanced報酬補正が有効なら、Enhanced個体を最大Tier 3まで1段階上として扱います。Vampireが生存し、死亡した敵の近くにいる必要があります。	Tier別回復量、範囲
King	Crownと12mの強化範囲。味方へSpeed・Range各＋2、Strength最大＋5。	自分は対象外。重複なし。上限200、掴む力・回転力の低下なし。範囲外で追加分を解除。1ステージ1人。	半径・追加レベル
Tuna	ステージ開始時の5秒間の猶予後、3秒間停止すると、移動するまで0.1秒ごとに1ダメージを受けます。	死亡する可能性があります。停止時間の計測は最初の猶予後に始まります。動くと即座にリセットし、失った体力は回復しません。	停止時間、ダメージ、間隔
Musician	演奏中、本人と10m以内の生存者を5HP回復。全楽器共通で1秒間隔、1ステージ合計1000HPまで。	ピアノ・ハープ・ギター・バンジョーに対応。パンフルート・ハーモニカ・口琴は口元で発音中に回復。楽器がなければ通常は抽選対象外。死亡・役職変更でも残量を維持。	回復量・範囲・間隔・上限
Mage	チャットのstar・gravity・roll・void・laserまたは設定した表情でHPを消費して攻撃。無被弾時間後、ステージ予算内で徐々に回復。保持した杖の魔法持続時間は1.3倍。	全攻撃でクールタイム共有。HP消費後に生存できる場合のみ発動。味方や貴重品にも危険。対応表情を選ぶと発動し、解除時は発動しません。杖の延長はチャット/表情魔法とStar Wandの即時攻撃には適用しません。	表情・間隔・HP消費・回復ON/OFF/猶予/間隔/量/上限
Gambler	持ったValuableは50%の確率で現在価格が2倍になり、失敗すると破壊されます。Gambitは緑で50 HP回復、赤で100ダメージ、黒で死亡、白で全回復してステージ中のHealthを5レベル増やします。	賭けは一度に1回だけ使用でき、納品後に復帰します。傷ついたValuableは低下後の価格を基準にします。	勝率、勝利倍率、Gambitの緑回復量、赤ダメージ、白の一時Healthレベル
Hunter	武器のバッテリー消費は通常の75％。自分が倒したオーブを落とす敵は10％でオーブ2倍、0.5％で10個。対象の敵を5体倒すごとに追加オーブを最低1個保証。	抽選の追加分は保証分を兼ねます。撃破数はステージごとにリセット。本人が保持・装備する武器と、本人の撃破が対象。Enhanced報酬は追加オーブの品質だけに影響します。	バッテリー、オーブの確率・個数、保証間隔
Stinker	2 m移動するごとに、ダメージを与えるウラン雲を残します。雲は、Stinkerが最新の発生位置から2 m以上離れた後に1つずつ発生します。出現したウラン貴重品は0.5秒の猶予後に壊れます。	ウラン雲はほかのプレイヤーへダメージを与えます。Stinkerも雲へ戻るとダメージを受ける可能性があります。デフォルトではトラック内に発生しません。	距離、安全距離、トラック内発生、破壊猶予
Engineer	対応している効果付きValuableを保持している間、その効果が発動しないようにします。	Camera、Propane Tank、Snowmobile、Flashlight、Clown Doll、Love Potionは対象外です。デフォルトでは対応Valuableが存在しない場合に抽選されません。一部の効果は徐々に消えます。MOD未導入の参加者には見た目や音が残る場合があります。	抽選設定のみ
Trickster	decoyのチャット入力または設定表情で、近くの敵を繰り返し引き寄せる固定Scream Dollを設置。	同時に1個。終了後にクールタイムが始まり、敵を引き寄せなかった場合は短縮。つかむ・破壊・納品はできません。	表情・持続・通常/空振り間隔・範囲・誘導間隔・設置距離
Mechanic	破損したValuableを直接掴んでいる間、元の売却価格の合計2%を毎秒回復し、ステージごとに合計50ポイントまで回復します。	実際に回復した価格だけがステージ上限へ加算されます。修復済みのValuableとValuable以外は対象外です。複数を同時に掴んだ場合、回復速度とステージ上限を共有します。売却価格を回復する効果で、破損した外見は残る場合があります。	回復速度、ステージ合計上限
Electrician	使用していない充電可能なアイテムを直接掴んでいる間、合計10%のバッテリーを毎秒回復し、ステージごとに合計100ポイントまで回復します。	使用中、満充電、充電不可能なアイテムは対象外です。デフォルトでは充電可能アイテムが存在しない場合に抽選されません。	充電速度、ステージ合計上限
Warden	Wardenの武器、グレネード、保持している攻撃用オブジェクトによる敵のスタン時間を3秒延長します。	元の攻撃がその敵をスタンさせられる場合だけ適用。	追加スタン時間
Ninja	足音、着地音、VC、チャットTTSで敵の調査行動を発生させず、視覚で認識されるまでの時間が2倍になります。	接近や、武器、Valuable、衝突、爆発、危険物などの物音では発見される可能性があります。	視認時間倍率
Executioner	攻撃前からスタンしている敵への直接攻撃ダメージが2倍になります。	最初にスタンさせる攻撃には倍率が適用されません。物がぶつかっただけのダメージには倍率が適用されません。	スタン中ダメージ倍率
Rider	バニラ車両の運転中、敵への衝突ダメージを3倍にし、プレイヤーへ元から発生するTumbleノックバックを2倍にします。	プレイヤーへのダメージは増えません。デフォルトではバニラ車両が存在しない場合に抽選されません。	敵ダメージ倍率、プレイヤーノックバック倍率
Influencer	半径20 m以内の生存中の仲間が多いほど強化され、定期的に英語TTSを発言します。	足音、着地音、VC、チャットTTSが敵へ届く範囲は2倍です。	範囲、確認間隔、アップグレード別の人数連動設定、物音倍率、TTS間隔と範囲
Werewolf	Werewolfが攻撃者と特定できる、他のプレイヤーへのダメージを2倍にします。	自傷、環境ダメージ、攻撃者を特定できないダメージは変化しません。1人のセッションでは抽選されません。	プレイヤーダメージ倍率
Berserker	残りHPが少ないほど強化されます。	HPを回復すると強化も戻ります。	アップグレード別のHP割合連動設定
Bodyguard	Healthがレベル11になり、15 m以内の仲間が敵から受けたダメージの50%を肩代わりします。	肩代わりによってBodyguardのHPが1未満になることはありません。	Health目標、範囲、肩代わり率
Rammer	Tumble Attackで敵へ100ダメージを与え、命中後に自身が15ダメージを受けます。	ステージ中はBase Upgradeにかかわらず、Launch、Tumble Climb、Tumble Wingsがレベル0に固定されます。	Tumble Attack・自傷ダメージ
Diver	固定された床で下を向いたままタンブルすると床を抜け、最大10秒間、床下を移動可能です。	時間内に床を抜けて戻れないと死亡します。床上へ戻ると直前の潜航時間の1.5倍のクールダウンが始まり、残り時間と再使用可能状態はTTSで通知されます。	床下制限時間、移動力
Sniper	敵へのダメージが距離に応じて連続変化し、密着時0.5倍、6mで1倍、18mで最大2倍。	攻撃者を特定できる場合に適用。車両衝突とTumble Attackは変化しません。	距離・倍率
Imitator	最初はBase Upgradesだけが適用されます。他のプレイヤーへHPを渡すときと同じ位置をつかむと、その仲間のアップグレード、能力、デメリットを残りのステージ中コピーします。以後、割り当て一覧にはImitatorとコピー先の役職を併記します。	Imitator、King、Bomber、Stinker、Werewolf、Courier、Tuna、Influenza、Twins、???1、???2はコピーしません。対象外をつかむとCannotCopy（コピー不可）と通知します。最初に成功したコピーはそのステージ中固定です。1人のセッションでは抽選されません。	抽選設定のみ
Avenger	近くの仲間への敵の攻撃や、近くの仲間の死亡で、敵へのダメージが一時増加。	発動・終了を通知。強い倍率のみ適用。仲間の死亡は被弾側クールタイムを無視して死亡側ボーナスを更新。自傷・味方攻撃では被弾ボーナスを得られず、自分の死亡でも発動しません。1人では抽選なし。	被弾/死亡の範囲・しきい値・倍率・時間・間隔
Brawler	同じ敵への近接攻撃が1.25倍から命中ごとに0.25ずつ上昇し、最大2倍。銃・杖の弾・レーザーは0.75倍。	別の敵に命中、または4秒間命中しないと連撃をリセット。味方への攻撃は1.25倍のまま。車両衝突・Tumble Attack・グレネード・通常の保持物は変化しません。	近接・遠隔倍率、連撃の上昇幅・上限・猶予
Influenza	潜伏期間後に最大HPを設定値へ固定。自動くしゃみで前方の仲間へ感染し、周囲の敵にも気づかれます。通常VC・チャットでも前方の近い仲間へ感染します。感染を広げるのは発症後のみ。	感染した仲間は即座に元の役職を失ってInfluenzaとなり、潜伏期間後に発症。死亡・蘇生でタイマーはリセットせず、ステージ終了で解除。連続発話は1回扱い。敵の聴力でくしゃみの聞こえる距離が変わります。ソロ抽選なし。	潜伏・HP・くしゃみ間隔・感染距離/角度/確率・聴覚
Twins	2人の現在HP・最大HPを合算して共有。同じ貴重品の共同運搬で一時Strength（上限Lv200）と衝突損失軽減。近くで共にしゃがんで静止すると共有HPを回復し、スタミナは全回復。遠い相方へ走ると加速。共同運搬した品を2人が近くにいる状態で納品すると、品ごとに1回、ステージ予算内で価値を加算。	2人以上、固定ペア1組まで。片方の死亡で両者死亡、1回の蘇生で両者を1回分のHPで蘇生。感染で両者がInfluenzaになり共有終了。ステージ終了・切断でも解除しHP割合を維持。ペア内HP移譲・コピー不可、ショップ品は運搬強化対象外。	抽選・共同運搬・休憩・合流・納品
Porter	納品エリア外でTiny・Small・Mediumの貴重品を1人で3秒つかむと収納。重量15まで、個数制限なし。トラック・納品所・カート上で荷下ろし。満載10秒、半分で5秒。	敵からHPダメージで全収納品をばらまく。重量に比例してSpeedレベルが減少（端数切り捨て）、満載で0、荷下ろしで復元。エリア退出・被弾落下で待ち直し。死亡・役職変更・離脱・ステージ終了は全返却。購入装備は対象外。満載・収納不可・荷下ろし完了を本人に通知。	重量上限、サイズ、収納・荷下ろし時間、被弾時落下
DualWielder	近接武器を1人で持つと左0.5mに同じ武器が現れ、動きと攻撃を0.3秒遅れて再現。敵・貴重品・物体・地形・他プレイヤーにバニラのルールで命中。電池・耐久度は共有し、2本目も消費。	手放す・持ち替え・死亡・役職変更で消滅。持ち帰り不可。近接武器がなければ抽選対象外。	遅延、左への距離
Rigger	Human Adventure Cable：敵への命中ダメージ2倍、拘束時間1.5倍、命中・投げの耐久消費50％。	自動発動。対プレイヤーは変化なし。ケーブルがなければ通常抽選から除外。Standard・Cooperative・Challenge。	各倍率
Negotiator	交渉権0から開始。本人の条件達成納品で1回、指定Tierの本人討伐で1回。各ステージ1回ずつ、最大2回。次のショップで本人が商品を見せると必ず通常の値引き。拒否破損・共通回数消費なし。	トラック納品は対象外。死亡・能力喪失で全失効、同ステージ再獲得不可。ショップ退出で失効、中断は消費なし。役職・残数・/roles・入店通知。Standard/Cooperative。	抽選・運搬距離/サイズ・敵Tier
???1	???	???	???
???2	???	???	???

役職の成長・支援設定

能力の残量はスタミナ直下に縦1列で表示し、項目が多い場合は収まるよう縮小します。役職一覧には各プレイヤーの役職を表示。残量HUDを使う場合は、ホストと同じバージョンのRoleShuffleを導入してください。

能力の調整

ホストがREPOConfig → RoleShuffle → 役職名から設定。初期値は上記の能力です。保持する力・HP・感染判定には現在の値を使用します。発症時間は新しい感染から適用し、予約済みのくしゃみの時刻は維持。Stinkerの猶予は新しく出現する貴重品から適用。既存設定は保持します。

設定

REPOConfigで編集。HUD.*は本人の表示設定、それ以外はホスト設定です。複数キーの行では、省略したセクション名は最初のキーと共通です。

一般、通知、HUD

役職バランス

この表はすべてホスト設定。

Showcase役はBomber、Stinker、Mage、Gambler、Trickster、King、Rider、Influencer、Diverです。Support役はMedic、Rescuer、Mechanic、Electrician、Warden、Bodyguard、Porter、Rigger、Negotiatorです。Danger役はBomber、Stinker、Werewolf、Influenza、Hardship役はCourier、Tuna、Influenzaです。InfluencerはDanger役ではありません。これらの条件で割り当て可能な役職がなくなる場合は、全員に役職を割り当てられるまで制限を段階的に緩和します。

基礎アップグレード

使用分の保持はONにした後からです。過去の使用は復元しません。役職・基礎値に加算しますが、Lifter・Rammerの固定値とInfluenzaのHPを優先します。アイテム分はBASE UPGRADESには含めず、バニラの能力値に反映します。販売する場合はGeneral.ShopUpgradeItemCountを1以上にしてください。

この表はすべてホスト設定。

役職が上書きしない強化には基礎値を適用し、ステージ外でも維持。カンマ区切りのランレベル:設定値で指定。1:1,5:3,10:6ならレベル1～4は1、5～9は3、10以降は6です。ランレベルは1～999999。空欄や最初の指定レベルより前は0、範囲外の値は上限・下限に補正し、不正な組は無視します。基礎設定・トラック抽選ではThrowを変更しません。

トラック抽選はショップを出た後の準備中に行い、相対Weightで種類と増減値を選びます。範囲内で適用できる対象がない増減値は除外します。正の結果ではAll Upgradesも候補となり、ONの種類のうち上限まで余地があるものを強化します。結果はホストが発言し、そのラン中維持。

ROLES → 基本アップグレード → 基本アップグレード設定で、抽選全体と13項目（12種類＋All Upgrades）を切り替えます。REPOConfigと同じ値を保存し、ホストは編集、導入済み参加者はホストの設定を閲覧可能です。REPOConfigでは変更を適用してから閉じてください。Roles UIは即時保存します。

OFFの種類は次回以降の個別・一括抽選から除外し、基礎値や獲得済みボーナスは保持します。実行中の抽選は開始時の設定を使用します。個別抽選なしは重み0で、ONならAll Upgradesの対象になります。All Upgradesの抽選なしは一括抽選の重み0を示し、OFFは一括抽選だけを無効にします。全項目OFFなら抽選結果は発生しません。

手動調整はセーブごとに保持します。±で表示値が1変わり、範囲は0～200（Map Player Countは0～1）。保存対応ロビーでホストが操作します。

抽選Weightの初期値はStaminaが40、Speed・Range・Crouch Restが30、Health・Strengthが20、その他の対象アップグレードが10、ALL UPGRADESが1です。大きい値ほど選ばれやすくなります。上限に近づくほどWeightが低下し、上限ではCappedUpgradeWeightMultiplierの倍率になります。ショップの商品数の設定は影響しません。

役職の抽選設定

各通常役職にはホスト設定<役職名>.Enabled = trueと<役職名>.Weight = 100（範囲0～1000）があり、OFFまたは重み0でランダム抽選から除外します。Courierの設定名はCourierです。隠し役職は???1.Enabledと???2.Enabledで、初期値はともにtrue、重みは固定です。ON/OFFは次の抽選から適用。Twinsは役職重複なしの設定でも2人1組として抽選します。

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

この表はすべてホスト設定。

基礎アップグレードの初期値はHealthが1、ほかが0です。役職のアップグレード設定は、その役職で使用するレベルを表し、基礎値への加算ではありません。InfluencerとBerserkerは条件が変わっても元の高い強化を維持。Trackerは高い基礎強化を維持し、基礎値が高くても抽選されます。Rammerはステージ中のLaunch・Tumble Climb・Tumble Wingsを0にします。Throwには影響しません。

プレイヤー向けツール

Escまたはロビーメニュー右上のROLESから、TOOLSまたはDRAW HISTORYを選択します。

• ロールガイド： 「概要」は能力の要約、「詳細」はホスト設定の値・条件・制限を表示。「抽選状況」で自分の候補と対象外の理由を確認できます。他の人の抽選結果で変わる条件があり、必要アイテムの有無はステージ生成後に確定します。
• HUD編集： TOOLSでサンプルをドラッグし、基準位置・整列・文字／アイコンサイズ・全体倍率・表示形式・表示切替を調整します。「保存」で個人設定を保存、「取消」またはEscで破棄、「初期値」で初期状態をプレビューします。ロビーでもマウスで操作可能です。
• 不具合レポート： TOOLSからコピーまたはファイルを開き、内容と発生手順を確認してGitHub Issuesへ投稿します。MODのバージョン・設定・最近の動作状況を含み、BepInEx/RoleShuffleReportsへ保存します。自動送信はしません。
• 言語： メニューなどの表示はR.E.P.O.本体の言語に自動で合わせます。アラビア語・タイ語・地域別のスペイン語とポルトガル語を含む全21言語に対応します。ルーレットのアップグレード名は各プレイヤーの本体言語に合わせた公式名称になります。役職名・設定の識別名・コマンド・診断本文は英語です。
• 同期状態： TOOLSで役職・ガイド・Base Upgrade・履歴が最新か確認します。「表示データを再取得」は表示だけを更新し、役職や強化値を変えません。
• 抽選履歴： 完了したトラック抽選の直近50回を表示。レベル・対象・抽選値・実際の目標値の前後を記録し、変化なしや上限到達も残します。ホストのセーブに保存してMOD導入済み参加者と共有し、中断した抽選は記録しません。

HUD.FontSizeの初期値は28（範囲16～48）で、個人設定です。HUDの初期表示形式はNameOnlyです。

動的強化（<Upgrade>UpgradeScaling）はカンマ/セミコロン区切り。Influencerは最後の到達人数（0–30）、Berserkerは到達済みの最低HP境界（0–100%）を使用。重複は末尾優先、不正項目は無視。レベル0–200、MapPlayerCountのみ0–1。空欄/0は役職分の付与なしで、強いBaseは維持。初期値表の—は空欄、N/Aは設定なし。

通知とHUD

• 残量HUD： 回復・蘇生・修理・充電・賭けの残量を、スタミナの下に水色のアイコンと数字で縦1列に表示。画面に収まるよう大きさを調整し、使い切った項目は赤く表示。MODを導入している本人の生存中に表示され、HUD.ResourceHud*で調整可能です。
• CURRENT ROLESとROLE GUIDEの役職にエンブレムを表示し、HUDでも設定で表示可能です。六角形のエンブレムの外側は透過表示です。未開示の隠し役職は共通の「?」エンブレムで表示し、開示時に役職固有のエンブレムへ切り替わります。エンブレムはMOD導入済みのプレイヤーに表示されます。
• ステージ開始時、各プレイヤーは割り当てられた英語の役職名をバニラのチャット／TTSで発言します。
• RoleShuffleが生成する通知TTSでは敵が反応しません。通常のマイク入力やその他のワールド音は、Ninjaで抑止される場合を除いてバニラの動作を維持。
• Stage Flux導入時は、ステージ開始通知が重ならないようStage Flux用の通知遅延を使用します。
• Stage FluxのTTS終了後、1.5秒間の無音を確認してから役職を通知します。
• 最初の役職通知は全員で1件ずつ順番に発話します。以後の通知・応答は本人のチャット／TTSだけを待ち、別の人とは同時に発話可能です。
• Influencerの発言とInfluenzaのくしゃみは本人のメッセージを待ち、敵にも聞こえます。Diverは残り時間を15秒刻み（30、15）、残り10秒から0秒までは毎秒発話します。前の発話を中断してカウントを優先し、通常の通知を待機させます。
• ROLES一覧は初期設定で左下に名前のみを表示し、自分を固定して5秒ごとにページを切り替えます。HUD.PlayersPerPageが6以上なら多言語・アイコン付きでも6人分を確保し、6未満は設定を優先します。長いプレイヤー名は、役職名が見えるよう短く表示。表示・サイズ設定は上表を参照してください。
• Base Upgradeの抽選演出は、ホストとRoleShuffleを導入している参加者に表示されます。
• Esc／ロビー右上のROLESから開きます。EscではCURRENT ROLES、ロビーではROLE GUIDEを表示。自分の役職の概要を先頭に表示し、プレイヤーをクリックすると概要を開閉可能です。BASE UPGRADESでは共有目標・設定値・累積抽選値を確認し、参加者にはホストの値を表示。
• ROLE GUIDEでは有効な役職の説明を選択した言語で表示。マルチプレイではホストの設定値に沿った説明になります。選択言語の説明がない場合は英語で表示。シングルプレイでは自分の設定を使用します。

互換性

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

• Second ChanceをPhoenix、Rescuer、Bodyguardの復活効果より優先し、使用されなかった復活効果は維持。
• Second ChanceまたはPhoenixが失敗時のステージ移行を止めた場合、現在の役職は維持されます。
• Value SurgeまたはValue Crash中も、Mechanicは実際に失われた貴重品価値だけを修復します。
• 最初の役職通知はStage Fluxの通知を待ちます。以後は、同じプレイヤーによるStage Fluxの発話だけを待ちます。
• Enemy Purgeによる撃破ではHunterの報酬は発生しません。
• Dangerous ValuablesはEngineerが保護している貴重品へ効果を与えません。

Elite Enemy Variantsは任意の対応MODであり、RoleShuffleの必須MODではありません。

• 生存中のNinjaは、Elite Enemy Variantsの「見られていないプレイヤー」を条件とする攻撃対象から除外されます。死亡中のNinjaとその他のプレイヤーは対象のままです。
• Compatibility.EnhancedEnemyRewardsEnabledがtrueの場合、Enhanced個体から得られるVampireの回復とHunterの追加オーブがTier 3相当まで強化されます。通常のオーブ数は変わりません。
• Enhanced Gambitが捕獲後に移動しても、Gamblerのルーレット効果は正しいプレイヤーへ適用されます。
• RoleShuffleのHUDやメニューへElite Enemy Variantsの敵数、状態、撃破通知は追加しません。

ゲームプレイ上の注意

• Twinsはホストのみ導入で動作します。同時に被弾・回復したとき、共有HPへの反映量に多少の差が出る場合があります。

• Bomberが残す起動済みグレネードは、プレイヤーや貴重品にも被害を与えます。

• Mageの魔法はプレイヤーや貴重品にも被害を与えます。魔法名の大文字・小文字は問いません。ビームは視点に追従し、MOD導入側では杖を表示しません。未導入の参加者には一時的な杖が見えます。

• CourierとTunaは条件を満たしている間、実際に継続ダメージを与え、死亡する可能性があります。受けたダメージは自動回復しません。

• Medicは自身を回復しません。

• Phoenixは1ステージに1回だけ自己復活します。Rescuerは設定された回数まで、死亡した仲間の頭をつかんで復活させます。復活後HPは役職ごとに設定でき、デフォルトは25です。

• 役職の強化はステージ終了時に基礎値へ戻ります。使用分の保持がONなら、その分も加算します。Throwは残ります。

• 役職の最大HP増加が解除されると、残りHPの割合を維持して端数を切り捨てます（生存中は最低1HP）。例：300/520 → 69/120。

• すべての役職を無効化するか、すべてのWeightを0にすると、ランダム抽選できる役職がなくなります。