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

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. Melee weapon damage is multiplied by 1.1.

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.

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

2.8.11

• Brawler melee combo: 1.1x / 1.2x / 1.3x, three seconds between hits, then repeat. Host-managed for unmodded guests.

2.8.10

• Brawler: tumble-hit stun duration increased from 1 to 2 seconds.
• Medic: default RevivesPerStage is now 2. Existing cfg settings are preserved.
• Verified the supplied game uses base 5 self-damage for tumble hits; Brawler retains this native behavior.

2.8.9

• Burger: instant and periodic healing costs can now cause normal death at 0 HP. Removed the 1 HP floor.

Changelog

2.8.8

• Fixed Backspace/CLEAR removing the selected role holder instead of the highlighted player. Host selection now removes the host's Guest-Role assignment without clearing a guest.
• Renamed the button to CLEAR PLAYER ROLE. An unassigned or departed target cannot remove another player's role. Mouse requests retain the clicked player ID across roster refreshes.
• Uses existing role cleanup and preserves spent stage budgets.
• Updated plugin and manifest versions to 2.8.8.

2.8.6

• Added the Burger illustration to the role introductions and moved its detailed description into that section.
• Documentation-only update; plugin DLL remains 2.8.5.

2.8.5

• Brawler successful tumble attacks now apply a 1-second vanilla stun to eligible enemies, including heavy enemies.
• Vanilla stun immunity is respected, and longer existing stuns are not shortened. Other attacks do not receive this added stun.
• Host-side processing supports guests without the mod. Tumble damage 30, Tumble Launch +1 and melee damage 1.1x are retained.

2.8.4

• Burger instant 50 HP healing now has one shared use per stage. Regrabbing or role reassignment cannot refill it.
• Periodic healing, nonlethal HP costs and death-head healing remain unchanged.

2.8.3

• Burger now grants Death Head Battery up to upgrade level 30 using vanilla synchronization; guests still need no mod.
• Conscious death-head healing restores up to 3 HP every 1 second.
• The instant 50 HP heal, living 10 HP/second healing and nonlethal HP costs are retained.
• Battery charging and depletion follow the vanilla upgrade behavior; no forced full charge on death.

2.8.2

• Burger living periodic healing now restores 10 HP for a shared 3 HP cost every 1 second. Conscious death-head healing remains every 1.5 seconds.

2.8.1

• Burger instantly heals each new eligible holder by up to 50 HP at a 15 HP cost. Release and regrab to retrigger.
• All Burger healing costs now stop at 1 HP, including the periodic 3 HP cost.
• Full-health allies do not consume Burger HP.

2.8.0

• Added host-assigned Burger role, usable by unmodded guests.
• Both Burger head cosmetics are required: tumble + Expression4 enables held-ally healing (10 HP per 1.5s for a shared 3 HP cost); held conscious death heads heal 1 HP per 1.5s.
• Burger grants a temporary Death Head Battery bonus up to level 15, preserving purchased upgrades.
• Expanded the compact F8 panel to six roles; retained role exclusivity, TTS and 2.7.4 defaults.

2.7.4

• Changed default Bird flight speed to 4 and upward angle to 30 degrees.
• Disabled Tank diagnostic logging by default.
• Existing configuration values are preserved.
• Updated plugin DLL to 2.7.4.

2.7.3

• Fixed the Tank illustration URL after the image file was renamed.
• Documentation-only update; plugin DLL remains 2.7.1.

2.7.2

• Added five role illustrations hosted on the creator's public GitHub repository.
• Updated the package icon.
• Added Japanese creator attribution.
• Documentation/assets-only update; plugin DLL remains 2.7.1.

2.7.1

• First Thunderstore-ready distribution of the existing 2.7.1 build.
• Compact role panel at 50% of the previous width and height.
• Foreground pointer visible over the panel.
• Tank tab rendering avoids whole-word automatic translation.
• MeleeSpecialist renamed to Brawler in the UI and role announcement.
• Role abilities and configuration retained.

Brawler combo lockout: additional hits within 0.2 seconds keep the same multiplier and do not refresh either timer. Advancement resumes at 0.2 seconds.