LC Mic Recovery

LC Mic Recovery is a small BepInEx plugin for Lethal Company. It attempts to recover stalled or unavailable in-game microphone capture without requiring a full game restart.

The plugin focuses on conservative recovery behavior. It tries a local Dissonance microphone capture reset first, only invokes the game's own Dissonance reset path when the current game state is safe, and avoids running recovery during menu, lobby, teardown, and scene-transition states.

Features

• Automatic microphone recovery checks while in a valid in-game state.
• Manual recovery hotkey for cases where immediate recovery is needed.
• Local ResetMicrophoneCapture() recovery path.
• Guarded game-side ResetDissonanceCommsComponent() support when safe.
• Local recovery can continue when the game-side reset path is unsafe, while game-side reset remains guarded.
• Cooldown, post-recovery grace period, and failure backoff to reduce repeated reset spam.
• Automatic Chinese/English logs and recovery notifications.
• Short in-game recovery notification text to avoid HUD line overlap.

Localization

The LanguageMode config controls user-facing language:

• Auto uses Chinese when LC-Chinese-Project / V81TestChn is detected, otherwise English.
• English forces English logs and HUD notifications.
• Chinese forces Chinese logs. If Chinese HUD font support is not detected, in-game HUD notifications fall back to English to avoid square-box glyph rendering.

The in-game notification is intentionally brief. The longer recovery completion note is written to the BepInEx log when five-step recovery logs, debug logs, or state logs are enabled.

Installation

1. Install BepInExPack for Lethal Company.
2. Install this package with a compatible mod manager, or copy the package contents into your game directory.
3. The plugin DLL should be located at:

BepInEx/plugins/LCMicRecovery/LCMicRecovery.dll

Usage

The plugin runs automatically after installation. If automatic recovery does not restore voice capture in a specific case, use the configured manual recovery key from the plugin configuration.

Configuration is generated by BepInEx after the first launch. The default behavior keeps local Dissonance microphone recovery available even when the game-side reset path is unavailable or unsafe.

Compatibility Notes

This plugin targets Lethal Company V81-era behavior and relies on BepInEx, Harmony, DissonanceVoip, and the game's managed assemblies.

When the game-side reset path is unavailable, unsafe, already running, or fails to start, the plugin falls back to local microphone capture reset behavior instead of failing hard.

Troubleshooting

• If voice capture fails after joining or leaving sessions, wait for the game to finish loading or transitioning before using manual recovery.
• If recovery appears to be skipped, check the BepInEx console or log file for cooldown, teardown, missing device, no-device, or compatibility messages.
• If Chinese HUD text is not available without a Chinese localization/font mod, use Auto or English; Chinese mode will keep logs in Chinese while falling HUD text back to English when needed.
• If Thunderstore reports a package validation issue, confirm that the package root contains manifest.json, README.md, CHANGELOG.md, LICENSE, icon.png, and BepInEx/.

Scope

LC Mic Recovery is intended to recover microphone capture failures. It does not replace Dissonance, change voice chat networking, modify lobby behavior, or provide a general localization/font system.

Changelog

0.3.7

• Added LanguageMode with Auto, English, and Chinese modes.
• Added LC-Chinese-Project / V81TestChn detection so Auto mode follows Chinese modpacks while keeping vanilla game installs in English.
• Added HUD font-safety fallback behavior: Chinese mode keeps BepInEx logs in Chinese while in-game HUD notifications fall back to English when Chinese HUD font support is not detected.
• Added recovery completion detail logging when five-step, debug, or state logging is enabled.
• Updated recovery, manual trigger, automatic detection, game-side reset, and startup logs to follow the selected language.
• Recovery completion notifications now use compact in-game text, while detailed completion context is recorded in the BepInEx log.

0.3.6

• Improved manual recovery reliability by allowing local ResetMicrophoneCapture even when the game-side reset path is not currently safe.
• Improved automatic recovery so local Dissonance checks are not skipped solely because StartOfRound or the local player object is not ready.
• Added AllowLocalRecoveryWhenGameSideUnsafe, enabled by default.
• Improved debug and five-step recovery logs for manual trigger state, local reset execution, and game-side reset result.
• Updated build references and release metadata for the V81 test build.

0.3.5

• Hardened recovery cooldown timing so failed local reset attempts do not consume cooldown.
• Added safer manual recovery guards for teardown, room exit, menu, and unstable object states.
• Improved recovery logging so local reset, game-side reset, skipped reset, and failed reset outcomes are distinguishable.
• Added watcher instance protection to reduce duplicate polling and duplicate recovery attempts.
• Added one-time compatibility warning when game-side reset reflection targets are unavailable.
• Hardened cached Dissonance comms lookup against Unity destroyed-object references.
• Added local failure handling around manual microphone device list queries.
• Improved manual recovery reliability by adding a direct safe local reset fallback when the normal recovery path cannot proceed.
• Synchronized assembly and file version metadata with the published package version.

0.3.0

• Added automatic microphone recovery checks.
• Added manual recovery support through plugin configuration.
• Added local microphone capture reset behavior.
• Added optional game-side Dissonance reset integration.

0.1.0

• Initial development release.