Aueser-Error_Fix icon

Error Fix

Defensive compatibility guards for common Lethal Company V81 runtime errors and modpack log spam.

Last updated a week ago
Total downloads 4775
Total rating 2 
Categories BepInEx Client-side Server-side Bug Fixes Tweaks & Quality Of Life AI Generated
Dependency string Aueser-Error_Fix-0.0.5
Dependants 8 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

Error Fix

Error Fix is a defensive compatibility plugin for Lethal Company. It is designed for modded profiles and modpacks where known runtime errors or repeated Unity warnings make logs difficult to read or interfere with narrow client-side flows.

The plugin adds targeted Harmony guards around specific failure paths. It does not rebalance enemies, change spawn tables, replace game systems, or intentionally alter normal AI behavior.

Current version: 0.0.5

Scope

Error Fix targets known stack traces, known exception types, and exact warning prefixes. In most cases it validates a reference or index before the original method uses it, skips one unsafe frame, or handles a known exception after the target method has already failed.

Unknown exceptions are left visible. This plugin is not intended to hide every error in a modpack.

Covered issue groups

  • Exact Unity warning spam for missing audio spatializer setup, BoxCollider negative scale/size messages, disabled AudioSource playback warnings, SteamValve empty AudioSource warnings, and duplicate Static Lighting Sky warnings.
  • Exact known BepInEx log noise from RuntimeIcons, PathfindingLib, and LethalPerformance, filtered by source, level, and message shape.
  • Audio failures from disabled audio sources or null AudioClip playback.
  • Particle system warnings from unreadable or zero-area mesh shape sources.
  • Runtime NavMesh source errors from unreadable meshes.
  • Optional Enemy AI movement suppression while a NavMeshAgent is off the NavMesh.
  • Selected Netcode edge cases involving ragdolls, object reparenting, despawn flow, and known RPC null/index failures.
  • Undefined PlayerRagdoll4+ tag lookups in high-player-count or heavily modded sessions.
  • Known item, suit, quicksand, entrance teleport, terminal, chat, ambience, jetpack, soccer ball, and enemy update exceptions, with targeted per-frame hot-path guards requiring explicit Enabled.
  • Optional compatibility guards for selected third-party mods when the expected runtime types and method signatures are present.

Handled warnings are limited so recurring issues remain visible without filling the log.

0.0.5 focus

Version 0.0.5 keeps the functional Error Fix guard set while making default runtime behavior more conservative for average FPS and 99th percentile FPS.

  • RuntimePatchMode provides a master passive baseline for comparison testing without removing the plugin from a profile.
  • EnemyAI.DoAIInterval NavMesh recovery and targeted per-frame guards now require explicit Enabled; Auto is treated as disabled for those hot-path replacements.
  • Exact BepInEx log noise filtering reduces high-volume messages from RuntimeIcons, PathfindingLib, and LethalPerformance without hiding Error or exception logs.
  • Known Unity warning filtering now covers repeated disabled AudioSource playback warnings.
  • Assembly-CSharp verification now falls back to the managed assembly path when Assembly.Location is empty.

Configuration notes

  • Sensitive guards use PatchEnableMode: Auto, Enabled, or Disabled.
  • RuntimePatchMode=Disabled is the master passive mode for FPS baseline testing. It leaves the DLL loaded but installs no Harmony patches, registers no scene lifecycle hooks, binds no extra ErrorFix settings, and skips Assembly-CSharp verification. Use this when comparing installed ErrorFix against no ErrorFix.
  • Performance-sensitive global hooks and hot-path guards, including global AudioSource.Play*, player-ragdoll tag lookup/setter hooks, the global UnityEngine.Object.Destroy hook, particle mesh scene scans, EnemyAI.DoAIInterval, player proximity, terminal object update, entrance teleport update, suit update, gameplay enemy update, and optional-mod frame/update hooks, require explicit Enabled.
  • KnownUnityWarningFilterMode=Enabled is the default. It filters only the documented exact Unity warning prefixes, including disabled AudioSource playback warnings, and does not repair the underlying audio, collider, AudioSource, or lighting setup.
  • KnownBepInExLogNoiseFilterMode=Enabled is the default. It filters only exact known low-value RuntimeIcons, PathfindingLib, and LethalPerformance messages; Error and exception logs stay visible.
  • SteamValveDamageTriggerSpawnGuardMode=Disabled is the default. Enable it only after confirming a SteamValve damageTrigger gameplay issue.
  • EnemyAINavMeshGuardMode=Enabled is required to install the per-enemy AI tick NavMesh guard. EnemyAI warp recovery also remains disabled unless AllowEnemyAIWarp=true.
  • PlayerNearOtherPlayersGuardMode, TerminalAccessibleObjectUpdateGuardMode, EntranceTeleportUpdateGuardMode, UnlockableSuitUpdateGuardMode, and GameplayEnemyUpdateGuardMode are disabled by default. Use Enabled only when that exact hot-path guard is needed more than the FPS cost risk.

Optional compatibility targets

These guards only activate when the relevant mod is installed and the expected runtime target exists. Error Fix does not include, redistribute, or modify third-party mod files.

Project Compatibility case
EnemyHealthBars Known health bar LateUpdate null-reference failures.
ShipLootPlus Known loot UI null-reference failures during ship unlockable sync and grab refresh.
ToggleableNightVision Known outdoor lighting null-reference failures during lighting updates.
ChatCommands Known host-start null-reference failure in ChatCommandAPI.

Installation

Use a Thunderstore-compatible mod manager, or install manually by placing the package contents in your profile's plugin folder.

For manual installation, the runtime file must be located at:

<profile>/BepInEx/plugins/V81ErrorFix.dll

Compatibility notes

  • Requires BepInEx 5.
  • Built for Lethal Company V81-era assemblies.
  • Best tested in heavily modded profiles where the listed errors are already present.
  • Large modpacks should test new releases in a separate profile before distribution.

Because this plugin uses Harmony patches, compatibility depends on game version, mod versions, and load order. If another mod rewrites the same method, behavior may depend on patch order.

Reporting issues

Please include enough information to identify the exact failing path:

  • Lethal Company version.
  • Error Fix version.
  • Full stack trace.
  • Mod list and mod loader version.
  • Whether the issue happened as host, client, or single-player.
  • Reproduction steps, if known.

Source

Source and documentation are available on GitHub:

https://github.com/Auuueser/Error-Fix

Attribution and redistribution

Error Fix is not affiliated with, endorsed by, or maintained by Zeekerss, Unity Technologies, BepInEx, Harmony, Thunderstore, or the authors of optional compatibility targets.

Third-party compatibility is implemented through runtime reflection guards only. This package does not include third-party source code, third-party DLLs, game assemblies, decompiled game source, or external mod package contents.