Player Status Bars

Player Status Bars is a BepInEx mod for Lethal Company. It displays compact world-space status bars above other players, showing health and Cadaver Growth infection state with a low-overhead runtime model.

The mod can run from a single client using locally readable game state. When the host and clients install the same version, it also uses compact status synchronization to improve infection display consistency for observers.

Features

• Displays health and infection bars above other players.
• Excludes the local player.
• Uses a world-space UI that follows players and faces the active camera.
• Supports gameplay, spectator, and freecam visibility references.
• Hides bars by distance and, by default, while the ship is still in orbit.
• Tracks connected player slots across late joins, deaths, revives, and round transitions.
• Reads Cadaver Growth infection values directly from CadaverGrowthAI.playerInfections.
• Synchronizes client-local Cadaver Growth infection state through compact same-version status messages when multiple players have the mod installed.
• Shows infection progress from 1% to 99% with one-percent display stepping.
• Displays numeric health, smooth one-point health movement, and red low-health state.
• Predicts vanilla low-health recovery toward 20 HP when remote health values are stale.
• Includes a compatibility option for 20 HP critical-state synchronization.
• Uses direct game types, sliced player refresh, cached infection lookup, pooled bars, dirty UI updates, and cached labels to keep runtime overhead low.

Requirements

• BepInExPack
• Cadaver Growth is optional. Health display remains available when Cadaver Growth is not installed.

Installation

Install through a Thunderstore-compatible mod manager, or place the package contents into the game profile so that the DLL is located at:

BepInEx/plugins/PlayerStatusBars/PlayerStatusBars.dll

Configuration

Settings are available through the generated BepInEx configuration file:

BepInEx/config/playerstatusbars.cfg

Configurable options include:

• Enable or disable the mod.
• Maximum display distance.
• Hide status bars while the ship is in orbit.
• Head offset, UI scale, and per-bar Y offsets.
• Health and infection text visibility.
• Health, infection, and background color presets.
• Infection bar display mode.
• Critical health sync mode:
  • VanillaPrediction keeps the default vanilla-focused fallback for stale 20 HP critical-state synchronization.
  • TrustRawHealthAt20 trusts the reported 20 HP value for modded active-bleed or custom-injury behavior.
• Debug logging for status bar creation, filtering, visibility, and camera diagnostics.

Client-side Behavior

When only one player installs the mod, display accuracy is limited to the game state that client can read. When the host and clients install the same version, the mod can exchange compact status messages to improve infection display consistency for observers.

Health display combines synced raw health, synced critical or bleeding state, damage timestamp changes, and conservative vanilla recovery prediction. Infection display depends on Cadaver Growth's playerInfections data and same-version synchronization when available.

License

Player Status Bars is released under the GNU General Public License v3.0. See LICENSE for the full license text.

Third-party Notices

Player Status Bars does not bundle, redistribute, or require MoreCompany or LTC Lobby Control.

• MoreCompany is an independent MIT-licensed project. Its player-slot expansion behavior was reviewed for compatibility hardening; this project does not include MoreCompany code.
• LTC Lobby Control is an independent MIT-licensed project. Its late-join behavior was reviewed for compatibility hardening; this project does not include LTC Lobby Control code.