Skip to content
Jockey Radio

Quick rating

Community listing page, reviews may not be monitored by the author.

Jockey Radio

By atwellpubOwner

No reviews yet

Jukebox radio for Minecraft: mint live radio, internet streams and custom audio onto a music disc, then play it through any jukebox with your friends.

Mod Loaders
Minecraft
26.2

About

Description

A PulseFM radio disc playing from a jukebox between two copper lanterns, with the station on air in the boss bar

Put a live radio station on a Minecraft music disc. Drop a configured disc into any jukebox and everyone nearby hears a live stream, positionally, through Simple Voice Chat, as if a radio were playing in the world. No new items or resource pack, and no Jockey Radio client component; listeners use the Simple Voice Chat client.

  • Minecraft: 26.2 · Loader: Fabric 0.19.3+ · Java: 25
  • Mod id: jockey_radio · Environment: server (Jockey Radio client unsupported)
  • Publisher: GBTI · Featured broadcasting integration: SavePoint

What Jockey Radio is

Jockey Radio turns a jukebox into a live radio with audio that gets louder as you near it and quieter as you walk away from it. Discs are created by players with op permissions, and offer a variety of formats for sourcing media from external locations. In order to hear the audio, the player does need to have the Simple Voice Chat client installed.

We built it to bring community radio into Minecraft. The first goal was simple: let a server play a live or scheduled station broadcast with SavePoint directly in-world, so a community's own radio could air on their server. From there it grew into a general audio bridge. Today a disc can carry a SavePoint station or any HLS stream, an RTMP feed pushed from OBS or a DJ rig, a direct audio URL or an uploaded file, or a link from a supported streaming platform. SavePoint remains the most complete way to run a radio station, but it is one source among many and is never required to use the mod. Additionally, Jockey Radio is a great way to bring spatial music from pre-recorded media files to adventure POIs.

While a disc sits in a jukebox its station plays, and ejecting it stops the feed. Two jukeboxes playing the same disc share one stream. You can place a lantern near a jukebox to enable the Now Playing boss bar.

Requirements

Server

  • Java 25, Fabric Loader 0.19.3+, and Fabric API (0.155.2+26.2 target).
  • Simple Voice Chat (server side) is required. It is how the audio reaches players.
  • ffmpeg (and, for platform links, yt-dlp with the deno JavaScript runtime it uses). The jar on Modrinth bundles these for Linux (AMD64); they self-extract into the config dir on first run (about 279 MB). It carries no Windows executables: a Windows server takes the Linux and Windows jar from the GitHub releases, or puts ffmpeg (and yt-dlp and deno for platform links) on the PATH or sets ffmpegBinary and ytdlpBinary. On other platforms, put ffmpeg on the PATH or set ffmpegBinary.

To listen: Fabric Loader + Fabric API + the Simple Voice Chat client. The Jockey Radio jar is not required on the client.

Client: do not install the Jockey Radio jar client-side. Listeners only need the normal Simple Voice Chat client and its dependencies. Jockey Radio suppresses competing Minecraft background music automatically from the server while a player is near an active radio.

Install

  1. Install Fabric Loader for Minecraft 26.2 on your server.
  2. Put Fabric API, Simple Voice Chat (server), and the Jockey Radio jar in mods/.
  3. Start once: it writes config/jockey_radio.json (no stations by default) and, on your first disc, config/jockey_radio/discs.json.
  4. As an operator, run /jockey to open the admin panel and create your first disc.

Disc sources (and what each gives you)

Every disc is one of four source types. The player-facing experience is identical (a disc in a jukebox), but the audio behind it differs:

Live radio / HLS (SavePoint stations and any HLS)

Streams an HLS playlist and decodes it live. This is the SavePoint station path (https://<host>/radio/broadcast/<id>/trunk.m3u8, with an optional access token that is redacted from every log), and it also plays any other m3u8 / icecast / http stream. A live station drives the now-playing boss bar (station name plus the current track when the source reports it) and shows on air / off air so listeners can tell a live channel from a silent one. SavePoint's Now Playing API supplies the track names.

RTMP receive (push a broadcast in)

The mod runs an ffmpeg RTMP listener; a broadcaster (OBS, a relay, a DJ rig) publishes into it. One publisher, one port per disc, and a stream key gates who may push (never logged, never in item NBT). Do not use port 1935 on a SavePoint host. The mod rejects it, and 1936 is the known-free port.

File / direct URL (looping)

A direct audio URL or a file dropped in config/jockey_radio/audio/, served locally and looped: ambient beds, event music, a fixed track. A file plays continuously rather than showing live/idle.

Platform links (opt-in, off by default)

An off-by-default option (enablePlatformLinks) that ships with the mod but is not an advertised or promoted feature. When an operator enables it, yt-dlp resolves a supported page link to a playable stream. The resolver is generic (it hands the link to yt-dlp); support and reliability vary by site, and some block datacenter IPs.

⚠️ Read before enabling platform links

Pulling a third-party stream into your server and playing it to others may be governed by that platform's Terms of Service and by copyright law. Before enabling enablePlatformLinks, review the Terms of Service of each platform you intend to use and confirm you hold the right to rebroadcast the content on your server. Enabling the setting is your explicit acceptance of that responsibility. Jockey Radio distributes no audio itself, grants no rebroadcasting rights, offers no warranty for platform-link sources, and is not affiliated with or endorsed by any of those platforms.

Admin commands

Run /jockey (op level 3 by default; the gate is re-checked on every dialog submit) to open a vanilla dialog UI where you create, browse, edit, test, give and delete discs, with no client mod needed. Everything is also available as a subcommand:

Command Purpose
/jockey give <discId> [player] Give an admin registry disc
/jockey station [key] [player] Give a disc for a config station
/jockey list / /jockey reload List discs / reload discs.json
/jockey sessions / /jockey diag Tracked sessions + live feed diagnostics
/jockey heal Re-stamp placed discs from the registry (fixes discs made on an earlier build)

Configuration

config/jockey_radio.json (server) holds the knobs; values are validated and clamped on load. The ones you are most likely to touch:

{
  "enablePlatformLinks": false,   // opt-in platform-link resolution, off by default (see the warning above)
  "useBundledBinaries": true,     // self-extract the bundled ffmpeg/yt-dlp/deno
  "adminPermissionLevel": 3,      // op level required by /jockey (0..4)
  "nowPlayingHud": true,          // the NOW-PLAYING boss bar
  "nowPlayingHudMode": "beacon",  // "beacon" (needs a trigger block nearby) or "always"
  "useRawBroadcastPath": true     // SavePoint raw path vs Direct Stream Access
}

Admin discs live in config/jockey_radio/discs.json (managed by the /jockey UI, hand-editable); uploaded FILE-disc audio sits alongside in config/jockey_radio/audio/.

Scaling recommendations

Jockey Radio supports multiple simultaneous discs and stations, but it has not been load-tested at large-server scale. Current testing demonstrates four to six concurrent feeds on the development host; it does not establish a maximum player, disc, station, or jukebox capacity.

For the 0.1.x beta, begin conservatively:

  • Up to four distinct active sources at once.
  • Up to eight active jukeboxes, preferably with non-overlapping audible areas.
  • Increase those numbers gradually while watching Minecraft tick time, CPU, memory, network egress, feed underruns, reconnects, and voice packet quality.

Jukeboxes playing the same managed disc share one upstream ffmpeg feed, but each active jukebox still uses its own Opus encoder and Simple Voice Chat channel. Players inside overlapping audible radii may receive multiple channels, increasing server encoding and network work.

Inactive HLS, direct URL, file, and platform discs use negligible streaming resources. RTMP receive discs are different: when RTMP keep-alive is enabled, every configured RTMP disc keeps a listener available even while unplaced. Configure only the RTMP endpoints you intend to keep active.

These are cautious starting recommendations, not enforced limits or capacity guarantees. Operators should validate capacity on their own hosting tier before using Jockey Radio for a large event.

Setup and support

Credits & license

  • Audio delivery uses the Simple Voice Chat plugin API (a declared dependency, invoked via its API; none of its code is bundled).
  • Bundled binaries: ffmpeg (LGPL build), yt-dlp (Unlicense) and deno (MIT); the pure-Java Concentus Opus encoder is included jar-in-jar. Full notices and license texts ship in THIRD-PARTY-NOTICES.txt inside the jar.
  • Jockey Radio is a GBTI project, with SavePoint as an optional featured broadcasting integration. It is not affiliated with or endorsed by Mojang, Microsoft, or any streaming platform.
  • License: All Rights Reserved (see LICENSE); fabric.mod.json license is ARR.