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.

Changelog

0.0.2

• Added optional host-authority health sync for lobbies where host-side mods change enemy health values.
• Added client-side prediction rebasing from host snapshots to keep synced health display and local hit behavior aligned in host-modded lobbies.
• Added spawn-settle suppression to avoid briefly showing temporary vanilla health before host-side health changes apply.
• Added client fallback handling for alive enemies whose local predicted health reaches zero before host death confirmation.
• Improved adaptive maximum health handling for enemies with increased or reduced health values.
• Improved vanilla special-case handling for Butler, Maneater, and Masked enemies.

0.0.1

• Added client-side enemy health bars for Lethal Company.
• Added horizontal bar, side vertical bar, and numbers-only display modes.
• Added current/max, current-only, and percent-only health text formats.
• Added adaptive maximum health handling for observed enemy health values.
• Added live BepInEx configuration reloads.
• Added optional LethalConfig integration.
• Added optional Chinese configuration text when LC Chinese Project is detected.
• Added opt-in debug diagnostics and a test health bar.