Audio Engine

Audio Engine

MusicXCST uses a custom audio path instead of creating one Minecraft sound event per uploaded track.

Server Responsibilities

• Validate uploads.
• Normalize playable audio to OGG Vorbis.
• Create preview audio.
• Store metadata and safe relative paths.
• Send playback metadata and audio chunks.
• Start and stop jukebox/admin playback sessions.
• Track listeners entering or leaving jukebox playback range.
• Save and apply jukebox loop and volume settings.

Client Responsibilities

• Convert selected CD Writer files before upload when needed.
• Cache downloaded audio in musicxcst-cache.
• Verify SHA-256 checksums.
• Decode OGG with STB Vorbis.
• Play audio through OpenAL.
• Apply jukebox volume updates.

Client Cache

<minecraft directory>/musicxcst-cache/

Useful commands:

/cstmusic download all
/cstmusic download auto 30m
/cstmusic download auto 1h
/cstmusic download auto 1h30m
/cstmusic download off

Limitations

• Cache misses can delay full-track playback while chunks download.
• Precise mid-track seeking is still an area for improvement.
• Every listener needs the client mod installed.
• Custom disc designs fall back to the Blueprint CD appearance if item design data is missing or corrupt.