ᴍɪɴᴇᴄʀᴀꜰᴛʀᴇꜱᴏᴜʀᴄᴇꜱ
ModsShadersPluginsResource PacksModpacks
Log inSign up

CustomDiscs SVC

Modrinth

CustomDiscs (Simple Voice Chat) is a plugin that lets you play custom music in Minecraft using jukeboxes and discs.

67.2K downloads201 followersUpdated 2mo ago

2.7.0 · MC 26.3 · Folia, Paper, Purpur

View on Modrinth

Files

  • 2.7.0

    release

    CustomDiscs-SVC 2.7.0

    26.326.226.1.226.1.1+7foliapaperpurpur

    2026-08-22 · 7.7K downloads

    CustomDiscs-2.7.0.jar · 1011 KB

  • 2.6.0

    release

    CustomDiscs-SVC 2.6.0

    26.1.226.1.126.11.21.11+12foliapaperpurpur

    2026-05-23 · 9.9K downloads

    CustomDiscs-2.6.0.jar · 168 KB

  • 2.5.2

    release

    CustomDiscs-SVC 2.5.2

    1.21.111.21.101.21.91.21.8+9foliapaperpurpur

    2026-04-18 · 3K downloads

    CustomDiscs-2.5.2.jar · 166 KB

  • 2.5.1

    release

    CustomDiscs-SVC 2.5.1

    1.21.111.21.101.21.91.21.8+9foliapaperpurpur

    2026-03-24 · 2.4K downloads

    CustomDiscs-2.5.1.jar · 164 KB

  • 2.5.0

    release

    CustomDiscs-SVC 2.5.0

    1.21.111.21.101.21.91.21.8+9foliapaperpurpur

    2026-02-23 · 2.8K downloads

    CustomDiscs-2.5.0.jar · 123 KB

  • 2.4.2

    release

    CustomDiscs-SVC 2.4.2

    1.21.111.21.101.21.91.21.8+9foliapaperpurpur

    2026-01-05 · 5K downloads

    CustomDiscs-2.4.2.jar · 1.6 MB

  • 2.4.1

    release

    CustomDiscs-SVC 2.4.1

    1.21.111.21.101.21.91.21.8+9foliapaperpurpur

    2026-01-02 · 665 downloads

    CustomDiscs-2.4.1.jar · 1.6 MB

  • 2.4.0

    release

    CustomDiscs-SVC 2.4.0

    1.21.111.21.101.21.91.21.8+9foliapaperpurpur

    2025-12-28 · 651 downloads

    CustomDiscs-2.4.0.jar · 1.6 MB

  • 2.3.0

    release

    CustomDiscs-SVC 2.3.0

    1.21.111.21.101.21.91.21.8+9bukkitfoliapaperpurpur

    2025-12-25 · 1.3K downloads

    CustomDiscs-2.3.0.jar · 2.2 MB

  • 2.2.0

    release

    CustomDiscs-SVC 2.2.0

    1.21.101.21.91.21.81.21.7+8bukkitfoliapaperpurpurspigot

    2025-10-07 · 7.7K downloads

    CustomDiscs-2.2.0.jar · 2.0 MB

  • 2.1.12

    release

    CustomDiscs-SVC 2.1.12

    1.21.81.21.71.21.61.21.5+23bukkitfoliapaperpurpurspigot

    2025-07-26 · 7.8K downloads

    CustomDiscs-2.1.12.jar · 3.7 MB

  • 2.1.11

    release

    CustomDiscs-SVC 2.1.11

    1.21.71.21.61.21.51.21.4+27bukkitfoliapaperpurpurspigot

    2025-07-11 · 1.7K downloads

    CustomDiscs-2.1.11.jar · 3.7 MB

  • 2.1.10

    release

    CustomDiscs-SVC 2.1.10

    1.21.61.21.51.21.41.21.3+26bukkitfoliapaperpurpurspigot

    2025-06-25 · 1.5K downloads

    CustomDiscs-2.1.10.jar · 3.7 MB

  • 2.1.9

    release

    CustomDiscs-SVC 2.1.9

    1.21.51.21.41.21.31.21.2+25bukkitfoliapaperpurpurspigot

    2025-05-20 · 2.7K downloads

    CustomDiscs-2.1.9.jar · 3.7 MB

  • 2.1.8

    release

    CustomDiscs-SVC 2.1.8

    1.21.51.21.41.21.31.21.2+25bukkitfoliapaperpurpurspigot

    2025-04-29 · 1.8K downloads

    CustomDiscs-2.1.8.jar · 36 MB

  • 2.1.7

    release

    CustomDiscs-SVC 2.1.7

    1.21.51.21.41.21.31.21.2+20bukkitfoliapaperpurpurspigot

    2025-04-27 · 373 downloads

    CustomDiscs-2.1.7.jar · 36 MB

  • 2.1.6

    release

    CustomDiscs-SVC 2.1.6

    1.21.51.21.41.21.31.21.2+25bukkitfoliapaperpurpurspigot

    2025-03-26 · 2.3K downloads

    CustomDiscs-2.1.6.jar · 36 MB

  • 2.1.5

    release

    CustomDiscs-SVC 2.1.5

    1.21.41.21.31.21.21.21.1+24bukkitfoliapaperpurpurspigot

    2025-03-25 · 331 downloads

    CustomDiscs-2.1.5.jar · 36 MB

  • 2.1.2

    release

    CustomDiscs-SVC 2.1.2

    1.21.41.21.31.21.21.21.1+24bukkitfoliapaperpurpurspigot

    2025-02-06 · 1.4K downloads

    CustomDiscs-2.1.2.jar · 36 MB

  • 2.1.1

    release

    CustomDiscs-SVC 2.1.1

    1.21.41.21.31.21.21.21.1+24bukkitfoliapaperpurpurspigot

    2024-12-10 · 1.3K downloads

    CustomDiscs-2.1.1.jar · 36 MB

  • 2.1.0

    release

    CustomDiscs-SVC 2.1.0

    1.21.41.21.31.21.21.21.1+24bukkitfoliapaperpurpurspigot

    2024-12-06 · 210 downloads

    CustomDiscs-2.1.0.jar · 36 MB

  • 2.0.3

    release

    CustomDiscs-SVC 2.0.3

    1.21.31.21.21.21.11.21+23bukkitfoliapaperpurpurspigot

    2024-11-23 · 371 downloads

    CustomDiscs-2.0.3.jar · 36 MB

  • 2.0.2

    release

    CustomDiscs-SVC 2.0.2 Hotfix

    1.21.11.211.20.61.20.5+21bukkitfoliapaperpurpurspigot

    2024-10-22 · 495 downloads

    CustomDiscs-2.0.2.jar · 36 MB

  • 2.0.1

    release

    CustomDiscs-SVC 2.0.1

    1.21.11.211.20.61.20.5+21bukkitfoliapaperpurpurspigot

    2024-10-22 · 76 downloads

    CustomDiscs-2.0.1.jar · 36 MB

  • 2.0.0

    release

    CustomDiscs-SVC 2.0.0

    1.21.11.211.20.61.20.5+21bukkitfoliapaperpurpurspigot

    2024-09-05 · 669 downloads

    CustomDiscs-2.0.0.jar · 36 MB

  • 1.5.1

    release

    CustomDiscs-SVC 1.5.1

    1.21.11.211.20.61.20.5+21bukkitfoliapaperpurpurspigot

    2024-08-27 · 222 downloads

    CustomDiscs-1.5.1.jar · 35 MB

  • 1.5.0

    release

    CustomDiscs-SVC 1.5.0

    1.21.11.211.20.61.20.5+21bukkitfoliapaperpurpurspigot

    2024-08-26 · 80 downloads

    CustomDiscs-1.5.0.jar · 35 MB

  • 1.4.9

    release

    CustomDiscs-SVC 1.4.9

    1.21.11.211.20.61.20.5+21bukkitfoliapaperpurpurspigot

    2024-08-26 · 59 downloads

    CustomDiscs-1.4.9.jar · 35 MB

  • 1.4.8

    alpha

    [BUGGED] CustomDiscs-SVC 1.4.8

    1.21.11.211.20.61.20.5+21bukkitfoliapaperpurpurspigot

    2024-08-26 · 58 downloads

    CustomDiscs-1.4.8.jar · 35 MB

  • 1.4.7

    alpha

    [BUGGED] CustomDiscs-SVC 1.4.7

    1.21.11.211.20.61.20.5+21bukkitfoliapaperpurpurspigot

    2024-08-24 · 101 downloads

    CustomDiscs-1.4.7.jar · 35 MB

  • 1.4.6

    release

    CustomDiscs-SVC 1.4.6

    1.211.20.61.20.51.20.4+20bukkitfoliapaperpurpurspigot

    2024-08-05 · 333 downloads

    CustomDiscs-1.4.6.jar · 35 MB

  • 1.4.5

    release

    CustomDiscs-SVC 1.4.5

    1.211.20.61.20.51.20.4+20bukkitfoliapaperpurpurspigot

    2024-08-04 · 86 downloads

    CustomDiscs-1.4.5.jar · 35 MB

  • 1.4.4

    release

    CustomDiscs-SVC 1.4.4

    1.211.20.61.20.51.20.4+20bukkitfoliapaperpurpurspigot

    2024-07-31 · 133 downloads

    CustomDiscs-1.4.4.jar · 35 MB

  • 1.4.3

    release

    CustomDiscs-SVC 1.4.3

    1.211.20.61.20.51.20.4+20bukkitfoliapaperpurpurspigot

    2024-07-24 · 149 downloads

    CustomDiscs-1.4.3.jar · 35 MB

  • 1.4.2

    release

    CustomDiscs-SVC 1.4.2

    1.211.20.61.20.51.20.4+20bukkitfoliapaperpurpurspigot

    2024-07-12 · 227 downloads

    CustomDiscs-1.4.2.jar · 35 MB

  • 1.4.1

    release

    CustomDiscs-SVC 1.4.1

    1.211.20.61.20.51.20.4+20bukkitfoliapaperpurpurspigot

    2024-07-06 · 221 downloads

    CustomDiscs-1.4.1.jar · 35 MB

  • 1.4.0

    release

    CustomDiscs-SVC 1.4.0

    1.20.61.20.51.20.41.20.3+19bukkitfoliapaperpurpurspigot

    2024-06-11 · 193 downloads

    CustomDiscs-1.4.0.jar · 35 MB

  • 1.3.9

    release

    CustomDiscs-SVC 1.3.9

    1.20.41.20.31.20.21.20.1+17foliapaperpurpurspigot

    2024-04-01 · 257 downloads

    CustomDiscs-1.3.9.jar · 35 MB

  • 1.3.8

    release

    CustomDiscs-SVC 1.3.8

    1.20.41.20.31.20.21.20.1+17foliapaperpurpurspigot

    2024-03-26 · 104 downloads

    CustomDiscs-1.3.8.jar · 380 KB

  • 1.3.7

    release

    CustomDiscs-SVC 1.3.7

    1.20.41.20.31.20.21.20.1+17foliapaperpurpurspigot

    2024-03-18 · 75 downloads

    CustomDiscs-1.3.7.jar · 378 KB

  • 1.3.6

    release

    CustomDiscs-SVC 1.3.6

    1.20.41.20.31.20.21.20.1+17foliapaperpurpurspigot

    2024-03-17 · 114 downloads

    CustomDiscs-1.3.6.jar · 374 KB

  • 1.3.5

    release

    CustomDiscs-SVC 1.3.5

    1.20.41.20.31.20.21.20.1+9foliapaperpurpur

    2024-03-12 · 108 downloads

    CustomDiscs-1.3.5.jar · 91 KB

  • 1.3.4

    release

    CustomDiscs-SVC 1.3.4

    1.20.41.20.31.20.21.20.1+1foliapaperpurpur

    2024-03-10 · 74 downloads

    CustomDiscs-1.3.4.jar · 89 KB

  • 1.3.3

    release

    CustomDiscs-SVC 1.3.3

    1.20.41.20.31.20.21.20.1+1foliapaperpurpur

    2024-03-09 · 57 downloads

    CustomDiscs-1.3.3.jar · 89 KB

  • 1.3.2

    release

    CustomDiscs-SVC 1.3.2

    1.20.41.20.31.20.21.20.1+1foliapaperpurpur

    2024-03-06 · 67 downloads

    CustomDiscs-1.3.2.jar · 88 KB

  • 1.3.1

    release

    CustomDiscs 1.3.1

    1.20.41.20.31.20.21.20.1+1foliapaperpurpur

    2024-03-06 · 189 downloads

    CustomDiscs-1.3.1.jar · 88 KB

Files are delivered unmodified from Modrinth's servers and verified against the SHA-512 hash published by the project. The project's license applies to every file; check it before redistributing.

About

Modrinth downloads

CustomDiscs

CustomDiscs brings custom, positional music discs to Minecraft servers through Simple Voice Chat. Turn a regular music disc into a custom one backed by a local MP3, WAV, or FLAC file, or stream a track from a supported remote service such as YouTube or SoundCloud.

Audio is played from the jukebox position, so players hear it naturally as they move through the world. Server owners can control playback range, volume, track limits, disc appearance, visualizations, and remote provider behavior. Developers can integrate with playback through the public API and Bukkit events.

Special thanks

CustomDiscs builds on ideas and technology from these projects:

Links

Features

  • Local playback from MP3, WAV, and FLAC files
  • Remote playback from YouTube and SoundCloud URLs
  • Positional audio powered by Simple Voice Chat
  • Per-jukebox playback radius
  • Custom model data for local and remote discs
  • Configurable particles and playback holograms
  • Configurable maximum file size and track duration
  • English and Russian translations
  • Folia-aware scheduling
  • Public API, lifecycle events, and audio packet handlers

Requirements

CustomDiscs requires the following server plugins:

Players also need the Simple Voice Chat client mod to hear custom disc audio.

Installation

  1. Install Simple Voice Chat and PacketEvents on the server.
  2. Download CustomDiscs from Modrinth.
  3. Place all three plugin files in the server's plugins directory.
  4. Start or restart the server.
  5. Review the generated configuration in plugins/CustomDiscs/config.yml.
  6. Make sure Simple Voice Chat is configured and working before testing a disc.

Creating a disc

Custom discs are created from an ordinary Minecraft music disc held in the player's main hand. Arguments containing spaces must be enclosed in double quotes.

From a local file

Place an MP3, WAV, or FLAC file in plugins/CustomDiscs/musicdata, or download one from a direct HTTP(S) URL:

/cd download "https://example.com/music/track.mp3" track.mp3

Hold a music disc and convert it:

/cd create local track.mp3 "Track name"

From a remote service

Hold a music disc and provide a supported URL:

/cd create remote "https://www.youtube.com/watch?v=..." "Track name"

Insert the resulting disc into a jukebox to start positional playback.

[!WARNING] Remote services commonly require additional configuration before playback will work reliably. YouTube may require OAuth2, a PO token, a remote cipher server, or an HTTP(S) proxy. Provider behavior can change independently of CustomDiscs. Use a secondary account for OAuth2 authorization and never publish provider credentials or tokens.

Only stream or download audio that you are authorized to use. Server owners are responsible for complying with the terms of the source service and applicable copyright law.

Commands

The full command is /customdiscs; /cd is available as a shorter alias.

CommandDescriptionPermission
/cdRoot CustomdDiscs commandcustomdiscs
/cd helpShows the commands available to the sender.customdiscs.help
/cd reloadReloads configuration and language files.customdiscs.reload
/cd download "<direct URL>" <filename>Downloads an MP3, WAV, or FLAC file into musicdata.customdiscs.download
/cd create local <filename> "<disc name>"Converts the held music disc using a local file.customdiscs.create.local
/cd create remote "<URL>" "<disc name>"Converts the held music disc using a supported remote URL.customdiscs.create.remote
/cd distance <radius>Prompts the player to select a jukebox and assigns its playback radius.customdiscs.distance

create local, create remote, and distance are player-only operations.

Permissions

PermissionDefaultDescription
customdiscs.*OperatorsGrants every CustomDiscs permission.
customdiscs.helpEveryoneAllows access to command help.
customdiscs.reloadOperatorsAllows configuration and language reloads.
customdiscs.downloadOperatorsAllows downloading audio files to the server.
customdiscs.createEveryoneParent permission for disc creation.
customdiscs.create.localEveryoneAllows creating discs from local files.
customdiscs.create.remoteEveryoneAllows creating discs from remote URLs.
customdiscs.create.remote.youtubeEveryoneAllows creating discs from YouTube URLs.
customdiscs.create.remote.soundcloudEveryoneAllows creating discs from SoundCloud URLs.
customdiscs.distanceEveryoneAllows changing a jukebox's playback radius.

Configuration

The plugin creates and maintains plugins/CustomDiscs/config.yml. The file includes comments describing each option, so it can be configured directly without copying a complete template from this README. Important settings include:

  • language, update checks, and debug logging;
  • maximum download size and playback radius;
  • master volume and maximum track length;
  • custom model data for local, YouTube, and SoundCloud discs;
  • URL suggestions and provider matching rules;
  • particle, hologram, or combined jukebox visualizations;
  • hologram render distance, name length, position mode, and offsets;
  • YouTube OAuth2, PO token, remote cipher server, and HTTP(S) proxy settings.

Run /cd reload after editing the configuration. Language files are stored in plugins/CustomDiscs/language and can also be customized.

Developer API

The API artifact is published from the project's Maven repository. Replace the version below if a newer API release is available.

Gradle (Kotlin DSL)

repositories {
    maven("https://repo.subkek.space/maven-public/")
}

dependencies {
    compileOnly("space.subkek:customdiscs-api:1.0.0-SNAPSHOT")
}

Maven

<repository>
    <id>subkek</id>
    <url>https://repo.subkek.space/maven-public/</url>
</repository>

<dependency>
    <groupId>space.subkek</groupId>
    <artifactId>customdiscs-api</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>

Declare CustomDiscs and Simple Voice Chat as server dependencies in your Paper plugin descriptor. You can then obtain the registered API service:

import space.subkek.customdiscs.api.CustomDiscsAPI;

CustomDiscsAPI api = CustomDiscsAPI.get();
if (api ==null)
    throw new IllegalStateException("CustomDiscs is not loaded");
boolean customDisc = api.isCustomDisc(itemStack);
api.getLavaPlayerManager().play(jukeboxBlock, audioIdentifier, null);

The API exposes:

  • CustomDiscsAPI for service discovery, disc identification, and playback manager access;
  • LavaPlayerManager for starting, stopping, and inspecting positional playback;
  • packet handlers for observing or filtering encoded audio frames;
  • CustomDiscInsertEvent and CustomDiscEjectEvent for jukebox interaction;
  • LavaPlayerStartPlayingEvent and LavaPlayerStopPlayingEvent for playback lifecycle hooks.

The LavaPlayer lifecycle events may run asynchronously or on a region thread. Schedule Bukkit world operations on the appropriate server or region scheduler.

Building from source

The project requires JDK 21 and includes the Gradle Wrapper:

./gradlew build

The distributable plugin JAR is produced in build/libs.

CustomDiscs SVC | MinecraftResources