Airwaves

A shared server radio for Simple Voice Chat. Everyone on your server hears the same music at the same time: your own songs, internet radio, or a live DJ set. It all plays through Simple Voice Chat, so there are no resource packs to download and nothing goes out of sync.

Features

🎵 Three music sources

• Your own music folder. Drop MP3, FLAC, OGG, WAV, M4A, AAC or Opus files into the server's music folder. Subfolders work too.
• Internet radio. Add any direct radio stream (MP3/AAC/OGG, or an .m3u / .pls playlist). Airwaves tests the link before saving it and shows the current song title from the stream.
• Live DJ sets. Stream from your DJ software through Icecast and Airwaves switches to your set automatically when you go live, then back to the music when you stop.

🖥️ In-game menu (press B)

• Now playing: what's on, a progress bar, the queue, skip/stop/shuffle and your own volume.
• Music: search the whole library, play songs, add them to the queue or request them.
• Playlists: make playlists in-game and play them on shuffle.
• Radio & Live: one-click stations, add your own with built-in rules on which URLs work, and go live.
• Settings: personal options for every player, plus server options for DJs.

DJ-only controls are hidden from regular players. Every action is also checked on the server.

📤 Song uploads

Players can drag music files straight onto the Minecraft window (or use a file picker) to upload them to the server.

• Limits per song and per player (default 10 MB per song, 1 GB per player)
• Only files that actually play are kept; everything else is skipped
• The server keeps a configurable amount of disk space free
• Players can delete their own uploads; DJs can rename or delete any song from the Manage tab

🙋 Song requests

Players request songs from the menu or with /music request. DJs get Approve / Deny buttons in chat and in the menu. Requests can also go straight into the queue automatically when no DJ is online.

🔉 Ducking

The music quietly gets softer while someone near you is talking in voice chat, then comes back up. Players can turn it off for themselves, and DJs can set how quiet it goes.

📺 Now-playing display

A small overlay shows the current song or stream title. Drag it anywhere on your screen, resize it, or turn it off.

📜 History

/music history shows the last songs that played, with times and where they came from.

🌍 Languages

English and Dutch. Each player automatically gets their own Minecraft language, including chat messages from the server.

Requirements

• Players without Airwaves can still hear the music and use every /music command. They just don't get the menu, the overlay or uploads.
• Players with Airwaves get the full menu (key B), the now-playing overlay and drag-and-drop uploads.
• Airwaves runs on dedicated servers. In singleplayer it stays off.

Getting started

1. Put Airwaves, Fabric API and Simple Voice Chat in your server's mods folder and start the server.
2. Add music to the music folder next to your server jar (or upload it from in-game).
3. Join and press B, or type /music on.
4. Each player sets their own volume with the slider in the menu, or in the Voice Chat menu (V) under Airwaves.

Ops (permission level 2 by default) are DJs and can control the music.

Commands

Everyone

DJs

/muziek works as an alias.

Live DJ sets

Airwaves plays any Icecast stream as a live set. A typical setup:

1. Install Icecast on your server (or any machine the server can reach).
2. Route your DJ software's output into a streaming app such as BUTT (for example with a virtual audio cable).
3. Point BUTT at your Icecast mount, for example http://your-server:8000/live.
4. Set the same URL in config/airwaves/config.json under live.url.

When the stream comes online, Airwaves announces it and switches over. When it stops, the regular music continues. You can also switch by hand with /music live and /music live stop.

Configuration

Everything is in config/airwaves/config.json. Most settings can also be changed in-game from the Settings tab.

• djPermissionLevel: who counts as a DJ (default 2)
• volume, announce (actionbar, chat or off), autoplayOnStart, listenByDefault
• upload: enabled, permissionLevel, maxFileMB, maxPerPlayerMB, keepFreeMB
• requests: enabled, mode (approve or auto), autoWhenNoDj, maxPerPlayer
• ducking: enabled, duckPercent, holdMs, onByDefault
• live: url, djName, autoSwitch, checkIntervalSeconds
• stations: your saved radio stations
• timeZone: the time zone for /music history (empty = server time zone)

FAQ

Can it play Spotify, YouTube or Apple Music? No. Those services don't offer streams that can be played this way. Use your own files, internet radio, SoundCloud/Bandcamp links or a live DJ set instead.

I don't hear anything. Check that Simple Voice Chat is connected (press V), that your music is on (/music on), and that the Airwaves volume slider in the Voice Chat menu isn't at zero. /music test plays a short beep.

Which radio links work? Direct audio streams only, not web pages with a player. Look up your station on radio-browser.info and copy the stream link. If the link plays straight away in your browser without a website around it, it will work.

Is this legal? Airwaves just plays audio. You are responsible for having the rights to whatever you play to your players.