Skip to content

Home

Jump to bottom
Han Stiefel edited this page Oct 14, 2018 · 4 revisions

Music Choices

Welcome to the Music Choices Wiki! Here I'll provide some instructions and directions about what this mod does and how to use it.

Table of Contents:

Description

This mod gives you more control over when and where music tracks play. It lets you add music files that play in very specific situations. They can play based on things like biome, light level, and dimension. The can also play when a certain event happens, like when you die, or when you get an achievement.

Installing and Setting Up

First of all, here are some quick tutorials for setting up the mod.

List of All Types to Add in sounds.json

Here is a list of all of the json tags you can add in the sounds.json file to change where the music plays.

Name Description
"overlap" If this is true, when this music plays it will not stop any music currently playing. It's mostly useful for "event" music like the achievement music.
"priority" This is the priority of this song being chosen. If multiple songs can play in a certain scenario, a song with a higher priority will always be chosen.
"menu" If this is true, the music track will only play in the main menu.
"credits" If this is true, the music track will only play when the credits run.
"boss" This music track will play when you fight a boss of the specified NBT. The track will play when you look at the boss and will continue until you move away from the boss or you kill it.
"boss stop" This music track will play when the above boss music ends without a victory (when the entity despawns or moves into an unloaded area).
"victory" This music track will play when you kill a boss of the specified NBT. Plays when the tracked boss dies. Could be a "conclusion" victory jingle for the above boss music.
"battle" This music track will play when fighting a certain type of mob. The track will play when you hit the entity or the entity hits you, and will continue as long as there are entities of that type within a certain distance of you (by default 8 blocks).
"battle blacklist" This battle track will play when fighting every entity (well, by default only monsters) except the entities in this list.
"battle stop" This music track will play when you finish fighting a certain type of mob and the battle music ends (regardless of why it ends).
"achievements" Plays a music track when you get the specified achievements.
"event" The music track will play when a certain event happens. Note that it works with the biome/dimension/etc. conditions.
"creative" Specify if you should be in creative mode for this music to play. True means only creative mode, false means only adventure/survival mode, and any means any gamemode.
"biomes" The music tracks will only play if you are in the specified biomes.
"biome blacklist" The music tracks will not play if you are in the specified biomes.
"biome types" The music tracks will only play if you are in the specified forge biome types.
"biome type blacklist" The music tracks will not play if you are in the specified forge biome types.
"dimensions" The music tracks will only play if you are in the specified dimensions.
"dimension blacklist" The music tracks will not play if you are in the specified dimensions. Useful for mods like Mystcraft that add dimensions dynamically (so you can add music tracks that play in those but not the overworld and such).
"lighting" Specify what lighting you want this music to play in. Music marked "day" and "night" will play during daytime and nighttime repsectively (regardless of place or light level). "sun" and "moon" will specifically play in daylight and moonlight, and "light" and "dark" will play in light and dark areas when not in sunlight/moonlight (so indoors/underground).
"time" Specify what time you want this music to play. Music marked "day" will play during the day and "night" will play during the night.
"weather" Specify what weather you want this music to play in. Note that it doesn't matter if you are in a snowy area or desert, it depends on the global weather (what you get when you use /weather rain and such).
"height minimum" Specify the minimum height you want this music to play in.
"height maximum" Specify the maximum height you want this music to play in.

List of Options to Add in sounds.json

Here is a list of all of the options you can add in the sounds.json file. Note that they mirror the options in the config file (this is a way of modifying the options per resource pack if you share it, so whoever downloads the resource pack doesn't have to mess with the config file).

Name Type Default Description
"maximum background tracks" Integer, > 0 3 The maximum number of background tracks that can play at once (only one will be at full volume at a time).
"maximum overtop tracks" Integer, > 0 1 The maximum number of tracks that can play over top of the background music at once.
"background fade" Float, > 0.0001 and <= 1.0 0.4 How much the background music will fade to when something is playing over top of it. Note this is only when 'overtop' is true; otherwise it will fade to almost nothing.
"fade strength" Integer, >= 0 5 How fast the background music fades when it changes volume.
"menu music delay minimum" Integer, >= 0 20 Minimum menu music delay.
"menu music delay maximum" Integer, >= 0 600 Maximum menu music delay.
"ingame music delay minimum" Integer, >= 0 1200 Minimum ingame music delay.
"ingame music delay maximum" Integer, >= 0 3600 Maximum ingame music delay.
"play vanilla" Boolean (true/false) true Play vanilla tracks as default if nothing else is found for the current situation.
"stop tracks" Boolean (true/false) true Stop any background tracks that no longer apply (for instance when you move to a biome where it should no longer play) and attempt to play something new.
"battle max distance" Integer, > 0 8 The distance an enemy should be away from you for battle music to stop.
"battle music for only monsters" Boolean (true/false) true Only apply blacklisted battle tracks to entities considered monsters.

Copyright by Han

Menu

Clone this wiki locally