Enemy Health Bar
Enemy Health Bar is a Lethal Company plugin that displays enemy health in world-space UI. It does not modify host-authoritative enemy state. When both host and client have the mod installed, it can use lightweight host-authority health snapshots so clients see health values changed by host-side enemy health mods, while rebasing client-side predicted health so UI and local hit behavior stay consistent.
Features
- Displays enemy health bars above enemies, as compact side bars, or as numbers only.
- Shows current and maximum health values with configurable text formats.
- Supports adaptive maximum health handling for modded enemies that increase or reduce health.
- Supports optional host-authority health sync for host-only health multiplier environments.
- Rebases client-side predicted health from host snapshots when both sides install the mod.
- Preserves vanilla special cases for enemies whose effective health differs by state or player count.
- Keeps debug diagnostics opt-in through configuration.
- Supports live configuration reloads while the game is running.
- Provides optional LethalConfig integration when LethalConfig is installed.
- Uses localized configuration text when LC Chinese Project is detected.
Installation
Install through a Thunderstore-compatible mod manager, or manually extract the package contents into the game folder so that the DLLs are placed under:
BepInEx/plugins/EnemyHealthBar/
The package requires BepInEx for Lethal Company. LethalConfig and LC Chinese Project are optional integrations, not required dependencies.
Configuration
The plugin creates a BepInEx configuration file on first launch. Most settings can be changed while the game is running.
Important options:
DisplayMode: HorizontalBar, VerticalSideBar, or NumbersOnly.ShowHealthNumbers: shows current and maximum health text.HealthTextFormat: controls current/max, current-only, or percent-only text.MaxHealthMode: Hybrid by default. This keeps vanilla special-case handling while adapting to observed modded health values.HostAuthoritySync: enabled by default. Uses host-provided health snapshots when both host and client have this mod installed.MaxDistance: hides health bars beyond the configured range.Debug.Enabled: unlocks diagnostics and test-only visibility options.
Compatibility
- Host-authority sync works when the host and observing client both install Enemy Health Bar.
- If the host does not install the mod, clients fall back to local observation after a short handshake window.
- LethalConfig and LC Chinese Project are detected at runtime and remain optional.
Notes
- This is primarily a display mod. It does not alter host-authoritative combat, enemy AI, spawning, or enemy health.
- With host-authority sync enabled, clients may align local predicted enemy health to host snapshots to avoid client-side health drift in host-modded lobbies.
- Host-authority sync is optional and only works when both host and client have this mod installed.
- Full-health enemies are hidden by default during normal play.
- Some vanilla enemies have phase-specific or player-count-specific rules. The plugin handles these cases without runtime reflection or scene-wide searches.
License
Enemy Health Bar is licensed under GPL-3.0.
