What It Does
DragNSounds API is a library mod that handles custom audio on the server side. Instead of forcing players to install a specific resource pack to hear new sounds, you upload the audio files directly to the server. The mod uses Minecraft's native sound engine to stream these files to players in real time. So this means any player can hear the sound at their current position, regardless of where they are in the world.
The project is designed primarily for developers. If you're building your own mod, you can add DragNSounds as a dependency and use a few simple methods to manage sound playback. It handles the heavy lifting of audio management, allowing you to focus on your mod's logic. You can also use it as a standalone mod, though the built-in commands offer very limited options compared to the full API.
Key Capabilities
The core function is uploading custom sounds or music to the server. Once uploaded, you can manage these files and manipulate them during playback. The API supports various audio formats through its use of JAVE2 for audio management. But this allows for flexibility in what kind of audio files you can work with, as long as they're compatible with the underlying engine.
For developers, the integration is straightforward. The mod is built on the Architectury API, which helps it support multiple mod loaders. You can add translation keys to your mod's language file to support languages other than the default English and German. The documentation provides guidance on how to get started with development.
Compatibility and Requirements
DragNSounds API supports Minecraft versions 1.19.2, 1.20.1, 1.20.4, and 1.21.1. It works with Fabric, Forge, and NeoForge. Both the client and server sides of the mod are required for it to function. But this is a critical detail for server administrators, as players must also have the mod installed to hear the custom sounds.
There's a specific dependency requirement based on the version you use. Versions 0.2.2 and later require DragonLib to be installed. If you're using an older version, 0.2.1 or earlier, you don't need DragonLib and should remove it from your mods folder if it's present. The project also relies on JAVE2 for handling audio files.
Who It's For
This mod suits server owners who want to add custom audio cues, music, or ambient sounds without managing resource packs for every player. It is also ideal for mod developers who need a reliable way to include custom audio in their projects. Honestly, if you are looking for a simple way to play sounds on a server, the standalone mode works, but the full power of the mod is unlocked when used as a library in your own development.
Important Notes
The author advises creating a backup of your world before installing updates, especially alpha versions, which may contain bugs. This mod is licensed under the GNU General Public License v3.0 or later. You can find the source code and contribute to the project on GitHub. For support, the author maintains a Discord server where you can ask questions or discuss the mod.
