BergenTrucker-LethalUI icon

LethalUI

[Experimental] A cleaner HUD: each part fades in only when it matters, then gets out of the way. Made for the vanilla HUD with NiceChat.

Last updated 2 days ago
Total downloads 41
Total rating 0 
Categories Tweaks & Quality Of Life Mods Client-side AI Generated
Dependency string BergenTrucker-LethalUI-0.5.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

taffyko-NiceChat-1.2.7 icon
taffyko-NiceChat

Better text chat. Chat for dead players / spectators, infinite scrolling message history, greatly increased character limit, bigger chat area, fade/hide chat when not in use, and more.

Preferred version: 1.2.7
BepInEx-BepInExPack-5.4.2305 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2305

README

LethalUI

⚠️ Experimental: work in progress. This mod is still being developed and tested. It's only on Thunderstore to make testing easier (installing and updating through a mod manager). Expect bugs and changes between versions, and settings may be renamed or removed. Not recommended for regular play yet.

For now it's only made for the vanilla HUD plus NiceChat. Other mods that change or add to the HUD (health or stamina displays, extra item slots, HUD overhauls...) haven't been tested and will likely not work well with it.

A cleaner HUD: each part fades in only when it matters, then gets out of the way.

Your hotbar shows when you switch items, health shows when you get hurt, stamina shows while you sprint, and the rest of the time the screen is just the game.

Requires NiceChat, which replaces the vanilla chat.

Features

  • Contextual HUD: each part fades in when something happens to it and fades out a few seconds later.
  • Per-part control: every part can be Contextual, AlwaysVisible (like vanilla) or Hidden.
  • HUD scale: shrink or grow the whole HUD. Each part scales toward its own screen corner, so nothing drifts into the middle of the screen.
  • Edge gap: pull the HUD in towards the screen edges, or push it away.
  • Smooth fades with adjustable speed, and an optional faint "hidden" opacity if you'd rather never lose the HUD completely.

What shows when

Part Shows when (Contextual)
Hotbar You switch, pick up or drop items
Utility slot & weight (top left) Together with the hotbar
Health You take damage or heal; always while critically injured
Stamina You sprint, and while you're out of breath
Battery You switch to, use or charge a battery item
Control tips (top right) The hints change

While stamina is showing, health also shows faintly, so you can read both at a glance.

Configuration

All settings can be changed in-game with LethalConfig, or in BepInEx/config/BurgenTrucker.LethalUI.cfg.

Section Setting Default What it does
General Enabled true Turn the whole mod on or off
General HiddenAlpha 0 Opacity of hidden parts (0 = invisible, 0.2 = faint)
General FadeDuration 0.4 Seconds to fade in or out
General HudScale 1 Size of the HUD (0.8 = 80%)
General EdgeGap 1 Space between the HUD and the screen edges (0 = flush)
Hotbar Mode Contextual
Hotbar ShowSeconds 2.5 How long the hotbar stays after a change
Hotbar UtilitySlotAndWeightMode Contextual Utility/belt slot and weight display
Health Mode Contextual
Health ShowSeconds 4 How long health stays after it changes
Health ShowOnHeal true Also show when health goes up
Health AlwaysShowWhenCritical true Keep health visible while critically injured
Health OpacityWhileStaminaShown 0.4 How visible health is while stamina shows
Stamina Mode Contextual
Stamina ShowSecondsAfterSprint 1.5 How long stamina stays after you stop sprinting
Stamina ShowWhileExhausted true Keep stamina visible while out of breath
Battery Mode Contextual
Battery ShowSeconds 2 How long the battery stays after using a battery item
Tooltips Mode Contextual The control hints in the top right
Tooltips ShowSeconds 3 How long the hints stay after they change

Every Mode can be Contextual, AlwaysVisible or Hidden.

Compatibility

  • Client-side: only you need it. Other players in the lobby don't.
  • NiceChat: required. NiceChat handles the chat; LethalUI leaves it alone.
  • LethalDeathCam: works together. While you're dead, LethalUI steps aside so the death camera can hide the HUD.
  • Other HUD mods: not supported yet. LethalUI is currently only made for the vanilla HUD (plus NiceChat). Mods that move, fade, replace or add HUD parts (health or stamina displays, extra item slots, HUD overhauls...) haven't been tested and may fight with LethalUI over the same parts. If something looks off, try setting that part's Mode to AlwaysVisible, or remove one of the two mods.

Installation

Install with a mod manager (Gale, r2modman or Thunderstore Mod Manager), or manually:

  1. Install BepInExPack and NiceChat.
  2. Put LethalUI.dll in BepInEx/plugins/.
  3. Optional: install LethalConfig to change settings in-game.

AI disclosure

Parts of this mod's code were written with the help of generative AI (Anthropic's Claude), and reviewed and tested by me in-game.