ArdaMusic

Region-based music for Minecraft servers. You define regions in ArdaRegions, assign tracks in ArdaMusic, and the soundtrack changes as players walk around.

Works on both server and client - everyone who should hear the music needs the mod (and ArdaRegions) installed.

What it does

Region music

ArdaRegions tells ArdaMusic which region you're in. Per region you can pick tracks, set one as priority (plays when you first enter), and adjust fade/crossfade/gap between shuffled songs.

Fallback

Outside any region, a fallback playlist can play instead. One global list, or different lists per world if you want that.

Menu music

Optional track on the title screen, server list, connecting, and loading - set in the panel settings, read from your local library.

Library

Tracks are .ogg files in config/arda-music/library/. Playback is on the client; vanilla music is turned off while ArdaMusic is running.

Track info

/ardamusic info toggles a small overlay with title and composer when a track starts. Admins edit credits in the panel; they're stored on the server.

Volume

Admins can set per-track volume (0–200%) in the panel. That syncs to clients.

Requirements

• Minecraft 1.20.1
• Fabric Loader
• Fabric API
• Fabric Permissions
• ArdaRegions

Optional

• LuckPerms

Setup

1. Install on server

• Put ArdaRegions, Fabric API, and ArdaMusic in mods/
• Start once - config shows up under config/arda-music/

2. Install on client

• Same mods on the client, same ArdaMusic jar as the server

3. Music files

Drop .ogg files in config/arda-music/library/ on each client. Subfolders are fine; the track name is the path under library/ (e.g. ambient/CloudsAndRainTrack.ogg).

4. Wire it up

• Set up regions in ArdaRegions first
• Op yourself or grant ardamusic.admin (see below)
• /ardamusic panel - pick a region, add tracks, priority, fades
• Settings (cog) - fallback lists, menu track, per-world fallbacks
• Credits / Volume buttons - metadata and levels

Server saves music-config.json and pushes changes to clients when someone connects or when you save from the panel.

5. Permissions

Ops at level 2+ can use the panel by default. With LuckPerms (or anything that speaks Fabric Permissions), give ardamusic.admin to whoever should edit music.

Commands

• /ardamusic panel – open the music editor (admin)
• /ardamusic skip – skip to the next track
• /ardamusic info – toggle title/composer overlay

Files

• Library: config/arda-music/library/
• Config: config/arda-music/music-config.json
• Credits: config/arda-music/music-credits.json
• Volumes: config/arda-music/music-volumes.json

Credits

Thanks to everyone who helped:

• Fornad for beta-testing
• Dain for beta-testing
• Xone for textures
• The ArdaCraft team