How to change sound files

[Maisa Kuutonen]

Hi! I'd like to make a mod for myself that replaces some of the music files. How can I do this? Try to explain step by step like I was a child.

[Brady_The]

19 hours ago, Maisa Kuutonen said:

Hi! I'd like to make a mod for myself that replaces some of the music files. How can I do this? Try to explain step by step like I was a child.

Somebody prepared a template for this case: https://mods.vintagestory.at/templateformusicadditions

Starting with this will make it a bit easier. Download and unzip the file. Follow the instructions till "Navigate to ...".

Now you write "replace some files". If you really just want to replace a couple of files, it'll be much easier to not use the subfolder as done in the template, but to overwrite the default Vanilla music files. This is rather crude, but is much easier than writing a patch that surgical removes some music tracks from the musicconfig.json file (which essentially contains the playlist).

In this case navigate to the installation folder of Vintage Story -> assets -> survival -> music, write down the names of the music files you want to replace, add your music files straight into the music folder of the Music Pack Template (not the subfolder) and name them accordingly. In the example below I would replace the original daylight.ogg file with my own custom one.

Spoiler

After you have done this with all the tracks you want to replace, skip to the last step of the template guide and follow it. Unless you are not interested in sharing the mod - zipping the files just makes the sharing easier. The game doesn't require zip files to recognise mods.

If you want to replace all music files, you can essentially follow the template guide, with the small addition of changing a little detail in your "musicconfig.json". Replace the word addmerge with replace. This will overwrite the original musicconfig (or playlist), instead of just adding to the end of it.

If you do not want to replace any music, but rather just add to the Vanilla playlist you can follow the whole template guide step by step.

If you have any questions, feel free to ask them either here or in the mod page - the latter would help the author to improve the template, but either is fine to me.

In case you are asking yourself, why the Vanilla music is contained in a "survival" folder but your music files are in a "game" folder - good question and eyes. That's because "game" on the mod side acts like an all-encompassing stand-in for all folders in the Vintage Story directory.

Edited Saturday at 09:16 AM by Brady_The

[Maisa Kuutonen]

Hey thanks a million! This is perfect! I have only a couple of songs I want to replace so this is going to be a lot easier than I thought. 

[Brady_The]

One small detail I forgot to mention: If you do not plan on sharing the mod, you can skip the zipping part. This is just for convenience and not required for a detection in the game.

[Maisa Kuutonen]

Ok! I can't share the mod because copy rights. They are actually couple of Minecraft tracks I'll change. The "Dreiton" is so unbelievably relaxing in creative mode.