Soundtrack Layering for RPG Maker MV and MZ

THIS PLUGIN WILL NOT WORK WITHOUT SOUNDTRACK MANAGER!

With this plugin, you can layer multiple music tracks, playing all of them at once! Even more powerful than the variable mix feature of Soundtrack Manager, this lets you fade individual parts of music out without fading out the rest!

All layers must be loaded using Soundtrack Manager's LoadBGM command. A base track must be playing when playing a layer. The base track cannot be controlled via "layer" commands, so pick something that you want to be consistent at all times (the track can be silent if you really want.) The base track's loop settings will be used for all layers, so make sure each layer is long enough to cover the loop! 

You can play as many layers as you want at once, so long as your computer can handle it! (Do make sure all layers sound good together, though - your players won't appreciate a horrible cacophony of different tracks playing at once!)

If the base track stops playing, so will all layers.

Commands and their parameters are wrapped into the Plugin Command feature of RPG Maker MZ.

Playing a layer

Plugin command:
PlayBGMLayer trackAlias parameter=value parameter=value ...

Plays the given track over the currently-playing base track. The alias is the one defined in LoadBGM (see Soundtrack Manager for more details).

All parameters are optional. They are separated by spaces, but cannot contain any spaces within them (including before and after = signs). Valid parameters are:

fadeIn

Causes a fade-in effect when the track starts playing. Without this, the track will start at full volume instantly.

fadeTime=5

In seconds, sets how long the fadeIn effect takes. Default value is 1 second.

volume=75

Overrides the volume setting.

pan=-36

Overrides the pan setting.

Playing many layers at once

Plugin command:
PlayBGMWithLayers baseTrackAlias layerAlias layerAlias ...

This command lets you play a bunch of tracks all at once! All must be loaded with LoadBGM before playing. The first track will be set as the base track; all other tracks will be layers. No special parameters can be called for each layer with this command, so set them up appropriately in LoadBGM.

Stop a layer

Plugin command:
StopBGMLayer trackAlias

Simply stops a single layer. The base track and other layers will not be affected by this.

Fade a layer out

Plugin command:
FadeOutBGMLayer trackAlias fadeTime

Causes a single layer to fade out. If a number is provided for "fadeTime", then the fade-out effect will take that long (in seconds); default is 1 second.