Home

MusicXCST Wiki

MusicXCST is a Fabric mod for Minecraft 26.1.2 that adds writable custom music discs. Players can turn local audio files into Blueprint CDs, customize the disc name, color, and 16x16 artwork, then play the finished discs through jukeboxes without rebuilding resource packs or registering a new sound event for every song.

The mod is built for singleplayer worlds, LAN worlds, multiplayer servers, modpacks, and creative worlds that want custom music with validation, storage limits, and client-side audio caching.

Current Release

• Version: 0.1.4
• Minecraft: 26.1.2
• Loader: Fabric Loader 0.19.2 or newer
• Dependencies: Fabric API for 26.1.2 and GeckoLib 5.5.1 or newer
• Environment: install on both client and server for multiplayer

What MusicXCST Does

• Adds writable Blueprint CDs and a CD Writer block.
• Uploads local audio through the CD Writer GUI.
• Supports mp3, mp4, wav, ogg, flac, m4a, aac, webm, and avi.
• Stores normalized OGG Vorbis playback files on the server.
• Keeps ownership, status, checksums, file sizes, colors, and disc metadata in a server index.
• Caches audio on clients with SHA-256 validation.
• Plays custom discs through jukeboxes using MusicXCST's custom audio engine.
• Supports jukebox volume and loop settings.
• Provides player and admin commands for listing, inspecting, deleting, downloading, importing, repairing, and testing music.

Important 0.1.4 Notes

• /cstmusic list shows currently available player uploads.
• Player-facing info and delete commands accept uploaded file names where possible instead of forcing players to copy music IDs.
• CD Writer uploaded-file suggestions use original imported file names and show matching reusable uploads.
• Deleting a music entry removes stored playback files and the reusable uploaded file.
• Per-player file limits count active tracks, so deleted, missing, or invalid entries no longer block new uploads.
• Public MusicXCST jars do not bundle FFmpeg executables.

Key Pages

• Installation
• Basic-Usage
• Server-Admin-Guide
• Commands
• FFmpeg-and-Media
• Permissions-and-Security
• Audio-Engine
• Troubleshooting
• Modpack-Creators
• Roadmap
• Third-Party-Notices

Links

• Source: https://github.com/B1progame/musicXCST
• Modrinth: https://modrinth.com/mod/musicxcst
• CurseForge: https://www.curseforge.com/minecraft/mc-mods/musicxcst

Support Notes

MusicXCST does not include copyrighted music. Players, server owners, and modpack creators are responsible for having the rights to any audio they upload, distribute, or play.

MusicXCST source code, artwork, models, sounds, and original assets are all rights reserved unless a file states otherwise. Third-party tools and dependencies, including FFmpeg when installed separately, are governed by their own upstream licenses.