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.

AudioLayer