Acoustic lets a server-side mod start, stop, and update custom OGG sounds on selected clients. It is built for ambience, scripted music, boss themes, events, and other cases where vanilla sounds.json playback is too limited.
Features
- Server-side API for targeted sound playback.
- Direct OGG streaming from mod assets.
- Loop counts, infinite loops, start offsets, and end offsets.
- Fade in, fade out, runtime volume changes, and runtime pitch changes.
- Optional player predicates evaluated on the server before packets are sent.
- Music arbitration for exclusive tracks that can fade or block vanilla music.
- Kotlin DSL and Java-friendly entry points.
Requirements
- Minecraft 1.21.1
- NeoForge 21.1+
- Kotlin for Forge 5.3+
Acoustic is a library-style mod. It does not add gameplay content by itself; it provides an API that other mods and server logic can use.
