R2API Sound

版本 v1.0.3·更新於 2024-08-28

API for adding custom sounds or musics

模組介紹 作者原文

R2API.Sound - WWise Soundbank loading and MusicTrack addition

About

R2API.Sound is a submodule assembly for R2API that allows mod creators to easily load SoundBanks from WWise and implement new Music Tracks for the game.

Use Cases / Features

R2API.Sound works via two main classes, the SoundBanks class and the Music class.

SoundBanks class allows you to load your WWise SoundBanks to the game you can later use the SoundBank's event names in the game's Util.PlaySound method.

The Music class allows you to add new music tracks to the game, these new tracks can later be used for playing music in different stages, overriding music, and more.

The Music class is mainly used for mods that do not have access to properly populating the Game's MusicTrackDef scriptable object, as that scriptable object requires the mod creator to have access to WWise's Unity Integration.

Related Pages

A guide on how to add your own music can be found here, the guide uses R2API.Sound's Music class.

Changelog

'1.0.3'

  • Initial fixes for SOTS DLC2 Release.

'1.0.2'

  • Add missing BepInDependency to R2API.ContentManagement

'1.0.1'

  • Fix the NuGet package which had a dependency on a non-existent version of R2API.Core.

'1.0.0'

  • Split from the main R2API.dll into its own submodule.

安裝與使用 安裝:BepInEx 外掛

  1. 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
  2. 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
  3. 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
  4. 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。

帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

bbepis-BepInExPackRiskofThunder-HookGenPatcherRiskofThunder-R2API_CoreRiskofThunder-R2API_ContentManagement

檔案與校驗

檔案名稱
R2API_Sound-1.0.3.zip
檔案大小
21.4 KiB