AudioLayer
Load your own MP3 files from a local folder and play them in-game under the audiolayer namespace. It also includes built-in KubeJS support for client-side scripting, plus ready-to-use examples for modpack and gameplay integration.
About this Mod
Audiolayer is a NeoForge mod for Minecraft 1.21.1 that lets you load your own MP3 files from a local folder and play them in-game under the audiolayer namespace. It also includes built-in KubeJS support for client-side scripting, plus ready-to-use examples for modpack and gameplay integration.
Features
- Load custom MP3 files from
config/audiolayer/input/ - Stream MP3 directly without converting everything to OGG first
- Stable sound IDs based on folder structure
- In-game commands to list, play, stop, and reload sounds
- Server-compatible sound playback routed to the client
- Built-in KubeJS support for client scripts
- Simple Java API for other mods to integrate with Audiolayer
- Runtime resource pack generated automatically
How it works
Place MP3 files into:
config/audiolayer/input/
Folder names become part of the sound ID. For example:
music/theme.mp3->audiolayer:music.themeui/confirm.mp3->audiolayer:ui.confirm
Use /audiolayer list to see loaded sounds, /audiolayer play <sound_id> to play one, and /audiolayer reload to rescan the folder.
KubeJS Support
Audiolayer includes a built-in KubeJS plugin. When KubeJS is installed, you can control Audiolayer from client scripts without extra setup.
Modpack Use
Modpack authors may freely include Audiolayer in their modpacks.
Notes
Audiolayer is designed for local audio files only. Every player who wants to hear Audiolayer sounds needs the mod and the same audio files locally. KubeJS support works from client scripts only.
Copyright and Audio Responsibility
Audiolayer is a playback tool and does not grant any rights to audio content.
Modpack authors, mod authors, and end users are responsible for ensuring that any audio files they use, bundle, or distribute through Audiolayer are properly licensed or otherwise legally permitted for their intended use.
By using Audiolayer, you confirm that you have the necessary rights to any audio content you load into the mod.
Available Versions
How to Install AudioLayer on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set neoforge Loader
In the panel under "Egg", select the neoforge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "AudioLayer". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
AudioLayer server crashes on startup – what to do?
Most common cause: wrong neoforge 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 AudioLayer compatible with neoforge?
AudioLayer officially supports neoforge for Minecraft 1.21.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with AudioLayer – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if AudioLayer 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 AudioLayer with just one click on your server.