loaforcsSoundAPI

A soundtool made to give Sound-Pack creators ultimate control, and users the ultimate experience.

[!IMPORTANT] Absolutely not meant as a replacement for LCSoundTool and CustomSounds. This sound replacement API is much, much more complex than either of those and is meant for advanced users.

Ultimate Experience

loaforcsSoundAPI makes use of Multithreading, splitting sound loading into two steps. With very little effort LethalResonance was decreased from 4 seconds of time during startup to just under 250 ms.

Ultimate Control

loaforcsSoundAPI affords a Sound-Pack creator much more control over how their sounds are played and how they organise.

A simple tutorial to make a sound pack is available in the github wiki. A couple templates are avaliable as well.

Main Benefits

• Custom File Structure Hierachy
• Intuitive variations for sounds
• Mapping multiple sounds to the same sounds
• Sound-packs can create config options just like regular mods
• Swap out audio clips live based on what is happening ingame.

v1.0.0!!!

It's taken a bit of time but it's here.

Added:

• Conditions, you're now able to make your sounds react better to what's happening in game.
• "update_every_frame". A new option that lets you swap out a sound as its playing, it will also respect the amount of time that has elapsed.

Changed:

• Changed to a thread pool based multithreading system.
• Intro Skipper mods should work better.
• Crashes should also be fixed.
• Genuinely wild speedup. LethalResonance's non-startup sounds took 12 seconds to load on v0.x. It now takes 2 (for me at least, your numbers will vary a lot)

Fixed:

• Added more null checks, should be more compatible with LittleCompany.

v1.0.2

• Fixed an issue where AudioSourceReplaceHandler would try to unregister itself multiple times.

v1.0.3

• Maybe registering stuff would help.

v1.0.4

• Temporary debug logs for conditions

v1.0.5

• More null checks

v1.0.6

• :skull:

v1.0.11

• Deprecated load_on_startup (Multithreading is now always before the main menu, so it didn't make sense to have this anymore) and random (i've got a better plan for syncing sounds. eventually.)
• Changed default threads from 32 to 4
• Slightly improved memory usage
• Setting sound to null on a sound replacement will remove the sound if it gets replaced like that.
• Added timer to multithreaded load times.

v1.0.12

• Fixed some sounds just going i no no wanna
• Added logging levels. You can stop complaining now.