?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
Music player

Music player

Situational BGM mod that lets you play custom music based on conditions like biome, time, or combat. Just set your soundpack and apply the matching resource pack to enjoy dynamic background music!

180
7

Compatibility

Minecraft: Java Edition

1.20.1

Platforms

Supported environments

Client-side
Host your next server with Modrinth Servers

Links

Report issues View source

Creators

Zoma1101 Member

Details

Licensed MIT
Published 2 months ago
Updated last month

🎵 Music Player Mod

Music Player is a mod that lets you freely set and switch background music (BGM) based on in-game conditions. Customize your soundtrack to match the world’s atmosphere — whether it's day or night, peaceful or in battle!

📦 How to Use

  1. Inside your .minecraft folder, navigate to soundpacks.
  2. Set up your custom soundpack like this:

soundpacks/pack_name/assets/pack_id/conditions/predicate.json soundpacks/pack_name/assets/pack_id/music/name.ogg

Example SoundPack

Example SoundPack is here

Soundpack cannot be recognized in zip file format

This will be fixed in the future.

  1. Apply a resource pack with the same name as your pack_id to activate the BGM.

📄 Condition File Setup (predicate.json)

{
  "priority": 100, // Higher priority takes effect when multiple conditions match
  "music": "music/name.ogg",
  // Playback conditions listed below
}

🎯 Available Playback Conditions

Condition Description
"biomes": [] Plays in the specified biomes (biome tags supported).
"is_night": true/false Plays only at night if true.
"is_combat": true/false Plays during combat if true (triggers when nearby mobs prepare to attack).
"isVillage": true/false Plays when villagers are nearby if true.
"min_y": n Plays when player Y position is higher than n.
"max_y": n Plays when player Y position is lower than n.
"weather": [clear/rain/thunder] Plays during specified weather.
"dimensions": [] Plays in specified dimensions.
"gui_screen": [ ... ] Plays only when specified GUI screens are open. Supported screens: crafting/inventory/furnace/brewing_stand/chest/creative
"entity_conditions": [] The sound will play if the specified entities are within the radius and their count is between min_count and max_count.
"radius": n Checks for entities within n blocks.
"min_count": n Minimum number of matching entities required.
"max_count": n Maximum number of matching entities allowed.

🎶 Now you can create an immersive soundtrack tailored to every moment in your Minecraft adventure!

  • Add this to your pack too soundpacks/pack_id/pack.mcmeta
{
  "pack": {
    "pack_format": 15,
    "description": "",
  }
}