Music Craft

Spatial audio jukebox system for Minecraft 26.3. Replaces vanilla disc playback with a player menu, shared listening queues, 3D directional sound, web radio stations, and server-side MP3 playback.

Developed by DemonZDevelopment under GNU GPLv3. Track attribution and asset licenses are documented in ASSET_LICENSE.md.

Downloads

• Modrinth: Fabric Mod & Paper Plugin
• CurseForge: Fabric Client Mod | Paper Server Plugin
• Hangar: Paper Server Plugin
• Documentation: Wiki

Installation

Fabric Client

• Requirements: Minecraft 26.3, Fabric Loader 0.19.5 or newer, Java 25.
• Place MusicCraft-Fabric-1.0.0.jar and the matching Fabric API jar in .minecraft/mods/.
• Join a server running the Paper plugin, walk up to a jukebox, and right-click it to open the player.

Paper Server

• Requirements: Paper 26.3 on Java 25.
• Put MusicCraft-Paper-1.0.0.jar in your server plugins/ directory and start the server once.
• In plugins/MusicCraft/config.yml, set a unique server-id. Apply changes with /musiccraft admin reload.
• To host server audio, place .mp3 files in plugins/MusicCraft/music/ and run /musiccraft admin reload. Audio streams over existing player connections with no extra open ports.

Building from Source

Requires Java 25 and Git.

To compile:

.\gradlew.bat :protocol:test :paper:build :fabric:build --no-daemon --no-parallel

Built jars:

• Paper plugin: paper/build/libs/paper-1.0.0.jar
• Fabric mod: fabric/build/libs/fabric-1.0.0.jar

To build the release package with checksums:

.\infra\package-release.ps1

Packages are output to packages/music-craft-1.0.0/.

Documentation

• Wiki Guides: Setup, commands, permissions, and licensing notes.
• Architecture: Packet structures and client-server sync.
• Network Setup: Cloudflare worker routing and audio delivery.