Mineshaft Elevator Music (BepInEx)

Author: VULGARUS Credits: ChatGPT x Codex

Mod for Lethal Company v80 (BepInEx 5.4.2305).

What it does

• Replaces the vanilla mineshaft elevator ride music.
• Host picks a track from BepInEx/config/MineshaftElevatorMusic using a shuffle queue (no repeats until all tracks are played).
• All clients play the same track at the same time (network-synced).
• If a client is missing the file, it will simply stay silent.

Included test track

This package includes a default test track placed in: BepInEx/config/MineshaftElevatorMusic/

Important note (sync requirement)

All players must have the same audio files in: BepInEx/config/MineshaftElevatorMusic

The host only syncs the file name and start time.

Supported formats

• .ogg (recommended)
• .wav
• .mp3 (works if Unity MPEG support is available)

Config

Config file: BepInEx/config/pl.mineshaft.elevator.music.cfg

• VanillaNameKeywords: comma-separated keywords used to find the vanilla elevator audio source.
• ClipNameWhitelist: optional comma-separated clip name fragments to match.
• ObjectNameWhitelist: optional comma-separated object name fragments to match.
• VanillaStartWindowSeconds: only triggers replacement when vanilla audio time is near the start.
• RequireElevatorAudioPlaying: when true, only replaces if the source is actively playing.
• ReplaceAnyPlayingInMineshaft: set true to replace the first playing audio source in the mineshaft (use for troubleshooting).
• EnableDebugLogs: set true to log candidate sources and triggers.

LethalConfig (optional)

If you have AinaVT-LethalConfig installed, these settings show up in the in-game config menu.

Build

1. Edit MineshaftElevatorMusic.csproj and set LethalCompanyDir to your game directory.
2. Build with dotnet build -c Release.
3. Copy the output DLL to: BepInEx/plugins/MineshaftElevatorMusic/MineshaftElevatorMusic.dll

Thunderstore

• Thunderstore/manifest.json and Thunderstore/icon.png are ready.
• Copy the built DLL into Thunderstore/BepInEx/plugins/MineshaftElevatorMusic/.
• Zip the contents of Thunderstore/ and upload.
• Users must place music files in BepInEx/config/MineshaftElevatorMusic.

Troubleshooting

• If no music plays, confirm the folder has at least one .ogg/.wav/.mp3 file.
• Check BepInEx console for logs about loading or missing audio.