Amethyst Music

Custom music for SMP servers: write the server's own songs onto discs at the Disc Writer, and play them on the Amethyst Jukebox, which holds 18 discs. Built on Amethyst Lib.

Custom Music Discs

• Server owners add their own songs: drop .ogg files into config/amethyst/discs/ and restart. Each song shows up in the Disc Writer, named after its file.
• Craft a Blank Disc (black dye, an iron ingot and an amethyst shard, any slots).
• Craft a Disc Writer (3 amethyst shards on top, iron ingot, jukebox, iron ingot in the middle, 3 iron ingots on the bottom).
• Right-click the Disc Writer, search or scroll the song list, pick a song, put in a Blank Disc and press Write. Writing costs 3 XP levels.
• Every song gets its own label color, so discs are easy to tell apart.
• Written discs play in any jukebox, work with comparators, and work in the Sophisticated Backpacks and Sophisticated Storage jukebox upgrades.
• Written discs are final. They can't be rewritten, and vanilla discs can't be used.
• Song names, colors and the XP cost can be changed in config/amethyst/discs.json.
• Players get the song files through AutoModpack (add /config/amethyst/discs/*.ogg to its synced files) or by putting the same files in their own config/amethyst/discs/ folder.
• Songs should be mono Ogg Vorbis files so they sound like they come from the jukebox.
• Too loud? Each player can lower discSoundVolume in their own config/amethyst/music.json (default 0.3).

Amethyst Jukebox

• Craft it with a note block on top, gold ingots in the corners, amethyst shards on the sides and bottom, and a jukebox in the middle.
• Holds 18 discs (vanilla or custom). Hoppers can load discs in, but nothing can pull them out.
• Play, Pause, Stop, Previous and Next buttons, with what's playing now, a progress bar and the time.
• Play modes: In order, Shuffle, Repeat one and Repeat all.
• Volume slider (0 to 100%) on a curve, so low settings are easy to fine-tune.
• Range slider (4 to 64 blocks): the music fades out smoothly the farther you walk away and stops at the edge.
• Walk up to it mid-song and you hear it from where it is now, not from the start.
• Only the player who placed it can change it. Everyone else can see what's playing.
• Comparators read the current song like a normal jukebox.

Custom sounds (no resource pack)

• Drop .ogg files into config/amethyst/sounds/ and restart. Each one plays with /playsound as bettersmp:<file name>, for example rickroll.ogg plays as bettersmp:rickroll.
• The name before the colon can be changed with soundNamespace in config/amethyst/music.json.
• Players get the files through AutoModpack (add /config/amethyst/sounds/*.ogg to its synced files) or by putting the same files in their own config/amethyst/sounds/ folder.

Setup

1. Install Amethyst Lib.
2. Put .ogg songs in config/amethyst/discs/ and restart. Options are in config/amethyst/music.json and config/amethyst/discs.json.

Amethyst Music is needed on the server and on players' games.

Works with

• Amethyst Lib (required)
• Sophisticated Backpacks / Sophisticated Storage (optional, jukebox upgrades play written discs)
• AutoModpack (optional, sends song files to players)

Tested with

Minecraft 26.1.2, NeoForge 26.1.2.109