the ultimate guide to modding audio on JSB (Steam/Windows)
Note: THIS DOES NOT WORK ON CURRENT VERSION!!!
requirements:
a copy of Just Shapes & Beats version 1.4.17 or lower (check text modding tutorial for downgrading)
(note: the Manifest ID is 842755276121974634)
Unity Assets Bundle Extractor (UABE)
https://github.com/SeriousCache/UABE/releases/tag/2.2stabled
(if windows blocks you from installing it, turn off all of your antiviruses - it's a false positive)
the audio file you want to mod in (WAV format)
unity version 2017.3.0f3
https://unity.com/releases/editor/archive
optional:
three empty folders (i'll be using this for the tutorial)
Notepad++
___________________________________________________________________________________________________________
welcome back to modding for noobs. this one is a bit more tricky, but I'll try to dumb it down as much as possible
___________________________________________________________________________________________________________
part one: setting up
open UABE, click on File, and select Open. find your JSB directory and go into JSB_Data > StreamingAssets > AssetBundles
inside are four folders with all the audio files for the game. you may select any, but for this example I'm going to modify a level's song - so in the levels folder.
inside the folder are many files. for this example, we're going to select Annihilate, labeled "music_destroy_annihilate" (not the .manifest file)
UABE will ask you to unpack it. we will select yes. save it to a folder (maybe name it folder 1, or something)
keep the name of the file the same
now on UABE still, select Info on the bottom right of the window for it to open up another window with the list of assets inside the file
click on the one listed as "AudioClip" (or, for this example, the one with the name "mus_destroy_annihilate")
select Plugins on the bottom right and export the audio somewhere (or in folder 1)
now go to your newly extracted file and copy the name of it. assuming you have your audio that you want to mod in, rename it to that extracted file.
(for this example it's "mus_destroy_annihilate-CAB-514ef19ecff4964c3517f432a2659a31-17267161452157809131")
go back into UABE, select the AudioClip again, but this time click Export Dump and save it to a folder (or folder 1)
you may minimize UABE for now
___________________________________________________________________________________________________________
part two: the hard part
it's now time to open Unity
create a new 3D project, name it whatever you want
once it's all loaded up, drag the audio you want to mod in into the bottom of the window. once it's in there, drag it into the scene with the camera and sun
now go to the top left of the window and select File, then Build Settings, then click Build
name the .exe the same as whatever you named your project
personally, I'll save this in the same place as the project itself, for convienence (like, make an entirely new folder for them both, which I'll call Folder 2)
after you're done with that, save your project and close Unity
you may have noticed after building, it opened up a file explorer window with your project. keep that open and reopen UABE
select File and Open again and go to that directory where your project is (I'd copy and paste it from your other window)
go into your Data file and select "sharedassets0.assets" (not .resource)
select your AudioClip file and click Export Dump
save this to a brand new folder (which I'll name Folder 3)
now go back to your Unity project file and grab the .resource version of the sharedassets file and rename it to literally anything (as long as it stays .resource)
place the .resource file in your JSB_Data folder
you may minimize UABE again
open your new folder and open the newly extracted file with notepad (or Notepad++)
rename the text with "sharedassets0.resource" with the same name as the .resource file you just renamed, as long as .resource is at the end
you may close your window and go back to folder 3
select the name of the file and delete the "-sharedassets0.assets-4-AudioClip" part
___________________________________________________________________________________________________________
part 3: implementing the mod
go back into UABE and reselect the JSB file in folder 1
reselect the AudioClip file in there but now select Import Dump
click on your dump in folder 3
select OK to save
now save all changes by clicking on File, then save it to Folder 3
make sure it's named the same
now we are going to recompress the file to make sure it works
reselect File, then Compress
select your file in Folder 3 and click OK
save it to your Desktop for easy access
you may close UABE now
go back to where you found the file in the first place in your JSB directory and place your newly compressed file in there
