# peyajCustomDisc Custom music disc plugin for Paper servers. Upload any audio file, get a playable disc. [![bStats Servers](https://img.shields.io/bstats/servers/32671?label=Servers&color=blue)](https://bstats.org/plugin/bukkit/peyajCustomDisc/32671) [![bStats Players](https://img.shields.io/bstats/players/32671?label=Players&color=green)](https://bstats.org/plugin/bukkit/peyajCustomDisc/32671) Are you a filipino and want to host your Minecraft server in the Philippines? Visit https://mcziehost.fun ![web banner](https://i.imgur.com/D5vYv0R.jpeg) ## 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 [style]` | Download, convert, and add a custom disc (use underscores for spaces) | | `/disc delete ` | Delete a custom disc (removes registry & deletes files) | | `/disc give ` | Give a custom disc | | `/disc list` | List all discs | | `/disc play ` | Play a disc (portable) | | `/disc stop` | Stop all disc music | | `/disc catalog` | Open the disc catalog GUI | | `/disc region set ` | Assign music to a WorldGuard region | | `/disc region remove ` | 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: ```text /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). ```yaml # 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](https://bstats.org/signatures/bukkit/peyajCustomDisc.svg)](https://bstats.org/plugin/bukkit/peyajCustomDisc/32671)

peyaj's CustomDiscs

Compatibility

Minecraft: Java Edition

Platforms

Supported environments

Links

Tags

Creators

Details

Disc Web