You are viewing a potentially older version of this package. View all versions.
loaforc-loaforcsSoundAPI-1.0.1 icon

loaforcsSoundAPI

A soundtool made to give Soundpack creators ultimate control.

Date uploaded 8 months ago
Version 1.0.1
Download link loaforc-loaforcsSoundAPI-1.0.1.zip
Downloads 21061
Dependency string loaforc-loaforcsSoundAPI-1.0.1

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
Bobbie-UniTask-2.5.0 icon
Bobbie-UniTask

Provides an efficient allocation free async/await integration for Unity.

Preferred version: 2.5.0

README

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.

CHANGELOG

v1.1.0

  • Looping sounds should now be properly handled and be replaceable on every loop.
  • Sounds that are disabled via purely a config are now not loaded - decreasing memory usage.
  • Fixed issues that could happen if you really wanted to mess with HideManagerGameObject
  • Updated README
  • Fixed a log message accidently being put on LogDebug instead of LogExtended
  • Fixed update_every_frame not correctly resetting.
  • Cleared up messaging on deprecated randomness and like some other internal changes that don't matter :3

v1.1.1

  • Patch fix for compatiblity issue

v1.1.2

  • Fix trying to loop an empty audio clip

v1.1.3

  • Turns out running your code lets you do things
  • Converted multithreading to use unitask, yes this is the new new multithreading

v1.1.4

i forgor :skull:

v1.1.5

some shenanigans

v1.1.6

undo shenanigans with zstring, do my own shenanigans

v1.1.7

hide looping support behind experimental config