SimpleHUD

Current version: 2.0.0

English Introduction

SimpleHUD is a client-side BepInEx 5 mod for Lethal Company that turns your vital stats into clean numeric readouts on the HUD. It shows health (XX HP), stamina (XX% SP), carry weight (XX lb), held-item battery (XX%), oxygen (XX O2), fear (XX Fear) and infection (XX% infected) as plain numbers, replacing or complementing the vanilla bars with precise values.

• Health & stamina: health shifts from green to red as it drops; stamina is bright yellow when full and fades through gray to black when depleted.
• Carry weight: kept in sync with the vanilla weight counter.
• Battery percentage: appears while holding a battery-powered item (flashlight, walkie-talkie, zap gun, etc.), reusing the vanilla battery source.
• Oxygen: computed from StartOfRound.drowningTimer (same data source as the OxygenDisplay mod — install it as a prerequisite). The line turns red below 30% oxygen and can be limited to underwater only.
• Fear: displayed from the player's fear level; turns red at or above 60%.
• Infection: reads the infection value from the InfectionHUD mod (install it as a prerequisite) and prints it as XX% infected.
• EnvironmentSimulation: a master toggle that forces all SimpleHUD lines to display regardless of hiding logic (death, oxygen conditions, etc.). It has no other effect — it only controls whether this mod's HUD is shown.
• Hide vanilla elements individually: the vanilla health bar, stamina bar, battery icons and weight counter can each be hidden independently via HideVanillaHUDSetting, controlled by the HideVanillaHUD master switch (toolbar / hotbar always stays visible).
• Per-line hide toggles: HideHealth / HideStamina / HideWeight / HideBattery / HideFear / HideInfection / HideOxygen let you show or hide each SimpleHUD line independently.
• Fully customizable: position offsets, font size, line gap and per-line colors (health, stamina, weight, battery, oxygen, fear) are all configurable.
• Optional fade-out: with AlwaysShowNumbers = false, a health/stamina value at 100 fades out over 5 seconds and returns as soon as it drops below 100 (weight and battery never fade).
• Host-shared visibility sync (v2.0.0): SyncHostConfig and HostShareConfig (both default ON). When both are enabled, this client automatically applies the host's Hide* visibility toggles — state only (ON/OFF); colors and other visual details are NOT synced. A client can disable SyncHostConfig to ignore the host config entirely. The sole purpose of these two features is to prevent other behaviors from tampering with the config file (host-authoritative visibility).
• Client-side Mode (v2.0.0): ClientSideMode (default ON). When enabled, vanilla (unmodded) players are allowed to join this room. When disabled, clients without this mod are blocked from joining and see the message "You cannot join a non-vanilla room.".

Installation

No compilation needed — just drop the pre-built SimpleHUD.dll into BepInEx/plugins/SimpleHUD/ and start the game. Requires BepInExPack 5.4.2305 or later. The oxygen line additionally requires the OxygenDisplay mod; the infection line requires the InfectionHUD mod (both optional, only for those features).

中文介绍 (Chinese)

SimpleHUD 是一个面向《Lethal Company》的 客户端 BepInEx 5 模组，用清晰的数字替代/补充原版 HUD，实时显示生命值（XX HP）、耐力（XX% SP）、负重（XX lb）、手持物品电量（XX%）、氧气（XX O2）、恐惧值（XX Fear）与感染值（XX% infected）。

• 生命与耐力：生命值随血量下降由绿变红；耐力满时亮黄，耗尽时渐变为灰黑。
• 负重：与原版负重计数保持同步。
• 电量：手持带电物品（手电、对讲机、电击枪等）时显示，复用原版电量数据源。
• 氧气：读取 StartOfRound.drowningTimer（与 OxygenDisplay 模组同一数据源，需安装该前置模组）；低于 30% 时变红，可设置为仅在水下显示。
• 恐惧：显示玩家恐惧值，达到 60% 及以上时变红。
• 感染：读取 InfectionHUD 模组的感染值并显示为 XX% infected（需安装该前置模组）。
• 环境模拟（EnvironmentSimulation）：总开关，开启后强制显示本模组全部 SimpleHUD 数字行，无视其他隐藏逻辑；它没有任何其他作用，仅控制本模组 HUD 是否显示。
• 逐项隐藏原版元素：通过 VanillaHUDSetting 分段下的 HideVanillaHUD 总开关，可分别隐藏原版血条、耐力条、电池图标与负重文字（物品工具栏/热键栏始终保留）。
• 逐行显隐开关：HideHealth / HideStamina / HideWeight / HideBattery / HideFear / HideInfection / HideOxygen 可单独控制每行数字的显示与隐藏。
• 高度自定义：位置偏移、字号、行间距与逐行颜色（生命/耐力/负重/电量/氧气/恐惧）均可配置。
• 可选淡出：AlwaysShowNumbers = false 时，达到 100 的生命/耐力数字会在 5 秒内淡出，数值低于 100 时立即恢复（负重与电量不会淡出）。
• 主机共享显隐同步（v2.0.0）：SyncHostConfig 与 HostShareConfig（均默认开启）。两者同时开启时，本机自动应用主机的 Hide* 显隐开关——仅同步开启/关闭状态，不影响颜色等显示细节；客机关闭 SyncHostConfig 则完全忽略主机配置。两个功能的用意仅为防止部分行为篡改配置文件（主机权威显隐）。
• 客户端模式（Client-side Mode，v2.0.0）：ClientSideMode（默认启用）。启用时允许原版（未安装本模组）玩家进入本房间；关闭时若客机未安装本模组，则禁止其进入并提示英文提示语 "You cannot join a non-vanilla room."。

安装方式

无需自行编译，直接将预编译的 SimpleHUD.dll 放入 BepInEx/plugins/SimpleHUD/ 后启动游戏即可。需要 BepInExPack 5.4.2305 或更高版本。氧气显示需额外安装 OxygenDisplay 模组，感染显示需额外安装 InfectionHUD 模组（均为可选前置，仅对应功能需要）。

Changelog