Installation
1. Install the plugin on a Paper 1.21.x server.
2. Place the plugin jar in your plugins folder.
3. Start the server once so the plugin can generate its data folder.
4. Place a valid track registry file in the plugin folder if you are using an external pack/registry workflow.
5. Make sure players also have access to the matching resource pack.
6. Configure the resource pack URL in the plugin config if you want automatic pack prompts.
Basic usage
- Use /servermusic to open the main menu
- Use /servermusic play <trackId> to start a specific track
- Use /servermusic stop, /servermusic pause, /servermusic resume, /servermusic next, and /servermusic prev for playback control
- Use /servermusic volume <0-200> to set personal playback volume
Core features
- GUI-based music library
- Favorites
- Playlists
- Queue management
- Search and filtering
- Jam / shared listening
- Per-player persistent sessions
Important notes
- Players must have the correct resource pack in order to hear custom tracks
- This plugin does not fetch music from Spotify, YouTube Music, or other protected streaming services
- Exact resume from the same timestamp is not currently supported by vanilla resource-pack sound playback
- Exact audio seek is not available; segmented seek is only approximate when segment data exists
- If you are using pack generation workflows, ffmpeg and ffprobe are required
Recommended setup
- Keep your track registry and resource pack in sync
- Test the resource pack on the same Minecraft version as your server
- Use clean, unique track IDs so command-based playback stays easy to use