Please disclose if your mod was created primarily using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
LethalHUDMessages
HUD overlay notifications for deaths, monster encounters, and game events. No chat spam.
| Last updated | 3 weeks ago |
| Total downloads | 220 |
| 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
