📻 Boombox

Your own radio and music player, right inside Minecraft.
Listen to thousands of internet radio stations or your own MP3 / OGG / WAV tracks, without ever leaving the game.

Fabric • Client-side • Minecraft 26.3

✨ Features

🌍 Internet radio

• Browse thousands of live stations powered by the free Radio Browser directory.
• Search by name, or filter by genre and country.
• Built-in genre shortcuts: lo-fi, chillout, electronic, trance, house, dance, pop, rock, metal, indie, hip hop, rap, jazz, blues, classical, folk, reggae, chanson, news.
• If the connection drops, the player reconnects by itself and retries before giving up.
• Ships with a cozy default station (SomaFM Groove Salad), so you can press play right away.

🎵 Your own music

• Drop MP3, OGG or WAV files into the boombox/music folder in your game directory and they show up in the player.
• No external programs, no extra mods, no codecs to install: decoders are bundled.

⭐ Favorites & playlists

• Mark any station or track as a favorite.
• Create and delete your own playlists and fill them with tracks and stations.
• Everything is saved to a small JSON file, so your library survives updates and is easy to back up.

🔁 Playback control

• Shuffle and repeat (off / one track / whole list).
• Pause, next and previous track, volume control, all from the player screen or by hotkey.
• Auto-play on join: your music starts when you enter a world.
• Auto-pause when the game is paused or when the window loses focus.

📊 Now Playing HUD

• A sleek in-game overlay showing the current station or track.
• Real-time spectrum visualizer (FFT-based equalizer bars).
• Optional elapsed time display.
• Choose the screen corner, margin, opacity and accent color.
• Show it always, or only for a few seconds when the track changes.

🔊 Volume that makes sense

Link Boombox to Minecraft's own sound sliders, or keep it fully independent:

⌨️ Hotkeys

All keys live under Options → Controls → Boombox and can be rebound freely.

⚙️ Settings

Open the settings from the Boombox screen. Everything is stored in config/boombox.json.

📦 Installation

1. Install Fabric Loader 0.19.5 or newer.
2. Install Fabric API.
3. Make sure you are running Java 25+ and Minecraft 26.3.
4. Put boombox-1.2v.jar into your mods folder.
5. Launch the game and set a key for Open Boombox in Options → Controls → Boombox.

Adding your own music: put your .mp3, .ogg and .wav files into <game folder>/boombox/music. The folder is created automatically.

❓ FAQ

Do I need to install it on the server? No. Boombox is entirely client-side and works on any server, including vanilla ones.

Will the music be heard by other players? No. Audio plays only on your computer.

Why is a station not playing? Some stations in public directories go offline or use unsupported formats. Boombox only lists MP3 streams. Try another station: the list is sorted by popularity.

Does it need an internet connection? Only for radio. Your local tracks play fully offline.

Where is my data stored? config/boombox.json (settings) and config/boombox-library.json (favorites and playlists).

🧩 Compatibility

📜 Credits & license

• Made by _Shain35.
• Radio station data: Radio Browser.
• Bundled libraries for audio decoding: JLayer (MP3) and JOrbis (OGG).
• Boombox is released under MIT.

<details> <summary>🇷🇺 Русская версия описания (нажмите, чтобы открыть)</summary>

📻 Boombox

Свой радиоприёмник и музыкальный плеер прямо в Minecraft.
Слушайте тысячи интернет-радиостанций или собственные треки MP3 / OGG / WAV, не выходя из игры.

Fabric • Только клиент • Minecraft 26.3

✨ Возможности

🌍 Интернет-радио

• Тысячи живых станций из бесплатного каталога Radio Browser.
• Поиск по названию, а также фильтры по жанру и стране.
• Готовые жанры: lo-fi, chillout, electronic, trance, house, dance, pop, rock, metal, indie, hip hop, rap, jazz, blues, classical, folk, reggae, chanson, news.
• Если соединение прервалось, плеер сам переподключается и делает несколько попыток.
• В комплекте уютная станция по умолчанию (SomaFM Groove Salad), так что можно сразу нажимать play.

🎵 Ваша музыка

• Положите файлы MP3, OGG или WAV в папку boombox/music в директории игры, и они появятся в плеере.
• Не нужны сторонние программы, дополнительные моды и кодеки: декодеры уже встроены.

⭐ Избранное и плейлисты

• Добавляйте станции и треки в избранное.
• Создавайте и удаляйте свои плейлисты, наполняя их треками и станциями.
• Всё хранится в небольшом JSON-файле, поэтому библиотека не пропадает при обновлениях, и её легко сохранить.

🔁 Управление воспроизведением

• Перемешивание и повтор (выкл. / один трек / весь список).
• Пауза, следующий и предыдущий трек, громкость: из окна плеера или горячими клавишами.
• Автозапуск при входе в мир: музыка включается, как только вы заходите.
• Автопауза, когда игра на паузе или окно потеряло фокус.

📊 HUD «Сейчас играет»

• Стильная плашка в игре с названием текущей станции или трека.
• Спектр в реальном времени (эквалайзер на основе FFT).
• Время воспроизведения по желанию.
• Настраиваются угол экрана, отступ, прозрачность и акцентный цвет.
• Показывать всегда или только на несколько секунд при смене трека.

🔊 Понятная громкость

Привяжите Boombox к ползункам звука Minecraft или оставьте полностью независимым:

⌨️ Горячие клавиши

Все клавиши находятся в Настройки → Управление → Boombox и переназначаются как угодно.

⚙️ Настройки

Открываются из окна Boombox. Все параметры хранятся в config/boombox.json.

📦 Установка

1. Установите Fabric Loader версии 0.19.5 или новее.
2. Установите Fabric API.
3. Убедитесь, что у вас Java 25+ и Minecraft 26.3.
4. Положите boombox-1.2v.jar в папку mods.
5. Запустите игру и назначьте клавишу для Open Boombox в Настройки → Управление → Boombox.

Как добавить свою музыку: положите файлы .mp3, .ogg и .wav в <папка игры>/boombox/music. Папка создаётся автоматически.

❓ Частые вопросы

Нужно ли ставить мод на сервер? Нет. Boombox полностью клиентский и работает на любом сервере, в том числе ванильном.

Услышат ли музыку другие игроки? Нет. Звук играет только на вашем компьютере.

Почему не играет станция? Некоторые станции в публичных каталогах отключаются или используют неподдерживаемые форматы. Boombox показывает только MP3-потоки. Попробуйте другую станцию: список отсортирован по популярности.

Нужен ли интернет? Только для радио. Локальные треки играют полностью офлайн.

Где хранятся данные? config/boombox.json (настройки) и config/boombox-library.json (избранное и плейлисты).

🧩 Совместимость

📜 Авторы и лицензия

• Автор: _Shain35.
• Данные о радиостанциях: Radio Browser.
• Встроенные библиотеки для декодирования звука: JLayer (MP3) и JOrbis (OGG).
• Boombox распространяется под лицензией MIT.