
MusicLayer
A mod that adds an easy layer of music that can be manipulated/chosen by multiple mods.
About this Mod
This mod requires HammerLib.
WARNING: This mod by itself doesn't affect your gameplay, but can play music when other mods are using it. There is no single point in using it unless it's required by another mod.
This mod allows to play music without game freezing and it allows to play music from Ogg files in several default ways:
- From resource location (ex: We use testmod:music/beach and it plays /assets/testmod/sounds/music/beach.ogg file)
- From URL (ex: We use any direct URL to .ogg file and it plays it). Note: while playing sounds from URL they get cached in .minecraft/musiclayer/music/ folder with the file name of MD5 of the passed URL. Also note that the first time the music gets downloaded it may play a little bit later as it plays the music directly from the URL, but next time will get from the file system (instantly). (Also launching a thread to check if the MD5 of remote and local files match, used when the file on a host gets changed)
- Customizable! This means that you can use any Input Stream to play your desired sound!
Note: This mod extracts another library to /asm/MusicLayer/SoundLib.jar! This is normal and required for the MusicLayer to function.
That is all for the mod, nothing to add, thank you for reading this.
![]()
Permissions:
- You can use this mod in your modpack.
- You are not allowed to repost this mod to other sites without providing a CurseForge/Modrinth download link and my permission (
Zeitheron on Discord) - You are not allowed to include this (or any other mods of the DragonForge team) in your own mod. Building add-ons, however, is allowed, but a friendly PM would be good.
Note:
- The only supported version of Minecraft is the latest one that this mod exists for. DO NOT ASK TO DOWNGRADE!
Want to discuss anything? Need help with APIs?
Join the discord server and follow Zeitheron on Twitter!
If you would like to support my work, you can become a patron via
Patreon. ![]()
Available Versions
How to Install MusicLayer 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.12.2).
Install Mod
Open the mod browser in the dashboard and search for "MusicLayer". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.12.2
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
MusicLayer 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.12.2). You can switch loaders with one click in the panel.
Is MusicLayer compatible with forge?
MusicLayer officially supports forge for Minecraft 1.12.2. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with MusicLayer – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if MusicLayer 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 MusicLayer with just one click on your server.
