Modscraper Modscraper Minecraft
Music player logo

Music player

Mod

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!

Type

Mod

Modrinth Downloads

1,847

Modrinth ID

ZHw0cZCU

Last Updated

May 29, 2026

Description

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

Compatibility

Mod Loaders

Forge

Game Versions

1.20.1

Similar Mods

External Resources