LCBridgeOverlay

In-game HUD overlay for Lethal Company.

Author: Solo00n

Language / Язык: English below, Русский ниже.

An in-helmet HUD panel that shows your quota, moon, interior, live monsters and traps, events and full run analytics without ever opening the terminal.

This overlay is currently tuned for a specific modpack. In vanilla, or a very different setup, some panels may show empty values or be less useful. Nothing crashes: every mod-specific reader is optional and fails silently. Future updates will add more features and settings so anyone can tailor it to their own game.

English

What it does

• Right-side HUD panel, tilted to sit like part of the helmet, in two styles: Legacy (red pixel-grunge) and Game (chat-like blue brackets).
• Quota block with rolling labels: once three quotas are done the tabs continue as Q4 Q5 Q6 and so on, and a compact marker line records every completed set of three.
• Location readout: moon, coloured weather, interior type, item counts inside and outside, beehives, Old Bird warning, and an apparatus icon while the apparatus is still in the facility.
• Run timer with milliseconds. Starts on landing, pauses in orbit, on loading screens and in menus, and resets on a new save.
• Monster icons on the side rails, left for outside and right for the interior, with a count badge and a deck for multiple variants.
• Live monster state icons: the hoarding bug turns angry, the jester pops out, the child eater grows up, the nutcracker takes aim, the snare flea clings to the ceiling, the coil-head freezes while someone looks at it, and turret-equipped heads fire tracers.
• Slayer and kamikaze variants are marked with blood splatter across the icon silhouette.
• Proximity fade: the closer a monster or trap is to you, the more solid its icon, while distant ones fade away.
• A monster icon flashes red the moment it takes a hit.
• Door radar: standing at a main entrance or fire exit reveals what waits on the other side.
• Optional scan gating, so creatures only appear once you have scanned them, using the in-game bestiary.
• Traps on the bottom edge, with turrets firing tracers during a turret event.
• Event plate that drops in after landing, visible to clients as well as the host.
• Victory analytics after every third quota, cumulative across the whole run, including total loot sold to the company.
• Centre-screen countdown over the last ten seconds before the ship leaves.
• Combined scrap-value multiplier from weather and events shown as a single number.
• Camera sway that follows the camera roll, matching camera-motion mods.
• Quality of life: CRT scanlines, idle fade, spectator support, and automatic hiding during game popups, store ads, takeoff and the pause menu.

How it works

The mod reads the game state about once per second inside its own process and draws the panel with Unity uGUI. Nothing is scraped from the screen and nothing in the game world is modified.

It also hosts a small local WebSocket bridge on port 8181, so a browser or OBS overlay can display the same data on stream. If you previously used the separate LCBridge mod, remove it: that collector is built in now, and running both would fight over the same port.

Multiplayer

The overlay is purely client-side and read-only. It never spawns, moves or changes anything in the world, so it does not need host authority and cannot desync a lobby.

• Every player installs it for themselves. It is not required on the host, and a host running it does not force it on anyone.
• The death counter reports the whole crew, taken from the shared run statistics, so deaths you never witnessed are still counted.
• Event information is read from data the host synchronises to every client, which is why the event plate appears for non-host players too, including those who joined late.
• The ghost girl is shown only in the HUD of the player she is haunting.

Requirements

• BepInEx 5.4.21 or newer.
• Optional: a stream overlay companion, only if you want the browser or OBS view fed by the built-in bridge.

Installation

Using a mod manager, which is recommended:

• Install the mod from Thunderstore through r2modman or the Thunderstore app and launch the game from the manager.

Manually:

• Place the mod DLL into the BepInEx plugins folder.
• If the separate LCBridge mod is still installed, delete it.

Configuration

All settings live in the config file gdlp.lcbridgeoverlay.cfg. Widget and behaviour toggles apply immediately, while style, language and scanlines need a restart.

Integrations and compatibility

Every integration is optional. When a mod is absent the related information is simply skipped and the overlay keeps working.

• BrutalCompanyMinusExtraReborn: event plate in the event colours, shown to clients as well as the host.
• WeatherRegistry and WeatherTweaks: combined weather names and the weather part of the scrap-value multiplier.
• LethalLevelLoader: names of custom interiors.
• MoreCompany: crew size.
• MonstersGordion: monsters listed on the Company moon.
• ToilHead: turret-equipped heads get their own icons and fire tracers.
• Camera Overhaul and other camera-motion mods: the panel sways along with the camera.
• Russian event names are supported when a Russian translation of the event mod is installed.

Credits

• Solo00n: author.
• Monster and trap art: Lethal Company renders, keyed for transparency.
• Built on BepInEx, HarmonyX, Unity uGUI and TextMeshPro.

Русский

Панель прямо в шлеме: квота, луна, интерьер, живые монстры и ловушки, ивенты и полная аналитика забега — без единого захода в терминал.

Пока оверлей заточен под конкретный модпак. В ванили или сильно другой сборке часть блоков может быть пустой или менее полезной. Ничего не падает: все обращения к другим модам опциональны и молча пропускаются. В планах — больше функций и настроек, чтобы каждый мог подстроить оверлей под себя.

Что умеет

• Панель у правого края, с наклоном «как часть шлема», в двух стилях: Legacy (красный пиксельный) и Game (как игровой чат, синие уголки).
• Блок квоты с продолжающейся нумерацией: после трёх сданных квот вкладки идут дальше как Q4 Q5 Q6, а компактная линия меток отмечает каждую пройденную тройку.
• Локация: луна, цветная погода, тип интерьера, число предметов внутри и снаружи, ульи, предупреждение об Old Bird и иконка аппарата, пока его не вынесли из комплекса.
• Таймер забега с миллисекундами. Идёт на луне, стоит на орбите, на загрузках и в меню, сбрасывается на новом сейве.
• Иконки монстров по бортам: слева улица, справа комплекс, со счётчиком и колодой из вариантов.
• Иконки состояний: жук звереет, джестер вылезает, ребёнок-людоед взрослеет, наткрекер целится, потолочная личинка висит на потолке, койл замирает под взглядом, а головы с турелью стреляют трассерами.
• Slayer и камикадзе помечаются кровавыми пятнами по силуэту иконки.
• Прозрачность по близости: чем ближе монстр или ловушка, тем плотнее иконка, дальние бледнеют.
• Иконка вспыхивает красным в момент попадания по монстру.
• Радар у двери: стоя у главного входа или пожарного выхода видно, кто ждёт по ту сторону.
• Опциональное сканирование: существо появляется только после скана, по игровому бестиарию.
• Ловушки на нижней кромке, при турельном ивенте турели стреляют трассерами.
• Плашка ивента после посадки, видна и клиентам, а не только хосту.
• Аналитика после каждой третьей квоты, накопительная за весь забег, включая суммарно проданный компании лут.
• Отсчёт по центру экрана за десять секунд до отлёта корабля.
• Суммарный множитель стоимости лута от погоды и ивентов одним числом.
• Покачивание панели вслед за камерой, в такт модам на движение камеры.
• Мелочи для удобства: CRT-полосы, затухание в бездействии, режим наблюдателя и автоскрытие на игровых окнах, рекламе магазина, взлёте и в меню паузы.

Как устроено

Мод читает состояние игры примерно раз в секунду внутри своего процесса и рисует панель на Unity uGUI. Ничего не считывается с экрана и ничего в мире игры не меняется.

Дополнительно поднимается локальный WebSocket-мост на порту 8181, чтобы браузерный или OBS-оверлей показывал те же данные на стриме. Если раньше стоял отдельный мод LCBridge, удали его: сборщик теперь встроен, а вдвоём они займут один порт.

Мультиплеер

Оверлей полностью клиентский и работает только на чтение. Он ничего не спавнит, не двигает и не меняет в мире, поэтому не требует прав хоста и не может рассинхронизировать лобби.

• Каждый игрок ставит его себе сам. Хосту он не нужен, и хост никому его не навязывает.
• Счётчик смертей показывает всю команду по общей статистике забега, поэтому смерти, которых ты не видел, тоже учтены.
• Информация об ивентах читается из данных, которые хост синхронизирует всем, поэтому плашка появляется и у не-хоста, включая тех, кто подключился позже.
• Девочка-призрак видна только тому игроку, которого она преследует.

Требования

• BepInEx 5.4.21 или новее.
• Опционально: компаньон для стрим-оверлея, если нужен браузерный или OBS-вид от встроенного моста.

Установка

Через менеджер модов, рекомендуемый способ:

• Поставь мод с Thunderstore через r2modman или приложение Thunderstore и запусти игру из менеджера.

Вручную:

• Положи DLL мода в папку плагинов BepInEx.
• Если ещё стоит отдельный мод LCBridge, удали его.

Настройки

Все настройки лежат в файле конфига gdlp.lcbridgeoverlay.cfg. Тумблеры виджетов и поведения применяются на лету, стиль, язык и полосы требуют перезапуска.

Совместимость и интеграции

Все интеграции опциональны. Если мода нет, соответствующая информация просто пропускается, а оверлей продолжает работать.

• BrutalCompanyMinusExtraReborn: плашка ивента в его цветах, видна и клиентам, и хосту.
• WeatherRegistry и WeatherTweaks: комбинированная погода и погодная часть множителя стоимости лута.
• LethalLevelLoader: названия кастомных интерьеров.
• MoreCompany: размер экипажа.
• MonstersGordion: монстры на луне компании.
• ToilHead: головы с турелью получают свои иконки и стреляют трассерами.
• Camera Overhaul и другие моды на движение камеры: панель качается вместе с камерой.
• Русские названия ивентов поддерживаются, если установлен русификатор мода на ивенты.

Авторы

• Solo00n: автор.
• Арт монстров и ловушек: рендеры Lethal Company, вычищенные под прозрачность.
• Сделано на BepInEx, HarmonyX, Unity uGUI и TextMeshPro.

Changelog — LCBridgeOverlay

1.5.1

• Damage flash now works. HitEnemy is virtual and 21 enemies override it, so patching the base method alone missed almost every monster. All overrides are patched, and the flash is triggered directly instead of travelling through the one-second bridge tick.
• End-of-day countdown fixed and restyled. It used to read 0 permanently (a normalised threshold was subtracted from day units), so it also sat on screen all day. It is now a centre-screen number over the last ten seconds, counted locally so no digit is skipped, and each second grows and fades as it flies toward you.
• Weather is now part of the loot multiplier. The weather contribution was never counted: it is an instance property on the current weather, not a static field. It is read through the weather mod's current-weather API and honours that mod's own "use scrap multipliers" setting. The multiplier row is always shown while enabled, so x1 is visible too.
• Same monster inside and outside now fades independently — both rails previously shared one distance.
• Quota marks are a single centred line of five that recolours on each pass instead of growing new rows, and the analytics banner closes when the lever is pulled so the panel returns to its normal size.
• Door radar triggers reliably: the "at a door" range was 6 m and almost never matched; it is now 14 m measured from the door itself.
• Re-entering a save resets the overlay; the apparatus icon sits on the interior line; apparatus art re-keyed; new eye indicator.

1.5.0

• Quota marks & endless runs. Every completed set of 3 quotas adds a small mark under the quota block (15 per row, colour changes after the first row, counts up to 100), and the tab labels roll onward: Q1 Q2 Q3 → Q4 Q5 Q6 → … Run analytics now appear at the end of every set of three and are cumulative for the whole run.
• Team-wide death counter (TeamDeaths, on by default) — counts every player's death, even ones you didn't witness. Optional DeathsOnlyOnLeave updates the counter only when the ship leaves a moon.
• Monsters behind the door (DoorRadar) — standing at a main entrance or fire exit reveals what's on the other side, via a virtual radar at the paired door (radius configurable, default 22 m).
• Auto-hide on game popups (HideOnPopups) — tips, quota-delivery and end-of-day screens hide the overlay, which then returns to its previous state.
• Auto-hide on store ads (HideOnStoreAd) — during a discount ad the overlay hides and can't be toggled back until it ends.
• Sold-loot total in the analytics — how much was actually sold to the company across the run.
• Previous-run analytics after eject — the summary stays up on the new ship and resets only when someone pulls the lever (kept in memory for the session only).
• Nearest variant only (NearestVariantOnly) — when a monster exists in several versions (e.g. plain and turret-equipped), only the one closest to you is shown.
• Combined loot multiplier (ShowLootMultiplier) — weather and event scrap-value multipliers summed into a single number.
• End-of-day countdown (ShowEndOfDayCountdown) — appears in the last 10 seconds.
• Damage flash (DamageFlash) — a monster's icon briefly flashes red when it takes damage (separate from the slayer blood-splatter).
• Apparatus icon next to the interior while the apparatus is still inside; it disappears once it's carried out.
• New eye icon for the connection indicator.
• Fixes: the outside-scrap count no longer misses loot that Brutal Company events spawn shortly after landing (the snapshot used to lock on the first non-zero value); BCME events now also read BCME's synced panel variable, so clients see them even when the announce RPC is missed.
• Verified: the timer runs on the Company moon (Gordion) and stops in orbit.

1.4.1

• Proximity fade (ProximityFade, default on) — the closer a monster or trap is to you, the more opaque its icon; distant ones fade toward transparent.
• Trap rail now matches the monster rails — icons sit on the bottom border line (following the event plate, lowered so they don't overlap the event text) and fade by proximity.
• Grabbable traps counted — BCME's GrabbableTurret/GrabbableLandmine (which destroy & replace the normal ones) now show up as turrets/mines instead of vanishing.
• Scan gating uses the in-game bestiary (Terminal.scannedEnemyIDs) — once you've scanned a creature it shows, reliably.
• Overlay hides during takeoff (while the game shows the center-screen info and the leave-lever is disabled), and stays visible on landing.
• Green halo around icons removed — the keyed-out transparent border is colour-bled so bilinear downscaling can't smear green; Gunkfish/Stingray icon maps correctly.
• README/manifest/LICENSE de-branded; docs updated.

1.4.0

• New monster icon pack — all monster/trap icons replaced with higher-quality green-screen renders, keyed and trimmed cleanly (incl. genuinely dark monsters like the Bracken).
• Monster state icons. Many monsters now switch icon by their live state, chosen by priority (angry/attacking > aggression > transformed > special > passive):
  • Hoarding Bug — passive / angry
  • Jester — folded / popped (angry)
  • Child Eater (Cave Dweller) — child / adult
  • Nutcracker — passive / attacking
  • Snare Flea — floor / ceiling (ceiling takes priority)
  • Coil-Head — sway stops while any player looks at it (frozen)
  • ToilHead — plain head / turret, and it fires tracers when its turret shoots
• Slayer / kamikaze variants now get a blood-splatter overlay baked onto the icon silhouette, instead of a flat red recolour.
• RequireScanToShow (config, default off) — monsters only appear in the overlay after you've scanned them.
• Ghost Girl only shows in the HUD of the player she's haunting.
• Camera Overhaul synergy — the panel subtly tilts/drifts with the camera (reads the camera's real roll, so it works with any camera-motion mod, and gives a gentle sway in vanilla). Config: CameraSway, CameraSwayStrength.
• Multiplayer fixes: BCME events now show on clients too (captured from BCME's synced tip), not just the host; and the overlay stays visible while you're spectating (dead).
• Detection runs on a ~0.5 s timer (not per-frame) and is all soft/reflection — missing mods never break the overlay.
• Fixes:
  • Overlay now fills in instantly on landing (event + interior + monsters in one packet) — forced refresh on ship-landed and on level-generated, instead of trailing in over a second.
  • Auto-timer no longer keeps ticking on orbit / during loads — it runs only while actually landed on a moon.
  • Toggle-key rebinding works — symbol keys like \ are accepted (were silently falling back to I), and the key applies live from config without a restart.

1.3.0

• LCBridge is now built in. The overlay collects the game state itself and hosts the WebSocket bridge (ws://localhost:8181) that the OBS/HTML overlay reads — so the separate LCBridge mod is no longer needed (remove it to avoid a port conflict). One mod, no inter-mod dependency.
• Data path is now in-process (no self-connecting WebSocket client); the eye indicator tracks the bridge "heartbeat".
• Manual RU translation of BCME event names (~270 events) — replaces the auto-translator, which couldn't handle BCME's internal event IDs.
• Full language consistency: everything now follows the language setting (EN or RU) — death causes are no longer hard-coded, and the victory stamp/title localise properly. No more mixed EN/RU.
• ScaleMonstersByCount now scales trap icons by count too, not just monsters.
• New icon: Lasso Man (no longer hidden); redone HD icons for Feiopar, Giant Sapsucker, Gunkfish, Red Locust.
• Fixes: the victory banner now tilts/warps with the rest of the panel; the Q1/Q2/Q3 tabs stay inside their frames when the panel grows (victory screen); the overlay now dims into the background while the pause (Esc) menu is open, so it no longer competes with the menu (LC's menu is camera-space, so a Screen-Space-Overlay panel can't render strictly behind it).
• Config [WebSocket] simplified to a single Port (the built-in bridge port).

1.2.0

• Helmet-HUD tilt (always on) + optional perspective / keystone effect (PerspectiveStrength).
• Eye indicator moved to the header, centered next to the timer; closes like an eyelid when leaving the ship.
• CRT scanlines + worn (grunge) frame edges.
• Idle fade with configurable delay and opacity (FadeWhenIdle, IdleFadeSeconds, IdleMinOpacity).
• Pause-aware: panel stays on the game plane under the Esc menu (no longer hidden).
• Timer shows milliseconds (fixed-width, no more flicker on ms updates).
• Monster rails: icons under the same angle/perspective, top-aligned (outside = inside), count badge in the corner; stable order (no per-second re-pop); experimental ScaleMonstersByCount.
• MonstersGordion support (via LCBridge) — monsters on the Company moon.
• BCME RUS / XUnity.AutoTranslator integration — translated event names.
• Removed redundant UseLegacyStyle (use Style) and the TiltAngle config (tilt is now a fixed base).
• New icons: Masked, ToilHead (coil+turret); Barber name alias fix (ClaySurgeon).

1.1.0

• Monster/trap icons on the side rails (baked into the DLL), turret-fire tracers.
• Victory banner with run analytics; ticker.
• Blue-bracket "Game" style vs red "Legacy" style.
• Custom eye sprite as the connection indicator.
• RTLC / Russian language support.

1.0.0

• First in-game overlay: panel at the right edge, reads LCBridge WebSocket, widgets with per-widget toggles, timer, location/quota/day/deaths, BCME event plate.