LethalHUDMessages
HUD overlay notifications for deaths, monster encounters, and game events. No chat spam.
About this mod Author’s original text
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.dll in BepInEx/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
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.
Install these first, or the mod will not work: