Enhanced Spectator

Enhanced Spectator is a BepInEx mod for Lethal Company that improves dead-player spectating while preserving the game's vanilla death, target-selection, and lobby flow.

This is a public test release. Multiplayer features require compatible players to install the same mod version.

Version: 0.2.0

Features

• Enhanced freecam for dead spectators.
• Configurable movement, recenter, reset, fast, and slow controls.
• Stable spectator camera anchoring that reduces view movement inherited from watched-player walk/run animation.
• Automatic target recovery when the watched player disconnects and another living player is available.
• Spectator presence between compatible modded peers.
• Runtime detached-head spectator visuals and name tags, with placeholder fallback when the runtime source is unavailable.
• Dead spectator visibility for living and dead compatible peers.
• Speaking head scale and pulse driven by synced voice activity.
• Configurable routed dead-spectator voice between compatible peers.
• Positional spectator voice and distance attenuation when pose sync is available.
• Local-only spectator stability improvements when joining an unmodded host.
• Stable floating-head visibility when a spectator toggles between enhanced freecam and vanilla spectator view.
• Cached runtime paths for routine input, camera, visual, name-tag, network sampling, and voice-routing work.
• Runtime-only visuals. No game assets are exported, saved, or packaged.

Version 0.2.0 Highlights

• Reduced spectator camera jitter caused by watched-player walk/run animation.
• Automatically switches away from disconnected watched players when another living target is available.
• Improves remote floating-head visibility across host and client spectator perspectives.
• Lowers avoidable steady-state lookup, allocation, and debug-log overhead during normal play.

Default Controls

Forward and backward movement follows the spectator camera direction. Looking up while moving forward moves upward; looking down while moving forward moves downward.

Installation

Install through Thunderstore or r2modman.

For manual installation, place EnhancedSpectator.dll in a BepInEx plugin folder for Lethal Company.

Multiplayer Requirements

• Local freecam works client-side.
• Floating-head visuals, name tags, voice-activity scaling, and routed spectator voice require compatible Enhanced Spectator peers.
• Client-to-client visibility requires a compatible modded host with host relay enabled.
• Unmodded hosts and unmodded peers safely fall back to local-only behavior.
• In unmodded-host sessions, installed clients keep the enhanced local freecam fallback without multiplayer spectator visuals or routed voice.

Configuration

The BepInEx config file is generated after the game starts once with the plugin installed:

BepInEx/config/Auuueser.EnhancedSpectator.cfg

Common options include:

• Spectator.Freecam.EnableFreecam
• Networking.EnableHostRelay
• FloatingHead.EnableFloatingHeadVisuals
• FloatingHead.UseRuntimeDetachedHeadVisuals
• NameTag.ShowNameTags
• VoiceRouting.EnableSpectatorVoiceToTarget
• VoiceRouting.SpectatorVoiceAudienceMode
• VoiceRouting.SpectatorVoiceEnableDistanceAttenuation

Keep debug options disabled for normal play unless you are collecting logs for troubleshooting.

License

Enhanced Spectator is licensed under the GNU General Public License v3.0.

Known Limits

• This release is a test version.
• Runtime detached-head visuals depend on already loaded in-game runtime objects and fall back to placeholder visuals when unavailable.
• The mod does not export, include, or redistribute Lethal Company model assets.
• The mod does not create new Dissonance channels or ship custom audio assets.
• Other camera, voice, or spectator mods may conflict if they write the same runtime systems later in the frame.

Repository

Source and public documentation:

https://github.com/Auuueser/Enhanced-Spectator-Test-Version