USTManager

Successor of UKMusicReplacement and built from scratch, USTManager allows you change the soundtrack of ULTRAKILL and even sound effects.

Usage

When the mod is installed, open the option menu, go to Audio and you will see a new option called "USTManager". Click on it and you will see a list of all available USTs. Click on the USTs you want to select then "Ok".

If multiple USTs conflict (for example if UST A and UST B both replace the same song), the Conflict Resolution screen will open. The first selected UST will be the one that will be used if you don't change anything. Use the Dropdown to change the UST used for that song.

To make your own UST, go to your game folder if the mod was launched at least once with the mod, there should be a folder named "USTs" (this is where you put all your USTs) and another one inside called "Template". use this one as a template for your USTs. Further instructions are in the template and the readme file inside.

You can also use USTMaker if you are on Windows to create and edit USTs.

Changelog

1.5.4

• Added experimental config option UpdateBasedSwappingEnabled. Enabling this should allow you to change most sounds without issues but comes at the cost of performance. To enable it, navigate to your BepInEx config, open dev.zeddevstuff.ustmanager.cfg and set UpdateBasedSwappingEnabled to true.

1.5.3

• USTManager will now load USTs in the plugin folder on top of the USTs folder. Which means all those shitty "mods" on thunderstore that depend on USTManager should work now

1.5.2

• Fixed command registration issues

1.5.1

• Updated the mod for Patch 15

1.5.0

• Attempt to fix the crashing issues (especially with EasyPZ)
• The mod will now save and load the UST you were using the last time you openened the game

1.4.4

• Attempt to fix crashes when sometimes entering levels
• Changed ust.debug command syntax. Now ust.debug <true/false> optional<extended> (so a valid command would be ust.debug true or ust.debug true extended). Extended shows a lot more sounds. Use only if you can't find what you're searching for with the basic mode
• ConflicResolver rewrite/cleanup by The0x539

1.4.3

• (Hopefully) fixed my nemesis, PlayOnAwake AudioSources using the magic of adding an empty component to all AudioSources (it was that easy)
• Fixed a bug preventing loading of two USTs , one with only a global section and the other with only a regular level section (see issue #15)

1.4.2

• Emergency patch to removed an unfinished feature that broke the mod
• Improved support for 1-4 and 4-4, look at the template (thanks The0x539 again)

1.4.1

• Fixed a bug preventing some USTs from merging properly (see issue #11)

1.4.0

• UST file restructuring (thanks The0x539)
• UST file upgrader (It probably won't stay there long so please use it while you can. new USTs should use the new format (see Template))
• New debug UI (thanks The0x539 again)

1.3.1

• Fixed a bug with global merging

1.3.0

• Added Conflict Resolution screen and fixed a bug with the commands due to 14c patch

1.2.1

• Fixed a small issue with the "Open UST Folder" button and bug due to the latest patch.

1.2.0

• Reworked UI a little bit
• Added support for multiple USTs (if multiple USTs conflict, you won't be able to load them for now. Conflict resolver planned for later)
• Replaced delete button with "Open UST folder" button

1.1.0

• Fixed 1-4 and some clips not getting replaced
• Fixed Refresh button and prevented invalid USTs from blocking other USTs