
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!
About this Mod
🎵 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
- Inside your .minecraft folder, navigate to soundpacks.
- 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.
- 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": "",
}
}
Available Versions
How to Install Music player on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.20.1).
Install Mod
Open the mod browser in the dashboard and search for "Music player". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.1
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Music player server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.1). You can switch loaders with one click in the panel.
Is Music player compatible with forge?
Music player officially supports forge for Minecraft 1.20.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Music player – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Music player consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Music player with just one click on your server.