MediaRadio(v1.4.0)

Required Dependency

This mod requires Media-Tools, which provides the embedded yt-dlp and ffmpeg binaries. Download it here: https://www.curseforge.com/hytale/mods/media-tools

This mod also requires HyUI for v1.4 & Up, Download it here: https://www.curseforge.com/hytale/mods/hyui

Install both the MediaRadio mod, Media-Tools & HyUI into your mods folder.

MediaRadio is a Hytale mod that lets players stream web audio through a Portable Radio (handheld) or a placeable Boombox. Music only plays while the Portable Radio is held (main hand or offhand), or while a Boombox is placed, and the UI provides a media-player style interface with play/pause/stop, seek, looping, and a per-player library.

Older versions older then 1.2 are not supported please update before reporting any issues. MediaRadio now requires a library called media-tools which makes install easy for newer versions.

Screenshots

Portable Radio held

Boombox placed

MediaRadio UI

Library UI

Playlists UI (Main)

Playlists UI (Selected)

Features

Plays web audio from supported URLs (YouTube, etc.) using embedded yt-dlp + ffmpeg.
Audio is downloaded, converted to OGG, and chunked for streaming (with reduced streaming lag).
Portable Radio (handheld) and Boombox (placeable) items.
Per-player libraries: each player only sees the songs they requested.
Thumbnails are downloaded and registered as dynamic assets.
Playback pauses automatically when the Portable Radio is not held.
Portable Radio includes a proper model and animation set.

Playback System

Playback is session-based and chunk-scheduled:

A MediaPlaybackManager manages active playback sessions for handheld radios (per-player) and boomboxes (per-block position).
Tracks are played by scheduling chunked SoundEvent assets, and an audio-marker NPC is used to keep the audio source positioned correctly in-world.

Recipe

Crafted at a Furniture Bench (Furniture Misc).
Portable Radio and Boombox both cost 15 Iron Bars, 25 Copper Bars, and 5 Rubble.

Setup

Singleplayer

Place the MediaRadio mod jar and the Media-Tools mod jar into your Hytale mods folder.
Start the world.
Obtain the Portable Radio or Boombox and open its UI to begin playback.

Dedicated Server

Place both MediaRadio and Media-Tools mod jars into the server’s mods folder.
Start the server and join a world.
Obtain the Portable Radio or Boombox and open its UI to begin playback.

Notes

Both MediaRadio and Media-Tools must be installed for streaming to work.
Runtime assets are stored under /media_radio_assets.
An internet connection is required for downloading and streaming audio.