Back to mods
Music player project artwork

Modrinth · Minecraft mod

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!

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Music player release should I use?

Updated today
Latest stable file 1.1.0
Game version 1.21.1
Loader NeoForge

Music player 1.1.0 targets 1.21.1 with NeoForge. It must be installed on the client. Do not install it on the dedicated server. No extra mods listed for this file.

Where it goes

Is Music player required on the client, server, or both?

It must be installed on the client. Do not install it on the dedicated server.

Client Required
Dedicated server Not supported
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This file is marked client-only.

What else does Music player 1.1.0 need?

1.1.0. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Music player without breaking your instance.

Built for Music player 1.1.0. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.1.0. It targets 1.21.1 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.1.0. It opens that exact file at the source.

About this project

What does Music player add?

🎵 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": "",
  }
}

Project description from Modrinth.

Pick your setup

Music player by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

2 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Music player versions and loaders

7 of 7 releases match

Looking for an older file? The official Modrinth project page is in Resources.