? SoundCreator
通过 PlasmoVoice 在服务器上播放自定义音频文件 —— 一条命令即可支持 MP3、OGG 和 WAV。
SoundCreator 是一款 Spigot 插件,允许管理员利用 PlasmoVoice 的音频基础设施,将服务器上的音频文件直接广播给玩家。只需将音频文件放入文件夹,即可向单个玩家或全服玩家流式传输音频 —— 无需资源包。
✨ 功能特性
- ? 多格式支持 —— 原生播放 MP3、OGG/Vorbis 和 WAV 文件(无需转换)
- ? PlasmoVoice 集成 —— 音频被编码为 Opus 格式,并通过语音模组的广播源系统进行流式传输
- ?️ 智能缓存 —— PCM 和 Opus 帧缓存在内存中,首次加载后可即时重放;所有声音在启动时预加载
- ? 灵活的受众选择 —— 可向你自己、特定玩家或所有在线玩家播放声音
- ? 并发声音限制 —— 可选的同时播放会话上限,以保护服务器性能
- ? 热重载 —— 无需重启服务器即可重新加载声音库和配置文件
- ? 细粒度权限控制 —— 提供独立的权限节点,分别用于播放、对其他玩家播放、对全员播放、停止和重载
- ⌨️ Tab 补全 —— 完整的 Tab 补全支持,包括包含空格的声音名称(需加引号)
? 命令
| 命令 |
描述 |
/sc play <sound> [player|all] |
向你自己、特定玩家或所有人播放声音 |
/sc stop [sound|all] |
停止一个声音(按名称)或所有正在进行的播放会话 |
/sc list |
列出从 sounds 文件夹加载的所有可用声音 |
/sc reload |
重新加载配置和声音库,然后预加载缓存 |
别名:/soundcreator
? 权限
| 权限节点 |
默认值 |
描述 |
soundcreator.use |
所有人 |
使用 /sc list |
soundcreator.play |
OP |
向自己播放声音 |
soundcreator.play.others |
OP |
向特定玩家播放声音 |
soundcreator.play.all |
OP |
向所有玩家广播声音 |
soundcreator.stop |
OP |
停止播放会话 |
soundcreator.reload |
OP |
重新加载配置和声音库 |
soundcreator.admin |
OP |
授予上述所有权限 |
⚙️ 配置文件 (config.yml)
# 扫描音频文件的子文件夹路径(位于 plugins/SoundCreator/ 下)
sounds-folder: sounds
# 要使用的 PlasmoVoice 源线路(默认线路:"proximity")
source-line: proximity
# 默认播放音量(0.0 – 1.0)
default-volume: 1.0
# 静默跳过未安装 PlasmoVoice 的玩家
skip-non-voice-players: true
# 最大同时播放的声音数量(0 = 无限制)
max-concurrent-sounds: 10
? 安装步骤
- 在你的服务器上安装 PlasmoVoice。
- 将
SoundCreator.jar 放入你的 plugins/ 文件夹。
- 启动服务器 ——
plugins/SoundCreator/sounds/ 文件夹将自动创建。
- 将你的
.mp3、.ogg 或 .wav 文件复制到 sounds/ 文件夹中。
- 使用
/sc reload(或重启服务器),即可开始使用!
注意: 玩家必须在客户端安装 PlasmoVoice 模组才能听到声音。未安装该模组的玩家将被静默跳过。
? 依赖要求
| 要求项 |
版本 |
| Minecraft |
1.21+ |
| 服务端软件 |
Spigot / Paper |
| Java |
21+ |
| PlasmoVoice |
2.1.8+ |
?️ 技术细节
- 音频文件使用
mp3spi、vorbisspi 和标准 Java Sound SPI 解码为原始 16 位 PCM
- PCM 被重采样为 48 kHz 单声道,并使用 PlasmoVoice 的编码器编码为 Opus 帧(每帧 960 个样本)
- 所有库(javazoom、tritonus)均在 jar 包内 阴影化并重新定位 —— 除了 PlasmoVoice 外,服务器端无需外部依赖
- 播放过程 异步运行,以避免阻塞主线程
由 ELB_GG 制作
? 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
- ? Multi-format support — Plays MP3, OGG/Vorbis, and WAV files natively (no conversion needed)
- ? PlasmoVoice integration — Audio is encoded to Opus and streamed through the voice mod's broadcast source system
- ?️ Smart cache — PCM and Opus frames are cached in memory for instant replay after the first load; all sounds are preloaded on startup
- ? Flexible targeting — Play sounds to yourself, a specific player, or all connected players
- ? Concurrent sound limit — Optional cap on simultaneous playback sessions to protect server performance
- ? Hot-reload — Reload the sound library and config without restarting the server
- ? Granular permissions — 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)
# 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
- Install PlasmoVoice on your server.
- Drop
SoundCreator.jar into your plugins/ folder.
- Start the server — the
plugins/SoundCreator/sounds/ folder will be created automatically.
- Copy your
.mp3, .ogg, or .wav files into the sounds/ folder.
- 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 shaded and relocated 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧