Installation

Installation

Requirements

Install MusicXCST on the server and on every client that joins with MusicXCST discs or jukebox playback.

• Minecraft 26.1.2
• Fabric Loader 0.19.2 or newer
• Fabric API for 26.1.2
• GeckoLib 5.5.1 or newer
• MusicXCST 0.1.4

Steps

1. Install Fabric Loader for Minecraft 26.1.2.
2. Install Fabric API and GeckoLib.
3. Put the MusicXCST jar in the mods folder on the server and on every client.
4. Start the game/server once to generate config/musicxcst.json.
5. Review FFmpeg, upload, duration, file count, and storage limits before opening a public server.

FFmpeg Setup

MusicXCST uses FFmpeg for audio probing and transcoding, but the public mod jar does not include FFmpeg binaries.

The default config is:

ffmpegMode = system

Supported modes:

system   Use ffmpeg from PATH.
path     Use the executable configured in ffmpegPath.
managed  Use a user-approved, verified download stored outside the jar.
disabled Do not use FFmpeg; already-compatible OGG files may still work.

If FFmpeg is missing, the title screen can show a MusicXCST setup banner. The setup flow does not download an executable unless the user or an admin explicitly chooses the managed download option.

Multiplayer

MusicXCST is required on both sides for multiplayer use. The server stores and validates audio. Clients handle GUI upload, local conversion, audio cache downloads, and playback.

Modpacks

Confirm redistribution permission before publishing a pack that includes the MusicXCST jar. Keep the license and third-party notice files with the distribution.

See Modpack-Creators.