AudioLayer

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.theme` * `ui/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.