ForgeAudio
Public GTFO audio library: Ogg Vorbis cues, positioned and attached playback, voice budgets, occlusion and sounds every player hears.
| Last updated | 2 days ago |
| Total downloads | 37 |
| Total rating | 0 |
| Categories | Libraries |
| Dependency string | NAinfini-ForgeAudio-0.1.0 |
| Dependants | 4 other packages depend on this package |
This mod requires the following mods to function
BepInEx-BepInExPack_GTFO
BepInEx pack for GTFO. Preconfigured and includes Unity Base DLLs.
Preferred version: 3.2.4
NAinfini-ForgeCore
Public GTFO mod foundation: asset bundles, logging, settings, pools, networking, input leases, local saves and calls into the game's own systems.
Preferred version: 0.1.0README
ForgeAudio
A shared sound library for GTFO mods. Mods drop Ogg files in a folder and play them by name. ForgeAudio mixes every mod's sounds together, so they follow the game's volume sliders, share voice limits and quiet down behind walls.
ForgeAudio does nothing on its own. You normally install it because another mod needs it, such as Forge Ordnance.
Report bugs on GitHub, or find me on the GTFO Modding Discord as nainfini.
What it does
- Plays sounds flat, at a point in the level, or following an object.
- Follows the game's sound sliders: Music for music, Dialogue for voices, SFX for everything else.
- Limits how many sounds of one kind play at once, across all mods. A stronger or nearer sound pushes out the weakest one.
- Lets a loud sound, such as an explosion, quiet debris and ambience sounds from every mod for a moment.
- Makes sounds quieter behind walls and closed doors.
- Can play one of the game's own sound events at a point for a mod, unchanged and through the game's own mix.
- Plays a mod's sound for every player at once, at the same place, without the mod writing network code.
- Varies volume and pitch from play to play and never repeats the same variant twice in a row.
- Lets a mod replace or silence one player's own footsteps, jump and landing sounds, for example while that player wears an exosuit. Every other player and every other game sound is untouched. It sends nothing over the network.
Settings
When a mod that also uses ForgeUI is installed (Forge Engine, Forge Ordnance and Forge Weapon Energy Lab do), the game's Settings → Audio page has, under the game's own sliders, a MOD AUDIO group: one slider for all mod sounds and one for each category (ForgeUI draws the rows; ForgeAudio keeps the values). They apply to every mod's sounds on top of the game's own sliders, take effect at once and are saved in BepInEx/config/NAinfini.ForgeAudio.cfg (Volume / Master and one entry per category, 0 to 1, default 1). The page's Reset puts them back to full.
| Category | Covers |
|---|---|
ui |
Menus, prompts, alarms |
weapon |
Gunfire, reloads |
explosion |
Blasts, impacts |
debris |
Shrapnel, rubble |
ambience |
Beds, hums, loops |
voice |
Speech, radio |
vehicle |
Suits and pods: steps, servos, engines |
device |
Beacons, turrets, supply pods, terminals |
music |
Music |
Mods that use ForgeAudio have no volume settings of their own.
Installation
Install with r2modman or the Thunderstore Mod Manager. It also installs BepInExPack_GTFO and ForgeCore. For a manual install, put the files in their own folder under BepInEx/plugins and install both of them too.
For mod authors
The developer guide explains how to add sounds to your mod.
License
Code: MIT. It includes NVorbis (MIT) to decode Ogg Vorbis; its license ships in the package.
