Zoma's Music player

Quick rating

Community listing page, reviews here may not be monitored by the author.

Zoma's Music player

By Zoma1101Owner

No reviews yet

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!

Adventure/Exploration
Mod Loaders
Forge
NeoForge
Minecraft
26.2

Community voices

Reviews

List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Show per page
10
25
50
Delete this review?

This removes your review from the project. You can write a new review after.

Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Compatibility

Supported Environments

Where It Runs
Client Only

Runs entirely on the client. Works on vanilla servers.

About

Project Details

Type
Mod
License
MIT License
Latest Version
zomas_music_player-1.2.0.jar

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

CurseForge ID
Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

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 the soundpacks directory.
  2. Set up your custom soundpack using the following structure:
soundpacks/
└── yourpackname/
    └── assets/
        └── your_pack_id/
            ├── conditions/
            │   └── predicate.json
            └── music/
                └── name.ogg

> ⚠️ Currently, soundpacks cannot be recognized in .zip format.
> This will be fixed in a future update.

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

📄 Condition File Setup (predicate.json)

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

🎯 Available Playback Conditions

Key Type Description
biomes string[] Plays in the specified biomes. Biome tags are supported.
is_night true / false Plays only at night if true.
is_combat true / false Plays during combat if true (triggers when nearby hostile mobs prepare to attack).
isVillage true / false Plays when villagers are nearby if true.
min_y number Plays above the specified Y-coordinate.
max_y number Plays below the specified Y-coordinate.
weather ["clear", "rain", "thunder"] Plays during specified weather.
dimensions string[] Plays in the specified dimensions.
gui_screen string[] Plays only while the specified GUI screen is open. Supported: crafting, brewing_stand, shulker_box, furnace, anvil, enchantment, cartographytable, smithing, merchant.

🗂️ Required Metadata File

Also include the following file to ensure your soundpack is recognized:

soundpacks/your_pack_id/pack.mcmeta

{
  "pack": {
    "pack_format": 15,
    "description": ""
  }
}

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

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

Screenshots

Gallery

This project has no gallery images yet.

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

~3,000
Total Downloads
CurseForge
~1,000
Modrinth
~2,000
Last Updated
CurseForge
Created
CurseForge
Modrinth
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works