peyaj's CustomDiscs

Quick rating

Community listing page, reviews here may not be monitored by the author.

Report a bug to the author How listings work Are you the author?

peyaj's CustomDiscs

By peyajOwner

No reviews yet

Custom music disc plugin for Paper servers. Upload any audio file, get a playable disc.

Mod Loaders
Minecraft
26.2
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

About

Description

peyajCustomDisc

Custom music disc plugin for Paper servers. Upload any audio file, get a playable disc.

bStats Servers bStats Players

Are you a filipino and want to host your Minecraft server in the Philippines? Visit https://mcziehost.fun

web banner

Features

  • Web Dashboard — Upload and manage discs from a browser
  • Auto Conversion — Accepts MP3, WAV, FLAC, M4A, MP4, WMA, AAC, WebM → OGG
  • Resource Pack Generation — Java & Bedrock packs built automatically
  • Jukebox Integration — Full hologram display with Now Playing info
  • Loop Mode — Shift-Right-Click any jukebox to toggle looping
  • Region Music — Assign discs to WorldGuard regions (auto-loops)
  • In-Game Catalog — Browse and collect discs via GUI
  • Geyser Support — Bedrock players hear the custom disc with holograms

Requirements

Dependency Version
Paper 1.21.X - 26.2 (latest)
Java 21+
FFmpeg Required for non-OGG uploads (already bundled in the plugin)
WorldGuard Optional — enables region music
Geyser-Spigot Optional — Bedrock hologram & custom disc support

Commands

Command Description
/disc add <id> <url> <name> <author> [style] Download, convert, and add a custom disc (use underscores for spaces)
/disc delete <id> Delete a custom disc (removes registry & deletes files)
/disc give <player> <id> Give a custom disc
/disc list List all discs
/disc play <id> Play a disc (portable)
/disc stop Stop all disc music
/disc catalog Open the disc catalog GUI
/disc region set <region> <disc> Assign music to a WorldGuard region
/disc region remove <region> Remove region music
/disc region list List region mappings
/disc web Generate a one-time admin login link

Adding Discs

The recommended way to add discs is through the Web Dashboard (/disc web). It lets you upload audio files, design a custom disc texture, and preview everything before saving. Supported upload formats: MP3, WAV, FLAC, M4A, MP4, WMA, AAC, WebM. The plugin converts them to OGG automatically.

You can also add discs directly in-game if you have a direct download link to the audio file:

/disc add rushe https://mywebsite.com/audio/rushe.mp3 Rush_E Sheet_Music_Boss relic

Use underscores (_) for spaces in the track name and author. The last argument is the disc style texture (optional).

Permissions

Permission Description
pjcustomdisc.admin Access to all commands
jukeboxweb.admin Access to web dashboard & give command

Configuration

[!IMPORTANT] Setup the configuration FIRST before creating or adding custom discs!

  1. Configure web-port to an open/allocated port on your server host (this is the internal port the web server binds to).
  2. Configure public-url to point to your server's public IP/Domain and port. The plugin uses this URL to compile the resource pack download URL sent to players. If you add songs before setting this up, players will be sent resource pack downloads pointing to localhost, which will fail.

[!WARNING] Do NOT use your Minecraft server port (default 25565) for web-port! The web interface and download server run as a separate service on your host. You must assign/allocate a completely separate port for web-port (e.g. 8080, 25566, etc.). Using the Minecraft port will cause a BindException (Address already in use) and the plugin will fail to enable.

[!WARNING] Geyser Users & Bedrock Textures If you have auto-reload-geyser: true, the plugin will run /geyser reload every time you add/delete a disc. However, Geyser has a limitation where it cannot hot-reload new resource pack textures while the server is running. If you create a brand new disc, Bedrock players might see it as "Paper" until you do a full server /restart. (If you are just replacing audio for an existing disc, a restart is not required).

# config.yml
web-port: 8080
public-url: "http://your-server-ip:8080"
haproxy-support: false

# Region music (managed via commands)
region-music:
  spawn: "my_disc_id"

# Jukebox settings
jukebox:
  volume: 1.0
  pitch: 1.0
  sound-category: "RECORDS"
  range: 64.0
  enable-particles: true

Stats

bStats Chart