SoundCreator

🎵 SoundCreator

Play custom audio files on your server through PlasmoVoice — MP3, OGG and WAV with a single command.

SoundCreator is a Spigot plugin that lets admins broadcast sound files from the server directly to players using PlasmoVoice's audio infrastructure. Drop your audio files in a folder, and stream them to one player, or everyone on the server — no resource pack required.

---

✨ Features

- 🎧 Tab completion — Plays Tab completion, Tab completion, and Tab completion files natively (no conversion needed) - 📡 Tab completion — Audio is encoded to Opus and streamed through the voice mod's broadcast source system - 🗃️ Tab completion — PCM and Opus frames are cached in memory for instant replay after the first load; all sounds are preloaded on startup - 🎯 Tab completion — Play sounds to yourself, a specific player, or all connected players - 🔢 Tab completion — Optional cap on simultaneous playback sessions to protect server performance - 🔄 Tab completion — Reload the sound library and config without restarting the server - 🔒 Tab completion — Individual nodes for play, play-to-others, play-to-all, stop, and reload - ⌨️ Tab completion — Full tab-complete support, including quoted sound names with spaces

---

🔧 Commands

| Command | Description | |---|---| | `/sc play <sound> [player|all]` | Play a sound to yourself, a specific player, or everyone | | `/sc stop [sound|all]` | Stop one sound (by name) or all active playback sessions | | `/sc list` | List all available sounds loaded from the sounds folder | | `/sc reload` | Reload config and sound library, then preload cache |

Alias: `/soundcreator`

---

🔑 Permissions

| Permission | Default | Description | |---|---|---| | `soundcreator.use` | Everyone | Use `/sc list` | | `soundcreator.play` | OP | Play sounds to yourself | | `soundcreator.play.others` | OP | Play sounds to a specific player | | `soundcreator.play.all` | OP | Broadcast sounds to all players | | `soundcreator.stop` | OP | Stop playback sessions | | `soundcreator.reload` | OP | Reload config and sound library | | `soundcreator.admin` | OP | Grants all of the above |

---

⚙️ Configuration (`config.yml`)

```yaml

Subfolder inside plugins/SoundCreator/ where audio files are scanned

sounds-folder: sounds

PlasmoVoice source line to use (default line: "proximity")

source-line: proximity

Default playback volume (0.0 – 1.0)

default-volume: 1.0

Silently skip players who don't have PlasmoVoice installed

skip-non-voice-players: true

Maximum simultaneous sounds (0 = unlimited)

max-concurrent-sounds: 10 ```

---

📦 Installation

1. Install PlasmoVoice on your server. 2. Drop `SoundCreator.jar` into your `plugins/` folder. 3. Start the server — the `plugins/SoundCreator/sounds/` folder will be created automatically. 4. Copy your `.mp3`, `.ogg`, or `.wav` files into the `sounds/` folder. 5. Use `/sc reload` (or restart) and you're ready to go!

> Note: Players must have the PlasmoVoice mod installed on their client to hear sounds. Players without the mod are skipped silently.

---

📋 Requirements

| Requirement | Version | |---|---| | Minecraft | 1.21+ | | Server software | Spigot / Paper | | Java | 21+ | | PlasmoVoice | 2.1.8+ |

---

🛠️ Technical Details

- Audio files are decoded to raw 16-bit PCM using `mp3spi`, `vorbisspi`, and standard Java Sound SPI - PCM is resampled to 48 kHz mono and encoded to Opus frames (960 samples/frame) using PlasmoVoice's encoder - All libraries (javazoom, tritonus) are asynchronously inside the jar — no external dependencies required on the server beyond PlasmoVoice - Playback runs asynchronously to avoid blocking the main thread

---

*Made by ELB_GG*