UI

A BepInEx mod for R.E.P.O. that adds a clean two-panel Tab overlay showing your Improve level, map value, combat/tumble stats, and a live player list.

What This Mod Does

Hold Tab during gameplay to see two compact panels on the right side of your screen, positioned to stay clear of the game's own HUD:

• Top-right — Info — sits just below the game's HUD: Improve level, map value, and combat/tumble stats.
• Bottom-right — Players — a live player list that grows upward as more players join, so it never collides with the info panel.

Map Level and Haul are intentionally not shown — the game already displays these natively in the Tab menu and top-right HUD.

Improve Level

• Improve Level — your current Improve mod level (requires Improve).

Map Value

Tracks the total remaining dollar value of all valuable items on the current map. Updates in real time as items are broken, destroyed, or extracted.

Combat

Displays real-time combat information:

• Held weapon — name, ammo bars, and damage when holding a gun (supports bullet-based and laser guns).
• Tumble launch damage — shows your tumble damage including scaling from Increase Tumble Damage upgrades and Improve stat points (requires Character Stats).

Player List

Lists all connected players with their current status:

• Alive (green)
• Dead (red)

With Other Mods Installed

The overlay only shows the sections it has data for. Install Improve and an Improve Level line appears; add Increase Tumble Damage and the Tumble Launch value scales with your upgrades.

Top row adds the Improve Level line; bottom row shows Tumble Launch scaled by Increase Tumble Damage (15 → 82 dmg with five upgrades).

Usage

Just hold Tab (the map key) during any level. The overlay appears on the right side of your screen and disappears when you release Tab.

The overlay also shows when the map is toggled open.

Requirements

• BepInEx 5.x installed for R.E.P.O.

Optional (soft dependencies)

• Improve — enables the Improve Level display.
• Increase Tumble Damage — enables tumble damage scaling display.
• Character Stats — provides accurate upgrade levels from all mods for combat info.

The UI mod works without any of the above — those sections are simply hidden when the corresponding mod isn't installed.

Installation

1. Install via Thunderstore (recommended).
2. Or manually: place UI.dll into your BepInEx/plugins folder.
3. Launch the game — no configuration needed.

Multiplayer

• The overlay runs per-client — shows data available to your game client.
• Player list shows all connected players and their alive/dead status.
• Map value tracking works the same in multiplayer.

Changelog

v1.2.0

• Two-panel layout — an info panel (top-right, just below the game HUD) and a player list (bottom-right) that grows upward as players join, so the overlay never collides with the game's UI.
• Removed the Map Level and Haul sections — the game now shows these natively in the Tab menu.
• Simplified the Improve section to a single Improve Level line (removed Available Points).
• Smaller fonts and tighter spacing for a more compact overlay.
• Tumble launch damage now reflects live upgrade levels (via the Character Stats fix).

v1.1.0

• Added combat section — shows held weapon name, ammo, and damage.
• Gun damage reads from bullet prefab (bullet-based guns) and laser component (laser guns).
• Gun detection works for guns held in hand via PhysGrabber and scene-wide grabbedLocal fallback.
• Added Improve Level and available points display (soft dependency).
• Added tumble launch damage display with scaling from Increase Tumble Damage and Improve mods.
• Uses Character Stats API for accurate upgrade levels across all mods.
• All mod integrations are soft dependencies — UI loads and works without them.
• Reduced spacing between overlay sections for a more compact layout.

v1.0.0

• Initial release with map level, map value, haul progress, and player list.

Development

Project Structure

├── HeadclefUI.cs                   # Plugin entry point
├── MapValueTracker.cs              # Tracks remaining valuable item values
├── TabOverlay.cs                   # Tab overlay panels — rendering & input
└── README.md

Building

This project is part of the Repo.slnx solution and references Character Stats / Improve / Increase Tumble Damage at compile time. Build the whole solution so dependencies build in the correct order:

dotnet build ../Repo.slnx

License

This project is licensed under the MIT License — see the LICENSE file for details.