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.
• Store metadata and safe relative paths.
• Send playback metadata and audio chunks.
• Start and stop jukebox/admin playback sessions.
• Send live jukebox volume updates.

Client Responsibilities

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

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.