TheMorningStar-Sound_Pack_Name_Fix icon

Sound Pack Name Fix

Lets sound packs with numbers in their names load. SoundAPI rejects any pack name with a digit, so packs like FNAF2Sighting silently fail; this patches the check to accept digits.

Last updated 2 hours ago
Total downloads 7
Total rating 0 
Categories Misc Audio AI Generated
Dependency string TheMorningStar-Sound_Pack_Name_Fix-1.0.0
Dependants 0 other packages depend on this package

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
loaforc-loaforcsSoundAPI-2.0.12 icon
loaforc-loaforcsSoundAPI

A general use library to replace sounds in Unity games.

Preferred version: 2.0.12

README

Sound Pack Name Fix

Lets sound packs with numbers in their names load.

What it does

loaforc's SoundAPI checks pack names character by character and rejects anything that is not a letter or underscore as an illegal special character, which includes plain digits. A pack named FNAF2Sighting fails on the 2, never registers, and plays no sound. Nothing looks wrong in game, it is just silent. This patches the check to also accept digits. SoundAPI Repo Fix handles a separate crash that silences every pack, so broken audio usually needs both.

Installation

  1. Install BepInEx.
  2. Put SoundPackNameFix.dll in BepInEx/plugins/. Requires loaforc's SoundAPI.
For developers - detailed breakdown

GUID: themorningstar.soundpacknamefix, hard dependency on me.loaforc.soundapi.

One Harmony transpiler on loaforcsSoundAPI.SoundPacks.Data.SoundPack.Validate. It walks the method's IL and swaps every call to char.IsLetter(char) for char.IsLetterOrDigit(char). Nothing else changes. Underscore handling and the error messages stay SoundAPI's own.

If SoundPack.Validate is not found, meaning SoundAPI moved it, it logs an error and patches nothing. Names with other special characters like spaces and dashes still fail, the same as before. This only legalizes digits. Validation happens at load, so install and restart. There is nothing to configure.