JundiMusic

A music platform for Paper servers, paired with a Fabric client mod that plays real audio.

ComponentPlatformStatus
Server pluginPaper 1.17.1+ · Java 21Available
Client modFabric · Minecraft 1.21.1Available

Quick start

  1. Install the plugin and the mod (installation guide).
  2. Play a playlist: /music play <playlist>
  3. Or play an audio link directly: /music play https://example.com/song.mp3
  4. Play for the whole server: /music server play <playlist>
  5. Open the client menu: press M.

What it does

🎵

Real playback

The client streams and decodes actual audio (MP3 via JLayer, WAV/AIFF/AU via JavaSound) with fades, seeking and volume scaling against the Minecraft music option.

🗺️

Music zones

World, radius and cuboid zones, each with its own playlist. Strict priority: server-wide music > zone music > personal music.

⏱️

Timestamp sync

The playhead is derived from server wall-clock timestamps, so joining mid-song starts at exactly the right offset — no drift.

Documentation

Installation

Install the server plugin and client mod.

Server Setup

Commands, permissions, playlists, zones and imports.

Client Setup

Keybinds, menu, HUD and client config.

Configuration

Full config.yml reference.

Plugin API

Integrate JundiMusic into other plugins.

Developer Guide

Wire protocol for custom clients.

Troubleshooting

Common problems and fixes.