### Allows you to customize volume of any music track, including custom BeardLib music.
Sometimes you download custom music and it feels too quite/loud for your usual music volume setting, so you go and adjust it, but then you forget you adjusted it, and when a new track starts playing it blasts your ears or you cant hear anything. This mod will try to prevent these uncomforable situations.
-----
**Note that after installing this mod, your music volume will be set to 20%, to prevent issues.**
#### Is CustomOST supported?
||

CustomOST tracks can be customized, and their volume values will be saved for the next time you play them, BUT you may not be able to listen to them while you are customizing them, or trying to play them in quick menus.
||
#### How does it work?
You go to options->sound->volume mixer and adjust any music track's volume. After that, anytime that track is played it will play at volume that you set it to.
#### Any other features?
* You can use mixer's menu to select any track to play. This way it will be played until you switch it to a different one.
* Additionaly you can select which track phase to play, like assault/anticipation/control. If you select any phase that you enjoy, it will be looped forever until you switch it in the same menus. (Note: 5th phase for 'stealth only' tracks can not be looped forever)
You can also select 'current game phase' so that your track will automatically switch based on assault phases. Whenever you normally start playing tracks they always default to this automatic option.
**__Note__**: tracks that are inappropriate for your heist type will most likely go mute if you play them __in automatic mode__ mentioned above. So if you decide to play Razormind on Shadow Raid, and select 'current game phase' your track will either not play or go mute when your game phase switches. Same happenes for stealth tracks beeing played on normal heists in automatic mode.
#### That mod name is kinda selfish, huh?
||
Well yeah, but it's mostly because code is not that well optimized, and can probably be improved, but it gets the job done. Im hoping that someone will make a better version of this mod someday. But untill that happens, this is (at least from my research) the only mod that gives you this kind of control over your PD2 music library.
||
-----
##### Video preview of customizations/usage:

**Known issues:**
||
* CustomOST tracks are partially broken. Most likely will never be fixed.
* Selecting tracks that are not appropriate to your heist type (for example using stealth tracks on normal heists or vice versa), and using them in automatic mode (named 'current game phase') doesn't work correctly, because stealth track phases work differently from normal track phases. Can't be fixed
* Stealth only tracks dont immediately switch phases, but only after a short delay. 'And Now We Run' is probably the worst, with longest delays. Can't be fixed
* When joining games in progress as client, if you go into the music selection and then back to loadouts, sometimes music will go mute. After getting into the game, music will start playing normally. __Might__ be fixed later
||
-----
Language support:
* English
* Russian
* Simplified Chinese - provided by Arknights
Language is based on your superBLT's language setting.
If you want to help translating this mod:
||
In the lang folder there are different language files, you can copy one of them, translate it and send me translations.
But note a few things: headers have empty space after their names, so text appears in the middle of a button. There's also a '\n' symbol in one line, it's used to go to the new line for that descripton. Makes it look better. It's up to you if you want to keep it or not, check how your translated text looks in game first. When you are done, message me on workshop with text from your translated file, name of the language and also, if you want to have any shoutout links (for example to your steam/workshop profile), mention them in the message.
||
:::**1.0.3**:::
* Fixes to preplanning screen, SHOULD no longer have audio volume jumps when going into loadout/preplanning
* Fixed an issue where phase selector would not work, if used on custom BeardLib music while in menus
:::**Older versions**:::
||
1.0.2
* Fixed an issue where exiting mixer menu in game, while on a preplanning screen, would cause preplanning music's volume to change to whatever your current in-game track volume is set to
* Updated localization files
1.0.1
* Moved auto updates from modworkshop API to github
* Refactored half of this mod, with most changes not beeing really noticable to the user
* Removed main customizaton lists. They were exremely annoying to work with and were slowing development proccess. Also i never found any use for them myself, with how comfy quick menus are, so quick menus are now the only way to use this mod.
* Preplanning screen SHOULD be fixed, and have no issues. Will be as close to vanilla behaviour as possible.
* Pre-game black screen SHOULD no longer play tracks in assault phase mode, unless you were listening to them when game started
* Full mute setting will now actually be a full mute, even in volume mixer menu. If you ever hear music with this setting beeing on please report it, if you can replicate it
* Fixed spamming escape button in the main menu playing music for 0.001 when full mute is enabled
* Fixed stealth only heists using incorrect music volume when heist begins
* Fixed default volume not applying properly on fresh install
* Fixed music fading away when joining lobbies. Please note that when joining games in progress, if you go into the music selection and then back to loadouts, music will go mute. After getting into the game, music will start playing normally
* Fixed potential crashes when quiting mixer options on stealth only heists
0.9
* You can now choose which phase of heist tracks to play with additional settings in quickmenus. Picking any phase option will force that track to play specified phase indefinitely, or until you switch it to another option. Picking 'current game phase' option will switch that track to currently needed phase, and will allow that track to switch phases when required, like how tracks usually switch when assault phase goes from 'anticipation' to 'assault' etc.
* Added a failsafe when getting to the main menu/lobby screens to prevent music volume not getting adjusted right away, and beeing too loud/quiet for a split second. (i am still not 100% sure that you will get proper volume right away, but this should help)
0.82
* Potential fix for wrong track beeing played after you joined an allready started heist
* Added Simplified Chinese lagnuage
0.81
* Added RUS langauge and ability to add new translation files.
||
You can use this code however you want, BUT if you want to port it into another mod, or make a new mixer based on this mod, leave a shoutout to this mod/me with proper links.
Dependencies
-
-
Instructions
**Make sure to first have SuperBLT, and BeardLib installed. Click the links in the dependency list.**
Optional video tutorial for installing SuperBLT, BeardLib, and mod_overrides mods: https://youtu.be/rin_sjSJIkg
1. After downloading the mod, use a program such as [7zip](https://www.7-zip.org/download.html) or [WinRAR](https://www.rarlab.com/download.htm) to extract the main folder of the mod.
2. Drop that folder into the `mods` folder which is supposed to be in the game's installation folder (don't know where that is? click [here](https://wiki.modworkshop.net/books/payday-2/page/finding-payday-2s-install-folder))
Comments