Contraplayingmodded-ContraSoundTrack icon

ContraSoundTrack

A music mod that utilises MMX and random music for the game's soundtrack!

Last updated a month ago
Total downloads 225
Total rating 1 
Categories Audio Client-side
Dependency string Contraplayingmodded-ContraSoundTrack-1.0.0
Dependants 0 other mods depend on this mod

This mod requires the following mods to function

bbepis-BepInExPack-5.3.1 icon
bbepis-BepInExPack

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 5.3.1
Kyle-OriginalSoundTrack-1.2.0 icon
Kyle-OriginalSoundTrack

A mod that allows you to play Risk of Rain 1 (or any) music in place of the normal soundtrack.

Preferred version: 1.2.0

README

This mod will swap out the game's soundtrack for music from throughout the Mega Man X and a little from the Contra series. The songs are as follows: # Menus etc #

Splash Screen - None
Intro - Mega Man X1 Zero introductions
Title Screen - Mega Man X2 Title Theme
Char. select - Mega Man X1 Stage Select
Logbook and other menus - Mega Man X4 Stage Select

# Stages #
Distant Roost - Commander Yammark (X6)
Titanic Plains - Contra 4 Stage 1 [Normal mode]
Wetland Aspect - Axle the Red  (X5)
Abandoned Aquaduct - Gerudo's Theme Remastered
Rallypoint Delta - Original ROR2 Soundtrack
Scorched Acres - Burn Dinorex (X5)
Abyssal Depths - Blaze Heatnix (X6
Abyssal Dephts Boss - Hotter Than Hell (Contra Rebirth)
Siren's Call - Commander Yammark (X6)
Sundered Grove - Spike Rosered (X5)
Sky Meadow - Original ROR2 Soundtrack
Moon - Schala's Theme Remix
Bazaar - Mega Man X1 Dr. Light's theme
Bosses - Contra 4 Tunnel Boss Theme
Aurelionite - Manowar: Warriors of the World
Mithrix - Judas Priest: Valhalla Live Instrumental


# Special areas #
Bulwark and Void Fields - Zero 2 (X5)
Obelisk - Conspiracy (X2)
Limbo and above bosses - Zero Virus (X6)


This update patches in the correct music for the Sundered Grove, both regular and boss theme.

(The following is the original readme, as it explains how this mod for a mod actually works!)

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 and settings.xml in: Risk of Rain 2\BepInEx\plugins\OriginalSoundTrack

Your music files can either go in the same directory or you can specifiy a directory in settings.xml (using the <music-path> tag).

Music 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.)

If you delete settings.xml, don't match your filenames with <song> tags, or delete all <song> tags, then the plugin will just choose random music it found.

settings.xml

If your files match all the song "names", then you don't 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,crystalworld,eclipseworld"
    boss="false"
    volume="1"
/>

Setting boss to "true" means that music can only play when the player activates the teleport on a level (or on the final boss fight). 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.

The top level <music-path> tag specifies where the plugin should scan for music. It does not traverse down directories. The default path it scans for music is: Risk of Rain 2\BepInEx\plugins\OriginalSoundTrack

Scene IDs (level IDs).

(As of the 1.0 update)

See here for pictures of the level scenes: https://riskofrain2.fandom.com/wiki/Environments

Non Levels:

ID                 Description
===============================================
splash         -   "hopoo games" image
intro          -   intro cutscene
outro          -   outro cutscene
title          -   the title screen
lobby          -   the select character screen.
logbook        -   view logs screen.
crystalworld   -   prismatic trials menu (not normally reachable in modded RoR2)
eclipseworld   -   eclipse menu

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
skymeadow      -   Sky Meadow
moon           -   Commencement (Final Level)

artifactworld  -   Bulwark's Ambry (Artifact Challenge arena where you unlock the artifacts with keys.)
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. Anyway 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... I do NOT own any of the music/songs.

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2021-9-17 1.0.0 225 Version 1.0.0 Install