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

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

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