DrSounds

**DrSounds** is a powerful all-in-one solution for adding custom music, sound effects, and dialogue to your Minecraft server. It fully automates resource pack creation and hosting, making custom audio simple and accessible for everyone including **Bedrock players via Geyser**. No manual `sounds.json`. No external hosting. Just drop your audio files and start the server. --- ## ✨ Key Features ### ⚡ Automated Resource Pack Generation * Simply place `.ogg` files into the plugin folder * Automatically generates a valid `resourcepack.zip` on server startup * No manual editing of `sounds.json` required --- ### 🌐 Built-in Web Server * Lightweight internal HTTP server * Hosts the resource pack directly from your server * Players are automatically prompted to download the pack when they join --- ### 📱 Geyser & Bedrock Support * Full compatibility with **GeyserMC** * Automatically converts audio into a Bedrock-compatible `.mcpack` * Installs directly into the Geyser resource pack folder * Seamless cross-platform audio for Java and Bedrock players --- ### 🔊 Advanced Playback Control * **3D Spatial Audio** Sounds behave like native Minecraft sounds and fade with distance * **Looping Support** Loop music or ambience with precise tick-based delays * **Duration Awareness** Intelligent handling of track length for smooth looping --- ### 📍 Region & Location-Based Audio * Create custom regions in-game * Play sounds only for players inside specific regions * Play sounds at exact XYZ coordinates --- ### 🎉 Event Triggers (`events.yml`) Trigger sounds based on player or server events: * Join, Quit, Death, Respawn * World Change * ResourcePackLoaded (ensures sounds only play after the pack is loaded) Supports: * Multiple sounds per event * Independent delays * Looping per sound --- ## 📦 Installation Guide ### 1️⃣ Install 1. Download `DrSounds.jar` 2. Place it in your server’s `plugins` folder 3. Restart the server to generate default files --- ### 2️⃣ Add Sounds * Navigate to `plugins/DrSounds/sounds/` * Upload your `.ogg` files * You may organize them into subfolders (example: `sounds/music/`) > Only `.ogg` audio files are supported --- ### 3️⃣ Configure 1. Open `config.yml` 2. **Important:** Set `external-ip` to your server’s public IP 3. Register your sounds under the `sounds:` section * Volume * Pitch * Duration (in seconds) --- ### 4️⃣ Final Restart * Restart the server one last time * The plugin will: * Generate the resource pack * Start the internal web server * Generate Bedrock packs automatically if Geyser is installed --- ## 🎮 Commands & Usage ### Main Command ``` /drsounds ``` **Aliases:** `/ds`, `/sounds` --- ### ▶️ Play Sounds Play sounds with optional looping and targeting. **Syntax** ``` /drsounds play <mode> <sound_name> <loop_count> <targets...> ``` **Modes** * `player` * `region` * `position` **Examples** ``` /drsounds play player boom 1 Steve ``` Plays `boom` once for Steve ``` /drsounds play player boss_music -1 * ``` Loops `boss_music` infinitely for all players ``` /drsounds play position boom 1 100 64 -200 ``` Plays sound at specific coordinates --- ### ⏹ Stop Sounds Stop a sound instantly. **Syntax** ``` /drsounds clear <mode> <sound_name> <targets...> ``` **Example** ``` /drsounds clear player boss_music * ``` --- ### 🗺 Region Management Create and manage audio regions. ``` /drsounds region create <name> ``` Creates a region at your current location ``` /drsounds region delete <name> ``` Deletes an existing region --- ## 📝 Configuration Examples ### `config.yml` ```yml external-ip: "192.168.1.100" # Your public IP http-port: 8081 sounds: boom: path: "boom.ogg" volume: 1.0 pitch: 0.8 duration: 2 stream: false boss_music: path: "music/raid_theme.ogg" volume: 0.8 pitch: 1.0 duration: 180 stream: true ``` --- ### `events.yml` ```yml events: welcome_music: trigger: ResourcePackLoaded sounds: - sound: welcome_jingle delay: 0 loops: 1 - sound: lobby_music delay: 60 loops: -1 death_sound: trigger: PlayerDeathEvent sound: fail_trumpet action: play loops: 1 ``` --- ## ✅ Compatibility * **Minecraft Versions:** 1.18 – 1.21+ * **Server Software:** Spigot, Paper, Purpur * **Dependencies:** None (Standalone) * **Optional:** GeyserMC for Bedrock support