MoolahModding · Kordusain · Oct 15, 2023 · Oct 15, 2023 · Oct 15, 2023 · Oct 15, 2023
diff --git a/docs/custom-audio/_category_.json b/docs/custom-audio/_category_.json
@@ -0,0 +1,7 @@
+{
+    "label": "Custom Audio",
+    "position": 3,
+    "link": {
+      "type": "generated-index"
+    }
+  }
diff --git a/docs/custom-audio/assets/akbank.png b/docs/custom-audio/assets/akbank.png
diff --git a/docs/custom-audio/assets/bus1.png b/docs/custom-audio/assets/bus1.png
diff --git a/docs/custom-audio/assets/bus2.png b/docs/custom-audio/assets/bus2.png
diff --git a/docs/custom-audio/assets/engineplugindownload.png b/docs/custom-audio/assets/engineplugindownload.png
diff --git a/docs/custom-audio/assets/uewwise1.png b/docs/custom-audio/assets/uewwise1.png
diff --git a/docs/custom-audio/assets/vs19.png b/docs/custom-audio/assets/vs19.png
diff --git a/...music/assets/windows-properties-ubulk.png → ...audio/assets/windows-properties-ubulk.png b/...music/assets/windows-properties-ubulk.png → ...audio/assets/windows-properties-ubulk.png
diff --git a/...stom-music/assets/wwise-file-importer.png → ...stom-audio/assets/wwise-file-importer.png b/...stom-music/assets/wwise-file-importer.png → ...stom-audio/assets/wwise-file-importer.png
diff --git a/...ustom-music/assets/wwise-project-menu.png → ...ustom-audio/assets/wwise-project-menu.png b/...ustom-music/assets/wwise-project-menu.png → ...ustom-audio/assets/wwise-project-menu.png
diff --git a/docs/custom-audio/assets/wwiseengineplugin.png b/docs/custom-audio/assets/wwiseengineplugin.png
diff --git a/docs/custom-audio/assets/wwiseerror.png b/docs/custom-audio/assets/wwiseerror.png
diff --git a/docs/custom-audio/assets/wwiseprjs.gif b/docs/custom-audio/assets/wwiseprjs.gif
diff --git a/docs/custom-music/index.md → docs/custom-audio/audio-editing.md b/docs/custom-music/index.md → docs/custom-audio/audio-editing.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 3
+sidebar_position: 1
 ---
 
 # Custom Music

diff --git a/docs/custom-audio/integrating-wwise-to-unreal.md b/docs/custom-audio/integrating-wwise-to-unreal.md
@@ -0,0 +1,189 @@
+---
+sidebar_position: 2
+---
+
+# Integrating Wwise into Unreal Engine
+
+With a proper Wwise integration, you can add new sounds, do some editing like random pitch shifting without editing every sound file or even randomize the sounds played, make new tracks, tie the sound levels to the in game sliders, and make the sound work on both Steam/Epic platforms and Gamepass version.
+
+## The Integration Process
+
+:::caution Make sure you have time and drive space set for this
+This will take some time and about 10-12 gigabytes of free space. You'll be building the unreal engine and downloading 2 SDKs. Depending on your computer and net speed, it can take a bit.
+:::
+
+### Prerequisites
+
+- [Visual Studio 2019](https://visualstudio.microsoft.com/vs/older-downloads/)
+- [Audiokinetic Wwise launcher](https://www.audiokinetic.com/en/download/)
+- [A fresh copy of Moolah Project Template](https://github.com/MoolahModding/MoolahProject)
+
+
+### File Preparation
+
+First things first, grab a fresh copy of MoolahProject template and extract it. If your mod is going to be a BP mod, please check the notes at the end for a Legal Warning.
+
+Run the Moolah Template's PAYDAY3.uproj once, go to Editor Preferences > Source Code, set it to Visual Studio 2019. Close Unreal Editor.
+Go to your new empty Moolah Template folder, go to `MoolahProject-main\Plugins\Engine\Plugins\Wwise\Source\AkAudio\Public\` and grab `ESBZAkPoolType.h` and copy it somewhere safe for now.
+Delete the entire Wwise folder in `Plugins\Engine\Plugins`.
+
+Open the Wwise launcher, install the SDK for windows on the version 2021.1.13.8036 - you will have to modify your current install.
+Once that finishes, go to the Unreal tab in the Wwise launcher, click the hamburger menu and go for "Download Wwise integration to use as an engine plugin"
+
+![WwiseEnginePlugin](assets/wwiseengineplugin.png)
+
+:::note
+Default install version is different, don't forget to change the Wwise version from 2022 to 2021.1.13.8036 and Unreal engine version to 4.27.
+:::
+![WwisePluginDownload](assets/engineplugindownload.png)
+
+Once the download is done, go to the folder you downloaded into, grab the entire Wwise folder and paste it under `MoolahProject-main\Plugins\Wwise`.
+In that `MoolahProject-main\Plugins\Wwise` folder, make a new folder called `ThirdParty`.
+
+Go to the SDK from Wwise installation, by default in `C:\Program Files (x86)\Audiokinetic\Wwise 2021.1.13.8036\SDK`
+Copy the following folders from the `C:\Program Files (x86)\Audiokinetic\Wwise 2021.1.13.8036\SDK` folder to the `MoolahProject-main\Plugins\Wwise\ThirdParty` folder:
+
+
+        include
+        Win32_*
+        x64_*
+
+You'll be copying a total of 11 folders.
+
+Get the `ESBZAkPoolType.h` you copied earlier and place it in `MoolahProject-main\Plugins\Wwise\Source\AkAudio\Public`
+
+### Rebuilding Unreal Editor
+
+Right-click the PAYDAY3 .uproject and click Generate Visual Studio project files.
+Once that's done, open the PAYDAY3.sln with Visual Studio 2019 and hit build.
+
+If Visual Studio says the solution is incompatible, save the following code block as VS19.vsconfig and Import Config on your vs install
+```
+{
+  "version": "1.0",
+  "components": [
+    "Microsoft.VisualStudio.Component.CoreEditor",
+    "Microsoft.VisualStudio.Workload.CoreEditor",
+    "Microsoft.VisualStudio.Component.NuGet",
+    "Microsoft.Net.Component.4.6.1.TargetingPack",
+    "Microsoft.VisualStudio.Component.Roslyn.Compiler",
+    "Microsoft.VisualStudio.Component.Roslyn.LanguageServices",
+    "Microsoft.VisualStudio.Component.FSharp",
+    "Microsoft.ComponentGroup.ClickOnce.Publish",
+    "Microsoft.NetCore.Component.DevelopmentTools",
+    "Microsoft.Net.Component.4.8.SDK",
+    "Microsoft.Net.Component.4.7.2.TargetingPack",
+    "Microsoft.Net.ComponentGroup.DevelopmentPrerequisites",
+    "Microsoft.Component.MSBuild",
+    "Microsoft.VisualStudio.Component.TextTemplating",
+    "Microsoft.VisualStudio.Component.SQL.CLR",
+    "Microsoft.VisualStudio.Component.ManagedDesktop.Core",
+    "Microsoft.Net.Component.4.5.2.TargetingPack",
+    "Microsoft.Net.Component.4.5.TargetingPack",
+    "Microsoft.Net.Component.4.TargetingPack",
+    "Microsoft.Net.Component.4.5.1.TargetingPack",
+    "Microsoft.Net.Component.4.6.TargetingPack",
+    "Microsoft.Net.ComponentGroup.TargetingPacks.Common",
+    "Microsoft.NetCore.Component.Runtime.3.1",
+    "Microsoft.NetCore.Component.Runtime.5.0",
+    "Microsoft.NetCore.Component.SDK",
+    "Microsoft.Net.ComponentGroup.4.6.1.DeveloperTools",
+    "Microsoft.Net.Component.4.6.2.TargetingPack",
+    "Microsoft.Net.ComponentGroup.4.6.2.DeveloperTools",
+    "Microsoft.Net.Component.4.7.TargetingPack",
+    "Microsoft.Net.ComponentGroup.4.7.DeveloperTools",
+    "Microsoft.Net.Component.4.7.1.TargetingPack",
+    "Microsoft.Net.ComponentGroup.4.7.1.DeveloperTools",
+    "Microsoft.Net.Component.4.8.TargetingPack",
+    "Microsoft.Net.ComponentGroup.4.8.DeveloperTools",
+    "Microsoft.VisualStudio.Component.VC.CoreIde",
+    "Microsoft.VisualStudio.Component.Windows10SDK",
+    "Microsoft.VisualStudio.Component.VC.Tools.x86.x64",
+    "Microsoft.VisualStudio.Component.Graphics.Tools",
+    "Microsoft.VisualStudio.Component.VC.DiagnosticTools",
+    "Microsoft.VisualStudio.Component.Windows10SDK.19041",
+    "Microsoft.VisualStudio.Component.ManagedDesktop.Prerequisites",
+    "Microsoft.VisualStudio.Workload.ManagedDesktop",
+    "Microsoft.VisualStudio.Component.VC.Redist.14.Latest",
+    "Microsoft.VisualStudio.Component.VC.ASAN",
+    "Microsoft.VisualStudio.Workload.NativeGame"
+  ]
+}
+
+```
+![VS19Modify](assets/vs19.png)
+
+### Finally, getting Wwise and Unreal Editor to integrate
+
+After building is done, launch the uproject. While loading, it might prompt you to replace the existing initbank:
+![initbank](assets/wwiseerror.png)
+
+Say no to this prompt.
+
+After UE fully launches and you're looking at the empty map, UE will ask if you want to change the WWise settings. Say no to this prompt as well.
+
+
+Tab back to Wwise, launch 2021.1.13.8036 version. In the Project Launcher, make a new project. Location doesn't matter. Open up the project, go to Project>Project Settings>Source Settings and change the default conversion settings to PCM Autodetect high.
+
+![Project Settings](assets/wwiseprjs.gif)
+
+Save your project afterwards.
+
+
+Shut down Unreal Editor, go to `MoolahProject-main\Content\Wwise\` and delete everything inside.
+
+Relaunch Unreal Editor. Say No to the Wwise settings prompt again. Go to project settings, scroll all the way down to Wwise section and click Integration Settings.
+
+Set Wwise sound data folder to `WwiseAudio` and set the Wwise Project to wherever you set your project back in the actual Wwise program.
+
+![Integration](assets/uewwise1.png)
+
+Ignore the restart prompt if UE asks for it. Go back to Project Settings > Wwise > integration, untick "Use Event-Based Packaging". It might throw you some errors, just click OK through everything.
+
+Click User Settings below the Integration Settings and tick `Auto Connect to WAAPI`. Go back to Integration Settings and double check if the WwiseAudio folder is still there. If not, enter it again. Re-tick `Use Event-Based Packaging`. Say OK to Unreal Editor asking you to delete the InitBank.
+Restart Unreal Editor. After the restart, Wwise audio folder will get populated with a bunch of subfolders. Head back into Project Settings > Wwise > User Settings, check if the "Auto Connect to WAAPI" got unticked. If it did, tick it again. Then tick "Enable Automatic Asset Synchronization".
+
+In your Wwise project, create a new event, check if it populates inside Unreal Editor. If it does, you've integrated it successfully.
+
+## Basic Project Flow 
+### First Steps
+For adding a custom sound, it goes something like this:
+1. Open Wwise.
+2. Import audio file under Actor-Mixer Hierarchy.
+3. Set up an event to use the audio. If you want to replace an existing event's audio, name it exactly as it appears in Fmodel.
+4. Go to the sound banks tab and create a sound bank.
+5. Hit F7 for sound bank view
+6. Drag the created event from the bottom left into the soundbank.
+7. Click Generate All, then save your project.
+
+Once in Unreal Editor, create an AKBank with the EXACT same name as the sound bank in Wwise.
+![akbank](assets/akbank.png)
+
+:::caution If the file names don't match, you won't get the audiobanks inside Unreal Editor.
+:::
+
+1. Find the Event created earlier under `WwiseAudio\Events\<EventStructure>`.
+1. Double click the event and set it to use the modded soundbank.
+1. In the WAAPI picker (Window>WAAPI Picker), hit Generate Sound Data.
+1. Right click your event and hit play event - if done correctly, it should play inside the editor.
+1. If you connected Wwise to Unreal Editor via localhost inside the Wwise program with Profiler > Show Remote Connections, it should update all your directories and create a Media folder with your .wem file in `MoolahProject-main\Content\WwiseAudio`.
+1. Use the event as you normally would use an AKEvent within the Unreal Editor.
+
+### Using Main Buses to tie Custom sounds to In Game Audio levels
+You can place dummy Audio Buses in Wwise to tie your audio's volume to in game sliders.
+![Busses](assets/bus1.png)
+
+Currently, game uses these Buses, taken from Fmodel:
+
+![busses_in_game](assets/bus2.png)
+
+Replicate them in Wwise and you're good to go.
+
+### Sharing your BP mods with custom audio source code
+
+:::note Due to legal reasons, do NOT share the WWise Plugin folder
+:::
+
+Make sure git ignores `<Project>\Content\Plugins\Wwise`.
+
+Your sounds events will be playable by others if you include the WwiseAudio\Events and WwiseAudio\Media folders along with your Soundbank with no issues.