DSMPMusic

Play MP3 / OGG audio in‑game via Simple Voice Chat, with Voice Messages integration, local music & remote URL playback.

📖 About

DSMPMusic is a Paper server plugin that streams audio files through Simple Voice Chat. You can play local MP3/OGG music, stream audio from remote URLs, download music to server storage, pause/resume/stop playback, send music as in‑game voice messages via Voice Messages, and add custom timestamp‑based lyrics.

⚠️ Mandatory Dependency: Simple Voice Chat must be installed on your server. Voice Messages is an optional soft‑dependency only required for /dmc vmsg.

✨ Features

• Play local music for yourself, a specific player, or all online players
• Stream audio directly from HTTP/HTTPS remote URLs
• Download remote audio files into the server music folder
• Pause, resume and stop audio playback
• Integrate with Voice Messages: send music as playable voice messages
• Manual custom timed‑lyric system (plugin does NOT auto‑generate lyrics)
• Built‑in multi‑language support: English (en_US), Chinese (zh_CN)
• Configurable volume, audio duration limits, network timeouts, bypass voice‑chat group isolation
• Load‑order safety: works even if Simple Voice Chat loads after DSMPMusic

📋 Requirements

• Server: Paper 1.21.11
• Java Version: 21
• Required Plugin: Simple Voice Chat
• Optional Plugin: Voice Messages (for /dmc vmsg subcommand)

🎮 Commands

Aliases: dsmpmusic, dmusic, dmc

🔐 Permissions

dsmpmusic.play.me: Play music for yourself (default: true)
dsmpmusic.play.other: Play music for other players or everyone (default: op)
dsmpmusic.url: Play audio from remote URL (default: op)
dsmpmusic.stop.me: Stop your own music playback (default: true)
dsmpmusic.stop.other: Stop other players' or global music (default: op)
dsmpmusic.download: Download remote audio files (default: op)
dsmpmusic.reload: Reload plugin config and language files (default: op)
dsmpmusic.vmsg: Use Voice Messages music message feature (default: true)
dsmpmusic.pause: Pause/resume your own playing music (default: true)
dsmpmusic.pause.other: Pause/resume music for others or all players (default: op)
dsmpmusic.list: List local music files (default: op)

📂 Plugin Folder Structure (plugins/dsmpmusic/)

dsmpmusic/
├─ config.yml           # Main plugin configuration
├─ lang/                # Language resource files (zh_CN.yml / en_US.yml)
├─ music/               # Place your MP3 / OGG audio files here
├─ cache/               # Temporary directory for network downloads
└─ word/                # Lyric storage folder
   └─ template.yml      # Lyric file template

🎵 Lyric Instructions

The plugin cannot generate lyrics automatically. All lyric files must be written manually.

1. Copy word/template.yml
2. Rename the copied file to match your audio filename: e.g. music/song.mp3 → word/song.yml
3. Set start(seconds), end(seconds), text for each lyric line.
4. Time ranges without lyric entries will automatically become instrumental sections (intro, interlude, outro).

⚙️ Important Configuration Options (config.yml)

• language: Switch language, zh_CN or en_US
• playback.volume: Global playback volume multiplier
• playback.bypass-group-isolation: Bypass Simple Voice Chat group separation
• playback.max-audio-seconds: Maximum allowed duration for normal music playback
• vmsg.enabled: Toggle Voice Messages integration
• vmsg.max-seconds: Maximum audio length limit for voice‑message sending
• network: Connection timeout, read timeout, maximum download size limit

📝 Notes

1. Supported audio formats: MP3, OGG.
2. For URL playback, you must use a direct raw audio resource link.
3. Built‑in load‑order handling, you do not need to modify plugin load priority.
4. /dmc vmsg will be disabled if Voice Messages plugin is missing or turned off in config.

Source Code

The source code of DsmpMusic is published on GitHub for reference only. 👉 https://github.com/dydaozhu/DsmpMusic

License

All Rights Reserved (ARR). You may view the source code, but you are not allowed to modify, compile, redistribute or create derivative works without my written permission.