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.
模組介紹 作者原文
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
- Install BepInEx.
- 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.
安裝與使用 安裝:BepInEx 外掛
- 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
- 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。
下面這些內容需要先安裝,否則該模組不會生效: