
LethalHUD
Quality of Life mod to improve HUD elements with config options and additional features, fixes
Date uploaded | 4 days ago |
Version | 1.2.3 |
Download link | s1ckboy-LethalHUD-1.2.3.zip |
Downloads | 456 |
Dependency string | s1ckboy-LethalHUD-1.2.3 |
This mod requires the following mods to function

BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100
AinaVT-LethalConfig
Provides an in-game config menu for players to edit their configs, and an API for other mods to use and customize their entries.
Preferred version: 1.4.6
MonoDetour-MonoDetour
Easy and convenient .NET detouring library, powered by MonoMod.RuntimeDetour.
Preferred version: 0.6.16
MonoDetour-MonoDetour_BepInEx_5
Integrates MonoDetour's logger with BepInEx and as a side effect initializes MonoDetour early. MonoDetour is an easy and convenient .NET detouring library, powered by MonoMod.RuntimeDetour.
Preferred version: 0.6.16README
LethalHUD
Built around LethalConfig, with support for runtime changes — everything can be changed mid-game. Config is fully local, meaning if you reimport someones profile your config won't be overridden. NOW You can change it from local to global in your modmanager there is going to be another config BUT you will need to restart the game to switch around.
Requires MonoDetour. Multiplayer sync may be added in the future. (Currently is client-sided)
Request features in the modding Discord — if it’s possible, I’ll probably add it.
✨ Features
🎨 General HUD Recoloring
- MainColor – unify the color of all HUD elements
- Local/Global - seperate config file, change the way your config works:
- global: this option is for regular players - anyone who doesnt want their config to be overridden by reimporting someone modpack, it works cross modpacks (config file in:
\AppData\LocalLow\ZeekerssRBLX\Lethal Company\LethalHUD
) - local: this option is for modpack creators and people who want to use others setup
- global: this option is for regular players - anyone who doesnt want their config to be overridden by reimporting someone modpack, it works cross modpacks (config file in:
🔍 Scanning
- Hold Scan Button – toggle scanning while holding the button
- FadeOut – smooth scan effect ending (fixes abrupt cutoff)
- ScanColor – change the main scan effect color
- RecolorScanLines – automatically recolor scanlines to a complementary color
- Scanline Type – pick from a list of custom scanline textures (currently placeholders)
- Scanline Intensity – fine-tune scanline visibility (-500 → +500, clamped to non-negative)
- Scan Alpha – adjust scan effect transparency
- Vignette Intensity – tweak vignette darkness
- ScanNode Fadeaway – nodes fade over time (configurable lifetime & fade speed, compatible with GoodItemScan)
- ScanNode Shape - choose a different scannode shape (current versions are pretty much just testing subjects)
🧍 Inventory & Player Indicators
- FrameColor – recolor inventory slot frames
- RainbowFrames – choose from preset rainbow gradients
- GradientColorA / GradientColorB – create your own animated gradient frames
- HandsFull Text Color – customize the color of the “Hands Full” message
- HP Indicator – display player health with:
- Opt-in/out toggle
- Start color tied to inventory slot
- Adjustable X/Y position
- Weight Counter – show carry weight
- Starter color option: fades from bright red → dark red as weight increases
- Sprint Meter Coloring – three styles:
- Solid – single static color
- Gradient – hue shifts while sprinting
- Shades – darkens with sprint use (or lightens if already dark, then turns red)
- Show Item Value - display value per inventory slot
- Show Total Inventory Value - display total value in inventory
- TotalPrefix - Change the prefix from Total Value to Total to only showing the number
- ShowTotalDelta - displays (+ , -) numbers
- ChangeCurrency - from default blocky credit to dollar sign
- TotalValueOffsets X/Y positions
💬 Chat & Name Colors
- NameColor – recolor your own name in chat
- NameColorMode – pick presets (same as RainbowFrames)
- Chat Input UI Recoloring:
- Typing indicator (“Typing…”) – uses inventory slot colors
- Placeholder text (“Press…”) – uses same colors
- Chat caret (| cursor) – uses same colors
- Unsent input text – has its own config option
- Chat frame – matches inventory slot style
- Future Plans:
- Sync name colors across clients (so others see your chosen name color)
- Nameplate recolors above heads
🧭 Compass
- Compass Recolor – compass matches inventory slot colors (supports presets and gradients)
- CompassInvertMask – invert inside section
- CompassInvertOutsides – invert outer ring
- CompassAlpha – adjust transparency
Tip: inverting both + alpha = 0 makes full compass visible)
📊 QoL
- FPS & Ping & Seed displays – toggle between horizontal or vertical layout, with configurable X/Y position, has its own coloring option (Ping is WIP)
- Toggle HUD – press NUMPAD 5 to hide all HUD elements
- Compat recolor for EladsHUD
- Stamina bar works with all three config options
- Healthbar works the same way as the this mod's text version
- Healthbar background box uses
Main Color
- Weight uses the same logic, but for manuls asciis are gone
🛠️ Planned Features
- Sync chat name colors across clients
- Recolor player nameplates above heads
- Beltbag UI recolor
- More HUD QoL tweaks
🙌 Credits
- Niro for creating ScanRecolor per my request and letting me continue it
- Xu Xiolan for helping out with inventoryslots and with GoodItemScan compatibility
- Zehs for helping out with global configs
- mrov for giving me some basic informations about transpilers
- Hamunii for MonoDetour and giving me some pointers on how to use it
☕ Support
If you’d like to support me or just want to see upcoming mods for Lethal Company or R.E.P.O:
CHANGELOG
v1.2.5
- Fixed missing descriptions on clock configs
- Changed from patching
DestroyItemInSlotAndSync
toDestroyItemInSlot
- this way it should properly remove the scrapvalues when you interact with stuff
v1.2.4
- ImprovedClock merge
- 24HourClock config option
- ClockFormat config option (Regular or Compact - Compact basically being LCBetterClock, not entirely just the format without the dark first 0 and probably some other stuff dunno)
- RealtimeClock config option
- ClockSizeMultiplier config option
- ClockNumberColor config option
- ClockBoxColor config option
- ClockIconColor config option
- ClockShipLeaveColor config option
- ShowClockInShip config option
- ClockVisibilityInShip config option
- ShowClockInside config option
- ClockVisibilityInside config option
- Added two patches to fix names not having digits, underscore or dot
Older versions
v1.2.3
- HOTFIX: left out a null-check for my HP display (EladHUDs compat stuff or any other HUDmods that would rework UI elements completely)
v1.2.2
- SOME CONFIGS WILL BE RESET UNFORTUNATELY, SORRY I HAD TO REFORMAT SOME THINGS
- Fixed HP Indicator enable / disable config not changing mid-game
- Fixed ScrapValueDisplay not disappearing when you put items in ShipInventory
- Added Health Format config option (plain, percent, label) - they change in base size to fit in well
- Added Health Size config option
- Added Health Rotation config option (also changed its base rotation)
- Added ChatMessageColor (solid)
- Added Gradient Message Color A and B
- Changed Health Positions X and Y base numbers
- Switched from transpiler to just a postfix for AddChatMessage function, will probably mess with this a few more times in the future, not important for players
v1.2.1
- Fixed EladHUDProxy not working on reload
- Fixed Sprintmeter sometimes fail to load in with your colors (only affected clients)
- Fixed Weightcounter sometimes fail to load in with your colors (only affected clients)
- Fixed ScrapValueDisplay not resetting when something makes you drop all of your items (numbers were lingering around until you scrolled thru your inventory / picked stuff back up)
- Added SeedDisplay in the Misc section
v1.2.0
- Hopefully made it so you can now set the config up as local with another config - you need to restart the game for it change
- Added ChatInputText config option and changed some logic in it
- Added EladsHUD compatibility
- stamina works with all three config options
- healthbar works the same way as my text version
- healthbar background box uses
Main Color
- carrytext again uses the same logic as mine, so you can have kgs, manuls, recolor em.. but manuls wont have asciis
- MiscToolsColor config - change color for fps and ping counter (reminder: ping is still not finished, it will only show 0ms)
- Added 2 new scannode shapes, you can now change scannode shapes (they were mostly made for testing purposes, I'd like to make a bit better choices
- Hopefully fixed rotation issues with the value displays and made sure the mod works well with hotbarplus
- Reparented total value text
- Added config options to change its position
- Added config option to remove delta info (+, - numbers)
- Added config option to change how the total value is shown (Total Value: number, Total: number, or only the number)
v1.1.6
- HOTFIX: on spawn these texts empty out
v1.1.5
- Fixed issues with the Scrap Value Display
- Added total amount counter and a config option to enable it
- Added color logic to the indicators (highest valued scrap = green, lowest = greyish white
- Fixed HandsFull text coloring
- Changed position for the value indicators
v1.1.4
- ScrapValueDisplay added
- Config option to turn it on / off
- Config option to switch it from the blocky credit to dollar sign
- Readme update (still no gifs...)
v1.1.3
- CompassInvertMask config option to invert the inside part of the compass
- CompassInvertOutsides config option to invert the outside part of the compass
- CompassAlpha config option to make it less visible
- if you invert outside, inside and set alpha to 0 the whole thing is visible, should be obvious but thought I'd still mention
- FPS and Ping counter reworked (kinda just switched from GUIStyle to just simple TextMeshProUGUI)
- Also reparented it to the ingamehud, because now we have a hide hud elements button with numpad5
- They also have two options in the config now
Horizontal
orVertical
and they are seperated by─────────
or|
. - Still no gifs in readme, I'll get to it someday lol.
v1.1.2
- Hp reparented to a different gameobject (so it hides when you die, get left behind etc or it fades in the background when you interact with the terminal stuff like that)
v1.1.1
- HOTFIX: Just noticed that scannodes linger around when you turn away (GoodItemScan patches that part too so I had to do a small adjustment in my code to work well with that)
v1.1.0
- Added the other
MonoDetour
as dependency as well on thunderstore to avoid confusion - Added compatibility to
BetterScanVision
, now its light takes on the chosen scancolor from this mod - Fixed the
GoodItemScan
compat issues (the toggle option is fine now, and the fadeaway also should work nicely when GIS is present)
v1.0.9
- Fixed a nice chat error for clients
- Added HP Indicator and 4 config options for it
- Enable / Disable it
- Recolor it to the inventory slot colors
- Change X and Y positions
- HP Indicator starts with green color by default and then at 20 it goes bright red, under 20 (critical) its dark red and also shakes whenever you get hit or are under 20 hp (slowly stops as you heal back up)
- Still no gifs in readme, I'll get to it soon I promise
v1.0.8
- Added ScanNode fadeaway (with two config entries for lifetime and fadeaway) - Compatible with GoodItemScan ^^
v1.0.7
- Added Sprint and Weight boolean config option to toggle them on or off (basically a compat for PlayerHUDTweaks)
- Added compat for NiceChat (no more errorspam + it also recolors their chatframe)
v1.0.6
- Sprintmeter configs -> 3 new configs: Solid, Gradient, Shades
- Solid for just a simple color change
- Gradient that changes hue value
- Shades that go into a darker color BUT if its a dark color to begin with, it will go a bit lighter and then red
- [This should be working but in fact does not lol, so uhm ignore this] Modified chat transpiler and now we have slot colored default chat (xyz joined the game will now be colored the same way you set your inventory colors (doesnt work with rainbow stuff))
- Finally added chatframe to the inventoryslot's image array
- Added fps and ping counters - you can enable each seperately, change their position together (FPS is above ping so keep that in mind)
- Removed
Circlegon
scanline - Changed
Circles
andHexagons
scanlines (still not happy with circles but hexagons looks pretty nice now imo) - Added
Noisy
,Scifi
,Circuits
scanlines (noisy and scifi look really good imo, ciruit looks a bit iffy, but it is what it is) - Added
MonoDetour
as a dependency - Added weight selections and starter color - basically the heavier the carryweight gets the color of the weightcounter turns bright red and then dark red
v1.0.5
- Removed preset config option from chatcolors
- Changed how gradients work, they look nicer imo this way -> you have two config options for gradientA and B (if you reset both of them then the solid color config will be present, which to be fair feels a bit redundant right now but I'll leave it in for now.)
- ChatIndicator when player is typing is now taking inventoryslots color
- HandsFull text now has its own color config
- Chat placeholder, chatcaret are taking on the inventoryslots color and inputtext is using the complimentary color for those so its actually visible what you're typing ^^
v1.0.4
- Added LethalConfig as a soft dependency
- Added LethalConfig as a dependency on thunderstore (since its basically a necessity for this mod)
- Added GlobalConfig <- if you sync up to someones profile, your setup wont get overridden
- Added Custom color for chatnames (currently its clientsided, in the future I'd like to make it effect only your name and then sync up others' chosen colors to their own name)
- ColoredNames to toggle seeing others chosen colors <- this isnt in effect yet, will be done in the future, LocalNameColor <- currently changes everyones name, NameColorMode - same as inventory slots you can choose a preset for custom colors
v1.0.3
- Fixed alpha not changing when fadeout config is not toggled (oopsie)
- Fixed default invenotry slots color (oopsie, I based it off scancolor but its much less vibrant blue)
- Changed main color settingchanged behaviour -> if you reset it's color, now it actually resets both ScanColor and SlotColor
- Added rainbow slot color list config option (none <- default, rainbow, winter, summer, vaporwave, deepmint, radioactive, tideember)
- Removed randomcolor (might come back later idk)
- Added two strings as config options if you'd want to do custom wavy gradient for your inventory slots
- Compass recolor tied to slotcolor - works with custom wavy gradient, or any of the rainbow frames
v1.0.2
- InventorySlots recoloring
- "Main Color" global config option - you can override this with ScanColor and SlotColor as well but unify them back together if you'd like to
- Modified base intensity for custom scanlines because they were too invisible (you can do -58 for the config option to go back down to 42)
v1.0.1
- Added more info in README
- Fixed a small issue with apperantly Emblem naming their assetbundle the same way so I just renamed it with a very original name