The OriginalSoundTrack Plugin
This mod allows you to play Risk of Rain 1 (or any) music in place of the normal soundtrack.
You must supply your own music files though.
Place the DLLs, settings.xml and your music files in:
Risk of Rain 2\BepInEx\plugins\OriginalSoundTrack
You must supply your own copy of the Risk of Rain 1 soundtrack by placing those files in the same folder as above.
Files can be in .mp3 or .wav format (with those exact extensions).
Make sure the filenames match what's in settings.xml (or edit settings.xml to match your files.)
settings.xml
If your files match all the song "names", then you dont need to do anything else, but feel free to customize.
If the plugin fails to match a song for a scene, it will just choose a random one it found in the plugin directory.
Put scene IDs in the "scenes" attribute to have audio play on that scene in settings.xml.
The scenes attribute is comma separated. A scene only has to be "contained" in the real scene ID for it to match:
("golemplains" in the scene attr will match for the golemplains2 scene id.)
Example for playing MyFile.mp3 on the title screen and main menus:
<song
name="MyFile.mp3"
scenes="title,lobby,logbook"
boss="false"
volume="1"
/>
Setting boss to "true" means that music can only play when the player activates the teleport on a level.
Otherwise music can only play elsewhere (non teleport events).
"volume" is a decimal between 0 and 1.
It's ok to have multiple <song> definitions with the same name or scenes. The plugin will choose a song randomly
among the matching songs.
The top level <volume> tag is the master volume for all this plugin's music. Again, a decimal between 0 and 1.
The top level <loop> tag determines if music should loop or pick another song (from matching songs) after a song ends.
Scene IDs (level IDs).
(As of the hidden realms update)
See here for pictures of the level scenes:
https://riskofrain2.fandom.com/wiki/Environments
Non Levels:
ID Description
===============================================
title - the title screen
lobby - the select character screen.
logbook - view logs screen.
Levels:
ID Level Name / Description
===============================================
bazaar - Bazaar Between Time (The Shop)
blackbeach - Distant Roost
golemplains - Titanic Plains
foggyswamp - Wetland Aspect
goolake - Abandoned Aqueduct
frozenwall - Rallypoint Delta
wispgraveyard - Scorched Acres
dampcavesimple - Abyssal Depths
shipgraveyard - Siren's Call
arena - Void Fields (poison area with lots of "teleport" events.)
mysteryspace - A Moment, Fractured (the place where you can obliterate yourself.)
limbo - A Moment, Whole (the mega scavenger boss)
goldshores - Glided Coast (the place where you fight the golden Stone Titan)
Other Info
This plugin uses NAudio.dll https://github.com/naudio/NAudio to help load and play music at runtime.
This is done to make it very easy for players to supply their own music. The downside is that the normal in game
music isn't disabled (Maybe there is a way to do that, I dunno). To get around this, this plugin sets your in game
music volume setting to 0. It tries to set it back to where it was when the game closes but I'm not sure if this works.
Anmyway you have been warned.
Licence
When applicable, assume stuff is under the MIT licence ( https://opensource.org/licenses/MIT )
I am not liable for any damages and there is no warranty etc...
