** Skip ahead if you just want information on what the mod does. **
I'll be completely honest: Minecraft music simply doesn't do it for me. There's no spirit to them, and they are completely uninterested in what you the player are up to in the world you're immersed in. One of the first mods I played with to rectify this problem was called MusicChoices, and it scratched the itch with the utmost finesse - until I updated beyond its scope, and it couldn't follow me.
Unable to go back to Minecraft's sad and haunting tune after I had experienced music that helped weave life into my gameplay, I sought out an alternative. I ran into a mod called Ambience, which more or less made itself out to be a watered down version of MusicChoices. I downloaded it after finding nothing better available, because I thought that it would surely be better than nothing. I thought wrong.
Ambience was riddled with obscene and ridiculous bugs and shortcomings, the most glaring of all being that it would literally crash the game every ten to fifteen minutes. There was barely any functionality, the volume control was defunct, and the author had completely ignored the issue tracker for months. I found myself in a situation - I would either need to use this broken mod, give up on music in Minecraft. I chose the third option - learn java and do something about it myself.
At first I downloaded the source of Ambience and fixed nearly all of its problems without having any prior experience with modding or java. Having been successful, I decided to write a new mod from the ground up, designed exactly how I'd want it to be. I called it ActualMusic. I beta tested it for a month with a couple of friends, and now I have it at a place where I'm comfortable releasing it to the world.
*****
ActualMusic is a mod that replaces vanilla Minecraft's bland music with any music you want, for almost any in-game setting and situation. There's very little config-tampering required to set the mod up - just throw some music in the folder it provides and it'll play it when the time is right!
Additionally, it creates little "title cards" that pop up when you enter a new area, telling you where you are (like how some RPGs used to).
Name the mp3 files you put in the folder a specific (set of) keywords that the mod recognizes and you're good to go. You don't need to add each song to the config file!
The following section is the help documentation, also provided for you in a help section contained in Settings.cfg. If anything is unclear or if you have any other questions, I'll be happy to answer them. Please head on over to the Discord server I set up,
right here! I'll try to check in on this site too, but I make no promises - I have the memory span of a fish.
*****
# Important Note : At this point in time, only mp3 files are supported.
# Simply put, don't try to use oggs or other types.
# Reference : This mod doesn't require configuration for what song is played when. It's done automagically based on filenames!
# Below is a reference of the different filenames ActualMusic looks for when picking a song. Name your files accordingly!
#
# All of the below follow these general rules:
# 1> You may append a number in square brackets to the end to allow randomly picking from multiple songs,
# as long as you don't include a version without the square brackets, i.e. "Title[1]" and "Title[2]" with no "Title".
# Using this rule, make sure you start counting from 1, not 0. 0 will not be accepted!
# 2> You may include subfolders within the music folder called AltDay[#], where # is a number starting at 2 and
# going as high as 99. Inside these folders you may put alternate versions of songs that you want to have played
# every x number of days, x being the number of AltDay folders plus 1. So if you have a folder called AltDay[2]
# in your music folder with Fishing in it, every second minecraft day the Fishing song will be chosen from that
# folder instead of the main one. Any songs not found in an AltDay folder will fall back on the main folder.
# Including AltDay[1] will work, but it will override the main folder. It could be useful if you wanted the
# main folder to only be used as a fallback for AltDay folders that don't have a specific song. 0 won't be accepted.
# 3> (WIP, NYI) You may include subfolders within the main folder and AltDay folders called Dimension(#), where # is the dimension
# you want to have choose from a pool of music that otherwise follows the exact same rules already stated. For example,
# if you had Twilight Forest set up as Dimension 6, you would make a folder called Dimension(6) and put event and area
# songs such as Rain, LowHP, Underground, and so on. When in the Twilight Forest, the music would be chosen from that folder.
# 4> The priority for choosing music is as follows:
# = First, the AltDay folder is selected (if applicable).
# = Then, the Dimension folder is selected (again, if applicable).
# = Then, if there are AltDay folders within the Dimension folder, they will be selected. (Why would you do this?)
# = Finally, the song that has been chosen will be searched for within that folder.
# = If it can't be found, it will backtrack one folder and try again, repeating until reaching the main folder.
# 5> You may substitute an mp3 file with a txt file containing special instructions on where to search for the
# song you want played. Any of the following will work:
#
# ignore
# Pretends the mp3 isn't there, and tries the next song. Useful if you don't want a song to play but don't want to delete the mp3.
# redirectFolder:###
# Changes the active folder to the one specified. Useful if you want two AltDays to have the same song for an event, like LowHP.
# redirectFile:###
# Uses the specified song for the event instead. Useful for if you want two events to have the same song, i.e. LowHP and Horde.
#
# It's worth noting that these commands are case-sensitive, and you may combine redirectFolder and redirectFile if you want.
#
# Generic
# > Played when no other song is available. If left out, no music will play when a suitable song couldn't be found.
# > Can also include GenericDay and GenericNight, but some songs (Underground, Stronghold, etc) can only use the basic Generic.
#
# Title
# > The song that plays on the title screen. Doesn't get replaced with Generic. If there are AltDay versions of Title,
# > they will be played if you quit the most recent game you played on that day.
#
# Boss
# > Plays when you're currently fighting a boss (who's healthbar shows at the top of the screen.
# > Can include the name of the boss without spaces, i.e. BossEnderDragon, BossWither
#
# LowHP
# > Plays when you're close to death.
#
# Bed
# > Plays when you get into a bed.
#
# Stronghold
# > Plays when you're inside the stronghold.
#
# OceanTemple
# > Plays when you're inside an ocean temple.
#
# NetherFort
# > Plays when you're inside a nether fortress.
#
# Ravine
# > Plays when you're below y 40 but exposed to the sky.
# > Can also be: RavineDay, RavineNight
#
# Horde
# > Plays when there are 8 or more enemies currently aggressive towards you.
#
# Home
# > Plays when you're within the specified home coordinates.
# > Can also be: HomeDay, HomeNight
#
# Zone###
# > Plays when you're within the specified user-defined zone.
# > Can also be: Zone###Day, Zone###Night
#
# Fishing
# > Plays when you have a fishing rod cast.
# > Can add Low, Med, High to it to reflect your fishing success rate, i.e. FishingLow, FishingHigh
# > Can also include Day or Night, i.e. FishingDay, FishingLowNight
#
# Riding
# > Plays when you're currently riding a mount.
# > Can include the name of the mount without spaces, i.e. RidingHorse, RidingBoat
# > Can also include Day or Night, i.e. RidingDay, RidingHorseNight
#
# Underwater
# > Plays when you're under water (a tiny pond won't do, you need to be deep enough).
# > Can also be: UnderwaterDay, UnderwaterNight
#
# Raining
# > Plays when it's raining where you are.
# > Can also be: RainingDay, RainingNight
#
# Storm
# > Plays when there's a thunderstorm. Does not require you to be in the rain.
# > Can also be: StormDay, StormNight
# > Will fall back to Raining if there's no song for storms, but only if you're in the rain.
#
# Snowing
# > Plays when it's snowing where you are.
# > Can also be: SnowingDay, SnowingNight
# > Will fall back to Raining if there's no song for snow.
#
# Snowstorm
# > Plays when there's a storm where you are, and it's snowing.
# > Can also be: SnowstormDay, SnowstormNight
# > Will fall back to Snowing if there's no song for snowstorms.
#
# Sandstorm
# > Plays when there's a storm and you're in a sandy biome.
# > Can also be: SandstormDay, SandstormNight
# > Will fall back to Storm if there's no song for sandstorms.
#
# Underground
# > Plays when you're underground.
#
# DeepUnder
# > Plays when you're nearing lava/diamond level.
# > Will fall back to Underground if there's no song for DeepUnder.
#
# HighAltitude
# > Plays when you're on the tallest mountains.
# > Can also be: HighAltitudeDay, HighAltitudeNight
#
# Village
# > Plays when you're nearby at least 3 villagers.
# > Can also be: VillageDay, VillageNight
#
# Dimension(#)
# > Plays when in the specified dimension number.
# > # must be replaced with a non-zero number, i.e. Dimension(-1) for Nether, Dimension(1) for End.
#
# BiomeType###
# > Plays when in one of the following specified forge biome types.
# > ### must be replaced with one of the following forge biome types. This is not for individual biomes.
# > Can also include Day or Night, i.e. BiomeTypeMesaDay, BiomeTypePlainsNight
# >>> Spooky
# >>> Magical
# >>> Mesa
# >>> Mountain
# >>> Sandy
# >>> Snowy
# >>> Wasteland
# >>> Swamp
# >>> Forest
# >>> Hills
# >>> Plains
# >>> Beach
# >>> Ocean
#
# Biome###
# > Plays when in the specified biome.
# > ### must be replaced with the name of a specific biome, not including spaces.
# > Can also include Day or Night, i.e. BiomeRoofedForestDay, BiomeIcePlainsSpikesNight
#
#
# Note on Day/Night:
# If you define a Day but not a Night, it will play GeneralNight or General instead.
# The reverse is also true.
#
#
# Commands :
# > /actualmusic, /am, /music
#
# > /actualmusic fix
# This will, if possible, fix a rare bug where the music has stopped playing and will not start again.
# > /actualmusic mute [true|false]
# Stops the music player (the song will have to fade out first).
# > /actualmusic lock [AltDay number]
# Prevents the music from changing per-day, locking it to a single folder.
# Omitting the argument or providing 0 will unlock the folder. 1 locks to the main folder if AltDay[1] doesn't exist.
# > /actualmusic titlecards [true|false]
# Enables / Disables location title cards.
# > /actualmusic home <spawnradius|north|east|south|west|top|bottom|dimension> [radius|x|y|z]
# Sets up the location where the Home music will play.
# Using spawnradius without another argument will find out how far from your spawn you are and use that.
# Using one of the other options without another argument will use your current position.
# > /actualmusic zone <zone number> area <north|east|south|west|top|bottom> [x|y|z]
# Sets up the location where a user-defined zone's music will play.
# Excluding the last argument will use your current position.
# > /actualmusic zone <zone number> data <title|subtitle> [data]
# Sets up the title card data for a user-defined zone.
# Excluding the last argument will delete the specified data.
# > /actualmusic dimcard [dimension] <title|subtitle> [data]
# Sets up a custom title card for a dimension.
# Excluding the second argument will use the current dimension.
# Excluding the last argument will clear the title data.
# Cannot be used to set custom data for the Nether, Overworld or End.
olar_bear], [tfc2:bear]]
