LC Sound Tool

Simple Lethal Company sound tool and debugger. Patches all native Unity AudioSource components allowing you to dynamically replace any sound in the game at the final stages of playback by just specifying a new audio clip and the original clips name to this mod. Optionally allows logging all AudioSources playback, including PlayOneShot, PlayClipAtPoint etc. and the names of each clip into the BepInEx console when you press the F5 key.

Features

• Press F5 to log all audio playback to BepInEx console.
• Replace any audio clip with another one.

Installation

Install like any other BepInEx mod. Install to the following directory:

  \GAME_LOCATION\Lethal Company\BepInEx\plugins

Usage/Examples

Adding a replacement sound:

using LCSoundTool;

AudioClip newSound; // your logic for the new sound

SoundTool.ReplaceAudioClip("GhostDevicePing", newSound); // GhostDevicePing is the name of the original sound in this case the radar ping sound

Removing a replacement sound:

using LCSoundTool;

SoundTool.RestoreAudioClip("GhostDevicePing"); // GhostDevicePing is the name of the sound we replaced and in this case the radar ping sound which we now restore back to default

For more in-depth example see the following github repo: https://github.com/no00ob/CustomPingSound

FAQ

Can you use this tool to record or otherwise interact with the voice chat?

No. This tool is strictly for native Unity AudioSource components.

What is the performance impact of this tool compared to just manual replacement?

Idk, haven't done any major testing. In theory this should add slight delay and overhead to any audio playback, this game is so messily programmed however that finding certain audio clips was painful enough where I just decided that a tool like this might come in handy.

Can you add this or that?

Depends totally on what you're asking. If you want a new feature that has something to do with this mods original scope feel free to shoot me a message and I'll take a look. Otherwise no.

Does this mod work with other Unity games?

Surprisingly it should work actually. I tried it with my Unity 2022.3.x game and it did work for it too. The mods replacing the audio do not however, as different games use different sounds obviously.

Can I contribute somehow?

Yes. If you find any bugs or errors let me know and feel free to send pull requests my way if you feel like you can provide better programming or more features.

• 1.5.1

  • Fixed a bug where the Boombox and other vanilla audio was not being randomized properly after the last update.
  • Fixed a bug where the Extension Ladder and few other vanilla audio sources that played multiple different sounds were not working properly after the last update.
  • Fixed a bug where all sounds using a specific audio source could get wrongly checked for the source name filter if one sound playing through it had it defined.
  • Fixed a bug where syncing all networked sounds to clients could cause an overflow error if the string array was too long.
  • Fixed a bug where the legacy path warning was triggered wrongly for CustomSounds based mods. (sorry for taking this long Clementinise lol)
  • Fixed a bug where certain sounds could get stuck in the fileType dictionary as it has now been removed.
  • Improved networked sound handling. Now channels and frequency gets synced and handled properly.
  • Further tweaks to logging. New logging messages and fixes to existing ones.
  • Rewrote the SoundTool class to remove bloat and simplify future updates. You need to now define all parameters and nothing gets parsed automatically from the sound name anymore!
  • Other small internal tweaks and QoL changes for myself for future updates :)

• 1.5.0

  • Added support for AudioSource names as filters to where sounds can play. No more same sound from different sources!
  • Fixed a bug where AudioSources using the standard Play() would not randomize properly.
  • Added a config option to turn informational debugging on by default on launch.
  • Some minor tweaks to logging again. Mostly the same this time too. Cleaned up some useless messages, fixed typos, etc.
  • Added few new mod API methods and updated existing ones. You can now use some of the methods with different parameters than before.

• 1.4.0

  • Added support for Ogg Vorbis and Mpeg MP3 files. Now any of the 3 file types should work. Wav, ogg or mp3.
  • Reworked playOnAwake patching. Hopefully now ALL playOnAwake AudioSources and sounds should work without any problems.
  • Added a config option to let the mod patch any playOnAwake AudioSources that get created later during a game, as before it only ran when a new Unity scene was loaded. The option is for the delay between each runtime patch.
  • Added config option to sync host's Unity built in randomization seed with all clients. Random sounds should be the same for everyone with this on.
  • Some minor tweaks to logging. Mostly cleaned up some useless messages, fixed typos and added a new keybind for informational logs, F5 + LeftControl.
  • Added few new mod API methods and updated existing ones. You can now add sounds with multiple random variants from code without having the chance specified in the file name and small tweaks like that.

• 1.3.2

  • Small bug fixes.
  • Made networking optional. It was never meant to be forced on. It can now be toggled from the config file.

• 1.3.1

  • Changed the random clip seperator from "_" to "-".

• 1.3.0

  • Internal restructure of multiple parts of the mod. Shouldn't change previous behaviour.
  • Added support for random replacement clips. One vanilla sound can now have new multiple random clips with set chances that play randomly when the vanilla sound would.
  • Fixed multiple small bugs. AudioSources with playOnAwake set to true should now play more than once when the scene is not reloaded between playback.
  • Experimental networking for Unity AudioClips. Send AudioClips over the network to all connected players, also optionally sync all of the networked clips of the host to all clients.
  • Minor tweaks for game v45

• 1.2.2

  • Added support for mod managers. This changes the folder structure and loading of custom sounds a bit and all mods will need to be updated to work with mod managers. Old mods will continue to work with the newest release when manually installed. Mods only need to update to support mod managers, otherwise no sounds will load when using a mod manager.

• 1.2.1

  • Minor edits to mod page.

• 1.2.0

  • Added ability to load sound files from plugins folder, more in depth logging option and support for most AudioSources with playOnAwake flag set to true.

• 1.1.1

  • Minor edits to mod page.

• 1.1.0

  • Added a way to replace any in game audio clip by a custom one. Mod released on thunderstore.

• 1.0.0

  • Mod released on github.