
BGM Player
A more format supported, adjustable and continuous bgm system.
About this Mod
BGM Player
This mod fully overwrite the game bgm system.
Features
- More continuous playing. (Will not interrupt by join save/pause screen/etc.)
- MP3 format support.
- In-game music selection screen. (Visit via modmenu or sound options screen.)
Configure
You can use resource reloading to reload all configurations.
Game will load all music and icon into memory when reloading resources, which may cause a loading lag.
Root configuration
This config will automatically create in .minecraft/config/bgm-player/config.json after game launch.
{
//Allow: playlist, single_looping, random
"mode": "random",
//The ordinal in music list screen. If one of music is not here, it will append at last.
"playlist": [
//Fill the json file name of music config without file extension.
//Game will automatically play the first music at launch, you can define the first one at here.
]
}
Music configuration
All music config save in .minecraft/config/bgm-player/music/.
{
"name": "Name display in the music list",
//Relative path of .minecraft/config/bgm-player/resource/
"path": "The music path. Support wav, ogg and mp3.",
"author": "(Optional) Music author",
"album": "(Optional) Music album",
//Relative path of .minecraft/config/bgm-player/resource/
"icon": "(Optional) The icon path. Support png, jpg and webp."
}
Available Versions
How to Install BGM Player on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "BGM Player". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.20.1
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
BGM Player server crashes on startup – what to do?
Most common cause: wrong fabric 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.21.1). You can switch loaders with one click in the panel.
Is BGM Player compatible with fabric and forge and neoforge?
BGM Player officially supports fabric, forge, neoforge for Minecraft 1.21.1, 1.20.1. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with BGM Player – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if BGM 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 BGM Player with just one click on your server.