Community listing page, reviews may not be monitored by the author.
Jockey Radio
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.
Community voices
Reviews
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
Compatibility
Supported Environments
Runs on a dedicated server only; does not work in singleplayer.
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
About
Description

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.2target). - 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(andyt-dlpanddenofor platform links) on thePATHor setsffmpegBinaryandytdlpBinary. On other platforms, putffmpegon thePATHor setffmpegBinary.
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
- Install Fabric Loader for Minecraft 26.2 on your server.
- Put Fabric API, Simple Voice Chat (server), and the Jockey Radio jar in
mods/. - Start once: it writes
config/jockey_radio.json(no stations by default) and, on your first disc,config/jockey_radio/discs.json. - As an operator, run
/jockeyto 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
- Project page on gbti.network
- User setup guides
- SavePoint connection guide
- Source repository
- Issue tracker
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.txtinside 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.jsonlicenseisARR.
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Get it on
Available Platforms
On ModDex
Community snapshot
By the numbers