Basic use

Most of the mod is automatic since it just checks game state and selects music accordingly, but you can still interact with the mod through a few key-bindings and menus. These are describged in the following.

Music player controls

The music player can be controlled to some degree using the key-bindings below.

Binding	Default Key	Supported versions	Description
Reload	`P`	$\geq$ 2.0.0	Restart the music engine and reload the music-pack configuration.
Pause/resume	`End`	$\geq$ 2.4.3	Pauses and resumes the music.
Change music	`Page_Up`	$\geq$ 2.0.0	Stop the currently playing music and pick another soundtrack.

Debug info printing

Later versions of the mod allows you to print the values of events and properties to the Minecraft logs by pressing Page_Down. For example, if you are unsure of the id of a boss, enter the boss fight, press Page_Down, and then see what id is printed to the log. Rinse and repeat for all other properties.

Binding	Default Key	Supported versions	Description
Show cave score	`Page_Down`	$=$ 2.2.0	Show the cave score (see the property) at the player's current location. NOTE: Replaced with "Print all readings" in later versions.
Print all readings	`Page_Down`	$\geq$ 2.3.0	Print the current values for all supported events and properties (see here) to the Minecraft logs.

The code block below shows an example output caused by pressing Page_Down.

[21:01:45] [Render thread/INFO] [me.mo.am.v1.AmbienceMini/]: All current Ambience Mini state (took 7 ms):
 @main_menu          = false
 @joining            = false
 @disconnected       = false
 @credits            = false
 @paused             = false
 @in_game            = true
 @day                = true
 @dawn               = true
 @dusk               = false
 @night              = false
 @downfall           = false
 @rain               = false
 @snow               = false
 @thunder            = false
 @village            = true
 @ranch              = false
 @warden_nearby      = false
 @dead               = false
 @sleeping           = false
 @fishing            = false
 @under_water        = false
 @in_lava            = false
 @drowning           = false
 @minecart           = false
 @boat               = false
 @horse              = false
 @donkey             = false
 @pig                = false
 @elytra             = false
 @in_combat          = false
 @boss_fight         = false
 $difficulty         = "easy"
 $dimension          = "minecraft:overworld"
 $biome              = "minecraft:plains"
 $biome_tags         = [ "minecraft:stronghold_biased_to", "minecraft:has_structure/stronghold", "minecraft:has_structure/mineshaft", "forge:is_plains", "minecraft:has_structure/village_plains", "minecraft:has_structure/pillager_outpost", "minecraft:is_overworld", "minecraft:has_structure/ruined_portal_standard" ]
 $time               = 1713
 $cave_score         = -0.8122603
 $skylight_potential = 14.764148
 $areas              = [ Area { name="Trading area", owner="some_uuid", dimension="minecraft:overworld", isLocal=false, isShared=true } ]
 $structures         = [ "minecraft:village_plains" ]
 $uuid               = "some_uuid"
 $game_mode          = "creative"
 $health             = 20.0
 $max_health         = 20.0
 $elevation          = 74.9375
 $vehicle            = undefined
 $effects            = [  ]
 $combatant_count    = 0
 $boss               = undefined
 $bosses             = [  ]