Discy

A Minecraft mod for custom music discs. Upload songs at the DJ Deck, design disc artwork in the Disc Design Studio, burn tracks onto blank discs, and play them in jukeboxes, Speakers, or compatible mods.

Repository: github.com/AlfieeLawrence/Discy-A-custom-Disc-mod-for-Minecraft-

Features

• DJ Deck — browse, search, upload, and burn custom audio (OGG/MP3) onto blank discs
• Custom discs — per-disc artwork and streaming playback via OpenAL
• Disc Design Studio — in-game pixel editor for disc textures; paint, erase, fill, and pick colors with brush sizes, undo/redo, and saved designs you can apply when burning
• Speaker system — wire up Speakers to a Speaker Controller and play the same track in sync across your whole base — great for surround sound or background music everywhere at once
• Permanent discs — add baked-in discs via data/discy/permanent_discs.json
• Optional compatibility — Sophisticated Core jukebox upgrades and Let's Do Furniture gramophones (install those mods separately)

Disc Design Studio

Craft and place a Disc Design Studio, then right-click to open the editor.

• Tools — Paint, Erase, Fill, and Pick
• Brush — adjustable size; drag or single-pixel modes
• Canvas — up to 64×64 pixels
• Colors — wheel, brightness slider, hex input, and quick palette
• Workflow — undo/redo, save named designs, load existing files, or start a new blank
• Saved textures appear in the DJ Deck when burning discs — no external image editor required

Speakers & Speaker Controller

Place Speakers around your build and connect them to a Speaker Controller. Insert a custom disc, hit Play, and every linked speaker plays the same song in sync — with per-speaker volume and range.

Quick setup

1. Place a Speaker Controller and insert a custom disc.
2. Place Speakers where you want audio.
3. Link each speaker to the controller (wireless or wired — see below).
4. Open the controller and use Play / Stop.

Wireless — Shard Sync (Speaker Link item)

1. Right-click a Speaker with Shard Sync — it enters pairing mode for 30 seconds.
2. Right-click the Speaker Controller with Shard Sync while that speaker is in range.
3. The nearest unlinked pairing speaker connects (consumes one Shard Sync).

Wired — Speaker Wire

1. Run Speaker Wire from the controller toward each speaker (click adjacent blocks to place cable).
2. When the cable path reaches the speaker, it links automatically.
3. Breaking any segment of the path unlinks that speaker and removes the cable run.

Per-speaker controls (in the controller GUI)

Control	Action
− / +	Volume ±10%
< / >	Range ±4 blocks
x	Unpair (refunds Speaker Wire or Shard Sync)

Each speaker row is prefixed with B (wireless / Shard Sync) or W (wired / Speaker Wire). Scroll the list with the mouse wheel when many speakers are paired (up to 16 per controller).

Connection distance

Connection type	Item	Max distance
Wireless (Shard Sync)	Speaker Link	32 blocks
Wired (Speaker Wire)	Speaker Wire	64 blocks

Wireless range is a straight line from controller to speaker. Wired range is the length of the cable path through placed wire blocks.

Optional compatibility mods

Discy does not bundle these mods. Install official releases from Modrinth or CurseForge under each mod's own license:

Mod	Purpose
Sophisticated Core + Storage / Backpacks	Jukebox upgrade on backpacks and storage
Let's Do Furniture	Gramophone playback

User-uploaded content

Discy lets players upload their own songs and disc textures at the DJ Deck or save designs from the Disc Design Studio. That content is created by players, not shipped with the mod.

• You are responsible for having the rights to any audio or images you upload.
• Do not upload copyrighted music or artwork without permission from the rights holder.
• Server owners may wish to set rules for what players may upload.

Discy stores uploads in the world's discy/ folder (songs, textures, sidecars). Removing content in-game deletes those files on the server.

Credits & assets

Bundled art in this repository is included with the creators' permission:

Assets	Credit
Mod code	Alfie Lawrence
Mod icon, DJ Deck block textures, most item textures	Random Nautilus
Sap textures, UI textures, Disc Design Studio block textures	Mrdragonclaw

Runtime-only references to vanilla Minecraft assets (for example the dispenser container GUI used by the DJ Deck screen) are not redistributed in this repository.

License

Discy mod code is licensed under the MIT License — see LICENSE.

Summary of other terms:

Component	License	Where
Discy source & mod code	MIT	LICENSE
JLayer (bundled in release JARs)	LGPL 2.1	COPYING.LGPL
All third-party notices	—	NOTICE

LICENSE, NOTICE, and COPYING.LGPL are also packaged inside release JARs.

Third-party libraries (shipped in Discy JARs)

Discy bundles JLayer (javazoom:jlayer:1.0.1) for MP3 decoding.

• JLayer is copyright JavaZoom and licensed under LGPL 2.1
• Source: github.com/javazoom/jlayer or Maven javazoom:jlayer:1.0.1
• Full license text: COPYING.LGPL (GNU LGPL 2.1)
• JavaLayer project page (archived)

Discy itself (excluding bundled third-party libraries) is MIT-licensed.

Optional mod compatibility (not included)

Discy provides optional integration with other mods via mixins and public APIs. Discy does not:

• Redistribute, patch, or repackage those mods
• Ship their source code, assets, or JARs
• Include modified versions of their files

Users must install compatible mods from their official authors. Discy only adds small optional mixins and API hooks when those mods are present at runtime.

• Sophisticated Core / Storage / Backpacks — copyright P3pp3rF1y, All Rights Reserved. Install from official releases only. Discy registers against public APIs (IDiscHandler, SoundHandler) and does not redistribute or modify Sophisticated files.
• Let's Do Furniture — copyright the Furniture mod authors. Install from official releases only, under that mod's own license. Discy provides optional gramophone integration via mixin when Furniture is installed and does not redistribute or modify Furniture files.

If you publish forks or derivatives of Discy, keep these mods as separate optional runtime dependencies and retain NOTICE and COPYING.LGPL for JLayer.