Location of/Changing, or Adding Music Files: Knowledge File

-=Confirmed:

   -Directory "C:\Program Files\Steam\SteamApps\common\Shadowrun Returns\Shadowrun_Data\StreamingAssets\win" contains files with sound effects catagorized under audio, but no results for music are to be seen.

   -It is possible to replace the existing music successfully, but it is unknown as of yet as to whether, or not you can add music to the existing list.

-"...you can't add music is because it's too difficult to do using the Unity engine... BUT... he pointed out that he wouldn't be surprised if a clever modder figured out how to do it...". (Quote from "The Godfather" in the steam discussions)

-"Resources.assets.resS is actually just a bundle of multiple ogg files listed one after the other. Use OggExtract to separate them." (Quote from Quibbage101 in the steam discussions).

-=Speculation:

   -"...The reason you can't add music is because it's too difficult to do using the Unity engine... BUT... he (Brian_HBS) pointed out that he wouldn't be surprised if a clever modder figured out how to do it [then you could add custom music..."(Quote from "The Godfather" in the steam discussions).

   -The music files may, or may not be in .ogg format in "...SteamApps\common\Shadowrun Returns\Shadowrun_Data\" in the "resources.assets.resS" file.

   -Our dilemma may be related to a file called music.mlib.bytes in the, "...SteamApps\common\Shadowrun Returns\Shadowrun_Data\StreamingAssets\ContentPacks\shadowrun_core\data\misc", directory.

-=False:

   -Nothing as of yet.



Guide from Zetor:

  Some relevant disclaimers, though:

- This is kind of fiddly, and there are many ways to screw up. Someone will make a tool eventually (and that probably won't be me, sorry... no time :p), but direct hex editing can get messy.

- Obviously this can only be used to REPLACE music instead of add new tracks. It's probably possible to add new entries to the index, but it'll require even more editing of the resources.assets file (not to mention probably some other referencing files)

- Do Not Taunt Happy Fun Ball.


 Now for the guide:

   0] Backup resources.assets.resS and resources.assets.

   1] Use oggextract (ner.mine.nu/oggextract/) on resources.assets.resS to get a bunch of ogg files (29 to be exact). They should have filenames like resources.assets.resS_xxxxxxxx where xxxxxxxx is their offset within the file (this will be important later)

   2] Replace the resources.assets.resS_xxxxxxxxxx you want to replace with any ogg file (128kbps). In my case this was resources.assets.resS_01772d34.ogg

   3] Take a note of the new ogg file's size. In my case it was 22971971 bytes, so 0x015E8643 in hex. Write this down somewhere.

   4] Repack the resources file by doing "copy /b resources.assets.resS*.ogg resources.assets.resS".

   5] Unpack the resources file again (!) with oggextract. Write down the offset of each file that follows your recently-added file (so for me this meant everything after resources.assets.resS_01772d34) -- remember, the offset is the number at the end.

   6] Load up resources.assets in your favorite hex editor. Go to 0x097EEEE0, and find the appropriate index entry by following the format descriptor above. They're in order, so you can just find the n-th file... but to make sure, check that the offset matches of the ogg's offset within the resources.assets.resS file and the size matches the size of the original ogg.

   7] Replace the SIZE field of the index entry with the new ogg's file size. (it's the first one of the three four-byte fields directly at the end of the index entry, ie. before the next song name string) Remember endianness, too. For me this meant writing 43865E01 into 097EF2A0.

   8] For each index entry following your music file, replace the OFFSET with the new offset you obtained in step 5 (offset is the second four-byte field). Again, these should be in order.

   9] Profit [?]

For reference, this is what [Zetor] edited when [Zetor] changed the main menu theme as described above:
https://www.dropbox.com/s/5u6dx1v2apc3yxb/screenshot.181.jpg