Guest-Role

Created by a Japanese mod creator. / 日本人制作者によるMODです。

Host-assigned roles for R.E.P.O. multiplayer. The host selects a player and a role with F8. Guests do not need this mod installed.

Roles

Role	Abilities
Medic	Automatically revive the nearest fallen teammate within 3 m at 25 HP (capped by maximum HP), once per stage by default. Hold the expression bound to 7 to heal nearby allies within 5 m: 5 HP every 2 seconds, with a shared 100 HP stage budget by default.
Mechanic	Directly hold a damaged valuable while holding 7 / Expression3 to repair 2% of its original value per second, with a 50% stage budget. Also suppresses supported valuable effects while holding them.
Tank	Base maximum HP of 200 plus health upgrades. Covers enemy damage to allies within 5 m, taking the transferred damage with 15% resistance. Transferred damage cannot lower Tank HP below 1; cover stops at 1 HP.
Bird	One bonus extra-jump upgrade, Wings level 10 by default, fall-damage protection excluding pits, and easier air steering. Tumble in midair and move forward for limited camera-directed flight with a configurable upward angle.
Brawler	One bonus Tumble Launch upgrade, 30 tumble attack damage and a 1-second stun on successful tumble hits against eligible enemies, plus 1.1x melee weapon damage to enemies.
Burger	Requires both vanilla Burger head meshes. While tumbling with eyes closed (8 / Expression4), once per stage, a new holder instantly receives up to 50 HP at a 15 HP cost, then receive 10 HP every 1 second at a shared 3 HP cost. These costs stop at 1 HP. Death Head Battery level 30; holding Burger’s conscious death head heals 3 HP every 1 second.

One player can have one role at a time, and each role has one assigned player. Assigning another role replaces that player's previous role. Reassignment does not refill spent stage budgets. Role assignment requests a vanilla TTS announcement from the selected player.

Role illustrations / 役職紹介

Illustrations explain the roles; cosmetic skins shown are not included in this mod. / 画像は役職のイメージです。掲載された衣装・スキンを追加するMODではありません。

Medic

Default: 5 HP every 2 seconds within 5 m, 100 HP shared per stage. Auto-revive within 3 m at 25 HP, capped by maximum HP, once per stage. Limits are configurable.

Mechanic

Hold 7 / Expression3 while directly holding a valuable: repair 2% per second, 50% per stage. Supported effect suppression remains automatic.

Tank

Base maximum HP 200 plus upgrades, 15% damage resistance. Cover applies to enemy damage only; transferred damage cannot lower Tank HP below 1.

Bird

One extra jump upgrade, Wings level 10 by default (the native upgrade has no fixed maximum), limited flight and fall-damage protection excluding pits.

Brawler

One bonus Tumble Launch upgrade. Tumble attack damage is set to 30, not a dynamic 2x multiplier. Successful tumble hits apply a 1-second stun to eligible enemies, including heavy enemies. Vanilla stun immunity still applies, and longer existing stuns are not shortened. Melee weapon damage is multiplied by 1.1; this added stun applies only to tumble attacks. Guests do not need the mod.

Burger

Equip both Burger Head Top Mesh and Burger Head Bottom Mesh. The host must assign the Burger role with F8; wearing the cosmetics alone does not grant it.

• Instant heal: while both cosmetics, tumbling and closed eyes are already active, a new holder receives up to 50 HP immediately at a 15 HP cost to Burger. Once total per stage; regrabbing, changing holders or reassigning the role does not restore this use. Full-health holders do not spend the use. Toggling the expression while continuously holding does not retrigger it.
• Alive: tumble and maintain the closed-eye expression (8 / Expression4 by default) while an ally directly grabs you. Every 1 second, each injured holder receives up to 10 HP and you spend 3 HP once per shared pulse.
• Battery: the role raises Death Head Battery to level 30 while both cosmetics are equipped; higher purchased levels are preserved. Removing the role or outfit removes only the temporary bonus.
• Dead: only while you are consciously controlling your death head, allies directly holding it receive up to 3 HP every 1 second. No expression input is required, but both Burger cosmetics must still be equipped.
• Healing cannot exceed maximum HP. No HP is spent if all holders are at full health. Periodic healing uses a 1-second interval while alive and 1 second for the conscious death head; losing the conditions resets the timer. Periodic healing has no per-stage usage cap.
• Both the instant 15 HP cost and periodic 3 HP cost bypass damage resistance/invulnerability but cannot reduce Burger below 1 HP. Healing remains usable at 1 HP.
• Guests use their own binding for Expression4. Hold-mode expressions are recommended. Carrying a cart containing the head does not count as directly grabbing it.

Controls

• F8: open or close the host panel.
• Click a role, click a player, then click ASSIGN.
• Left/Right: choose a role. Up/Down: choose a player. Enter: assign.
• CLEAR / Backspace: remove the holder of the currently selected role, regardless of which player row is highlighted.
• Esc / X: close the panel.

The panel does not pause the multiplayer game. Host gameplay input is suppressed while it is open.

Installation

Install with Thunderstore Mod Manager. Required dependencies are BepInExPack and REPOLib. RoleShuffle is optional and is not required.

For manual installation, install the dependencies and place Guest-Role.dll inside BepInEx/plugins/Guest-Role/.

If upgrading from a manually installed copy, remove the old DLL before installing this package to avoid duplicates. Do not run the old Guest-Medic / GuestHealthPackGrant DLL alongside this mod. Keep your existing configuration.

Configuration

Run the game once to generate BepInEx/config/Guest-Role.cfg. Close the game before editing it.

Section / key	Default	Meaning
General / Enabled	true	Enable role benefits.
Diagnostics / TankLogging	false	Enable Tank diagnostic logging.
Controls / HostMenuKey	F8	Host panel key.
Medic / HealingHotkey	7	Vanilla expression digit: 5, 6, 7, 8, 9, 0; -1 disables healing.
Medic / HealingLimitPerStage	100	Total HP healed per stage across recipients.
Medic / RevivesPerStage	1	Revival allowance per stage.
Revival / HealthAfterRevive	25	Revival HP, capped by the revived player's maximum.
Bird / FlightDurationSeconds	3.5	Flight duration.
Bird / FlightSpeed	4	Flight speed.
Bird / FlightUpwardAngleDegrees	30	Upward angle relative to camera direction.

For unmodded guests, expression activation follows their own binding for the corresponding vanilla expression. Hold-mode expressions are recommended. Medic healing is suppressed while holding a boombox.

Notes

• Multiplayer host installation is required. Installing this mod only as a guest does not grant roles. Single-player is not supported by this build.
• Tank cover targets enemy damage, not every damage source. Lethal covered hits can involve corrective revival.
• Mechanic repairs directly held valuables, not the contents of a held cart. Effect suppression only supports compatible valuable types.
• RoleShuffle has optional compatibility handling, but arbitrary mod combinations are not guaranteed.
• Version 2.7.1 includes the compact panel, foreground pointer and Brawler name. Its UI was confirmed working by the requesting user. Automated checks do not replace multiplayer testing for every ability or mod combination.

日本語

ホストがF8画面でプレイヤーと役職を選んで付与するMODです。ゲスト側の導入は不要です。

• Medic：近くのデスヘッドを自動蘇生。7キーの表情を維持すると周囲の味方を回復。
• Mechanic：貴重品を直接つかみ、7キーの表情を維持して修理。対応する貴重品の特殊効果も抑制。
• Tank：基本最大HP200。5m以内の味方への敵由来ダメージを肩代わり。15%軽減を持ち、肩代わりだけではHP1未満になりません。
• Bird：追加ジャンプ・タンブル飛行・落下ダメージ保護（奈落を除く）。
• Brawler：タンブルアップグレード+1、タンブル攻撃30ダメージ。タンブル攻撃の命中時、対象の敵に1秒間のスタンを付与します。重量級も対象ですが、標準のスタン無効条件に従い、すでに残っている長いスタンは短縮しません。近接武器ダメージは1.1倍（今回の追加スタンはタンブル攻撃のみ）。ゲスト側のMOD導入は不要です。
• Burger：条件を満たしている状態でつかんだ瞬間、1ステージにつき合計1回だけ味方を最大50HP回復して自身は15HP消費（HP1で止まります）。頭の上下ともハンバーガーを装着した場合のみ有効。タンブル＋8キーで閉眼中につかんだ味方を1秒ごとに10HP回復し、自身は3HP消費（HP1で止まります）。デスヘッドバッテリーはレベル30相当。自身がデスヘッドに意識を入れている間のみ、直接つかんだ味方は1秒ごとに3HP回復。最大HPまで。複数人を同時に回復しても自身の消費は1回につき3HPです。

1人1役職です。役職とプレイヤーをクリックしてASSIGNで付与します。CLEARは選択中の役職の担当者を解除します。設定はGuest-Role.cfgで変更できます。