Player Status Bars
Player Status Bars is a client-side BepInEx mod for Lethal Company. It displays compact world-space status bars above other players, showing health and Cadaver Growth infection state without requiring host, server, or other players to install the mod.
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.
- 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
This mod does not add custom networking. It can only display values that the local client can read from synchronized game state.
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.
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.