LethalHUDMessages
HUD overlay notifications for deaths, monster encounters, and game events. No chat spam.
| Last updated | a day ago |
| Total downloads | 62 |
| Total rating | 0 |
| Categories | Mods Client-side Tweaks & Quality Of Life |
| Dependency string | luckofthelefty-LethalHUDMessages-1.0.2 |
| Dependants | 0 other packages depend on this package |
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
README
LethalHUDMessages
A BepInEx mod for Lethal Company that displays randomized death, monster encounter, and event messages using the game's built-in HUD notifications instead of chat.
Features
- Death Messages — Randomized messages for all 16 causes of death and 21+ specific monsters
- Monster Encounter Messages — Alerts for non-lethal encounters (grabs, haunts, hits, behavior changes) with 15-second cooldown
- Event Messages — Critical damage, ship leaving, vote to leave, teleporter use, quota fulfilled, turret firing
- Two Display Styles:
- Tip (default) — Bottom-right popup with "DEATH" or "EVENT" header
- GlobalNotification — Bottom-center banner with color-coded backgrounds (red for deaths, yellow for events)
- Message Queue — Messages display for a minimum of 4 seconds each; rapid messages queue up instead of overwriting
- Modded Enemy Support — Generic fallback messages for custom/modded enemies
- Enemy Blacklist — Filter out enemies you don't want messages for
- Debug Test Mode — Press F8-F11 to cycle through message types without needing to die or encounter monsters
All messages are client-side — each player needs the mod installed to see the notifications. Uses the game's native notification system (no custom UI).
Screenshots
| Death (Gravity) | Event (Jester) |
|---|---|
 |
 |
| Event (Ship Leaving) | Death (Snare Flea) |
|---|---|
 |
 |
Configuration
Config file location:
BepInEx/config/com.github.luckofthelefty.LethalHUDMessages.cfg
| Section | Setting | Default | Description |
|---|---|---|---|
| Display | NotificationStyle | Tip |
Tip = bottom-right popup. GlobalNotification = bottom-center banner. |
| Debug | EnableTestMode | false |
Enable test hotkeys (F8-F11). |
| Player Events | CriticalDamageMessages | false |
Alert when a player's health drops to critical. |
| Ship Events | ShipLeavingMessages | false |
Alert when the ship is leaving. |
| Ship Events | VoteToLeaveMessages | false |
Alert when someone votes to leave early. |
| Ship Events | TeleporterMessages | false |
Alert when the teleporter is used. |
| Ship Events | QuotaFulfilledMessages | false |
Alert when the profit quota is met. |
| Monster Encounters | MonsterEncounterMessages | true |
Show non-lethal monster encounter messages. |
| Monster Encounters | CustomEnemyEncounterMessages | true |
Show fallback messages for modded/custom enemies. |
| Monster Encounters | EnemyBlacklist | (empty) | Comma-separated enemy names to ignore. |
Test Mode
With EnableTestMode = true, use these hotkeys in-game:
| Key | Action |
|---|---|
| F8 | Cycle through death messages (by cause of death) |
| F9 | Cycle through monster kill messages |
| F10 | Cycle through monster encounter messages |
| F11 | Cycle through event messages |
GlobalNotification Colors
When using the GlobalNotification display style, the banner background changes based on message type:
| Type | Background | Text |
|---|---|---|
| Death | Red | White |
| Event | Yellow | Black |
Installation
- Install BepInEx 5 for Lethal Company
- Place
com.github.luckofthelefty.LethalHUDMessages.dllinBepInEx/plugins/ - Launch the game
No other mods are required.
Building
dotnet restore
dotnet build
Output: LethalHUDMessages/bin/Debug/netstandard2.1/com.github.luckofthelefty.LethalHUDMessages.dll
Support
This mod is provided as-is. Support is limited to none. Feel free to fork and modify for your own use.
License
MIT
