![preview](https://cdn.modrinth.com/data/cached_images/2684499db6e7e3734d86f4cf6ee082b304d66058.png) # MeYuugaos Radio Mod (EN_US) I've spent the last month working on this mod, and I'm so stoked to finally share it! This project is inspired by the Dragon's Radio mod and is made for the new versions of Minecraft (1.17.1-1.21.8). The mod can play HLS AAC audio streams (.m3u8). ## Required **• [Fabric API](https://modrinth.com/mod/fabric-api)** **• [Cloth Config API](https://modrinth.com/mod/cloth-config)** **• [Tech Reborn](https://www.curseforge.com/minecraft/mc-mods/techreborn)** **• [Reborn Core](https://www.curseforge.com/minecraft/mc-mods/reborncore)** ## Optional **• [Mod Menu](https://modrinth.com/mod/modmenu)** ## Links **• [ModRinth](https://modrinth.com/project/meyuugaos-radio-mod)** **• [Source code](https://github.com/meyuugao/meyuugaos-radio-mod)** **• [Issues](github.com/meyuugao/meyuugaos-radio-mod/issues)** ## Gui ### Radio ![radio_gui](https://cdn.modrinth.com/data/cached_images/36a93d1a6b7e25a2a05afdfd18fbc147590f1b1d_0.webp) **• A status switch (on/off).** **• A text field for audio stream URL.** **• A volume slider.** ### Speaker ![speaker_gui](https://cdn.modrinth.com/data/cached_images/aad37b336e8df4c78a1b8f4e25e78b03fef03739_0.webp) **• A status switch (on/off).** **• A volume slider.** ## Receipes ### Blocks **1. Radio** - the most important block, the source of the sound and signal for the speakers. ![radio_craft](https://cdn.modrinth.com/data/cached_images/3785328591847a85c6ea81a9462122a7d5d440ad.png) **2. Speaker** - the second most important block, which receives a signal from the radio and plays loud enough for the whole world to know your musical tastes. ![speaker_craft](https://cdn.modrinth.com/data/cached_images/c8e5b87a8a65d8202204cdd57ccbb555dcf0a628.png) ### Items **1. Remote controller** - used to control the radio and the speaker: turning the radio and speaker on/off, binding/unbinding a speaker, changing the volume of the radio and speaker, changing the audio stream link. ![remote_controller_craft](https://cdn.modrinth.com/data/cached_images/17ecfc0acfd60f7530a6b14ecf4a50679d2265b3.png) **2. Electronic circuit** - used to create the radio and the speaker. ![electronic_circuit_craft](https://cdn.modrinth.com/data/cached_images/804a9820cdec4496e57716a43a75760193d51d79.png) **3. Antenna** - used to create the radio and the speaker. ![antenna_craft](https://cdn.modrinth.com/data/cached_images/b4849c359240a31af2aa68cb1b6a882078116a8e.png) **4. Battery** - used to create the radio and the speaker. ![battery_craft](https://cdn.modrinth.com/data/cached_images/7f5a6ceed9eff7d993ff4ca2bed0302524b7370e.png) **5. Small battery** - used to create the remote controller. ![small_battery_craft](https://cdn.modrinth.com/data/cached_images/eacae622ee0b3f202430c55d7549fc106ea2c9b9.png) **6. Membrane** - used to create the speaker. ![membrane_craft](https://cdn.modrinth.com/data/cached_images/dfba14cee8eaff11c7a30eb243406723b02570a3.png) **7. Small Membrane** - used to create the radio. ![small_membrane_craft](https://cdn.modrinth.com/data/cached_images/bc9b7801f76ba0c68f2fa300133032b842f419ca.png) ## Functionality ### Remote controller charging To charge the remote controller, press SHIFT + RMB on a charged radio with the remote controller in the main hand. ### Opening radio and speaker gui To open the radio and speaker GUI, press LMB on the block with the remote controller in the main hand. ### Radio control To set the audio stream URL, click on the main text field and paste the URL, then turn on the radio by pressing the power switch. To adjust the volume, drag the volume slider using your mouse or enter the desired volume level manually using your keyboard. ### Speaker control To turn on the speaker, press the power switch. To adjust the volume, drag the volume slider using your mouse or enter the desired volume level manually using your keyboard. ### Speaker binding To bind a speaker, press the RMB with the charged remote controller in the main hand first on the radio you want to link the speaker to, and then on the speaker you want to bind. ### Volume setting Using the Mod Menu, you can adjust the overall volume of all radios and speakers: ![modmenu](https://cdn.modrinth.com/data/cached_images/8d7b9d84898c66f320c9ae695cd92bc78b82529f.png) ## Notes #### An unlimited number of speakers can be connected to a single radio. #### The maximum distance at which a speaker can be connected to a radio is determined by the gamerule named "meyuugaosradioConnectRadius", which is set to 50 by default. ## AzuraCast Installing Guide (your personal public radio station) If you are using Windows, we will use the "WSL" (Windows Subsystem for Linux) tool, which allows you to run Linux distributions in an isolated environment without the need for virtual machines or restarting your PC. If you are using Linux, simply skip the installation of WSL and Docker on Windows. ### Installing WSL First, open powershell as an administrator and run the following command: ``` wsl --install ``` Wait for the distribution to download and install, and set a username and password: ![wsl](https://cdn.modrinth.com/data/cached_images/63a1c2466a1cb7bdf7fb5ff57b4f83158a4a5216.png) **NOTE: in the terminal, when you enter a password, all characters are hidden. You won't see what you're writing.** ### Installing and configuring Docker, AzuraCast, and localtunnel First, install Docker Desktop using [this link](https://www.docker.com/products/docker-desktop). Open cmd as an administrator and enter the following commands one by one: ``` wsl --set-default-version 2 wsl --set-default Ubuntu ``` ![cmd_wsl](https://cdn.modrinth.com/data/cached_images/e65bfaf5996216a7edeb8041eaeda06513585e9a.png) Next, open the Ubuntu terminal: ![ubuntu](https://cdn.modrinth.com/data/cached_images/3f67eb41de3e962cfc2f1a539a2c724cd4616819_0.webp) Enter the following commands one by one and follow the installation instructions: ``` sudo su - mkdir -p /var/azuracast cd /var/azuracast curl /fsSL https://raw.githubusercontent.com/AzuraCast/AzuraCast/main/docker.sh > docker.sh chmod a+x docker.sh ./docker.sh install ``` **NOTE: replace "/fsSL" with "-fsSL", the site doesn't allow you to write "curl" and "-fsSL" together, so I had to replace '-' with '/'.** **NOTE: When asked "You should update the Docker utility script after changing release channels. Should it be updated automatically now?", answer "n".** ![ubuntu1](https://cdn.modrinth.com/data/cached_images/1f2ae99eab9a35208f1bb8d93c40f40e26a71f0c.png) ![ubuntu2](https://cdn.modrinth.com/data/cached_images/4fb69bd8e2f65dca3940a18fd120f34d5fb87868.png) ![ubuntu3](https://cdn.modrinth.com/data/cached_images/41839cf74a33c7b7aff2b0c3677e9c0fd5624e5b.png) ![ubuntu4](https://cdn.modrinth.com/data/cached_images/4dfcb39fab1f891a5674e49c0a63dc4aaa0b99e1.png) Now you need to install localtunnel. Without closing the current session, enter the following commands in the Ubuntu terminal one by one: ``` apt install nodejs npm npm install -g localtunnel ``` ![localtunnel](https://cdn.modrinth.com/data/cached_images/b47541122cae8e233db1d83bfb5cb5546b4dcd83.png) ### Starting and configuring the radio Launch the Ubuntu terminal and enter these commands one by one: ``` sudo su - cd /var/azuracast docker compose up -d lt --port 80 ``` ![run](https://cdn.modrinth.com/data/cached_images/5107ce7d0af86b123f9e1ee5f30eeca2bf7de85e.png) Next, copy the link and click on it in your browser. When you first launch the program, you will need to create a super administrator account: ![run1](https://cdn.modrinth.com/data/cached_images/afb2aac8a5f8d6eac8385c92497152afeb9198cf.png) After creating an account, set the name of your radio station, enable HLS, and set the link you copied as the main URL of your site: (every time you create a new link, you will need to update it in the settings) ![run2](https://cdn.modrinth.com/data/cached_images/f874eb8957edd6f38d1680e6662784ca12da4c50.png) ![run3](https://cdn.modrinth.com/data/cached_images/90fa302bd36ce2f8141b55b4bedacc4977fb3a75.png) ![run4](https://cdn.modrinth.com/data/cached_images/bd0ce0036dbc1fc0b98f6a8eb7d83649f74fd690.png) Also, set the "Always use HTTPS" slider to ON: ![run5](https://cdn.modrinth.com/data/cached_images/037c59ae6e356dbda61b2400f0af84c19f65c0a4.png) Now start your station by restarting the configuration. ![run6](https://cdn.modrinth.com/data/cached_images/9bc3c80c4ce431ecd3236407c396b3bf2aff14f1.png) ![run7](https://cdn.modrinth.com/data/cached_images/e1167936517c1c4b427f345117cdff1fcdef30ed.png) Add the tracks you want in this tab: ![run8](https://cdn.modrinth.com/data/cached_images/83e4ed163743111cc15f1f6cd541a100f5b9ce5b.png) Next, copy this link: ![run9](https://cdn.modrinth.com/data/cached_images/0e1c3942fa175cbb73e4056cc708634f3eea0611.png) Turn on the station, paste the audio stream URL into the radio, and the end will automatically change to aac_hifi.m3u8, and your music will start playing! # MeYuugaos Radio Mod (RU_RU) Я потратил около месяца в работе над этим модом и я очень рад, что наконец-то могу выложить его на ModRinth! Этот проект вдохновлен Dragon's Radio mod и создан для новых версий Minecraft (1.17.1-1.21.8). Мод может воспроизводить аудиопотоки HLS AAC (.m3u8). ## Необходимо **• [Fabric API](https://modrinth.com/mod/fabric-api)** **• [Cloth Config API](https://modrinth.com/mod/cloth-config)** **• [Tech Reborn](https://www.curseforge.com/minecraft/mc-mods/techreborn)** **• [Reborn Core](https://www.curseforge.com/minecraft/mc-mods/reborncore)** ## Опционально **• [Mod Menu](https://modrinth.com/mod/modmenu)** ## Ссылки **• [ModRinth](https://modrinth.com/project/meyuugaos-radio-mod)** **• [Исходный код](https://github.com/meyuugao/meyuugaos-radio-mod)** **• [Проблемы?](github.com/meyuugao/meyuugaos-radio-mod/issues)** ## Гуи ### Радио ![radio_gui](https://cdn.modrinth.com/data/cached_images/36a93d1a6b7e25a2a05afdfd18fbc147590f1b1d_0.webp) **• Переключатель состояния (вкл/выкл).** **• Текстовое поле для ссылки на аудиопоток.** **• Ползунок громкости.** ### Динамик ![speaker_gui](https://cdn.modrinth.com/data/cached_images/aad37b336e8df4c78a1b8f4e25e78b03fef03739_0.webp) **• Переключатель состояния (вкл/выкл).** **• Ползунок громкости.** ## Рецепты ### Блоки **1. Радио** - самый важный блок, источник звука и сигнала для динамиков. ![radio_craft](https://cdn.modrinth.com/data/cached_images/3785328591847a85c6ea81a9462122a7d5d440ad.png) **2. Динамик** - второй по важности блок, который принимает сигнал от радио и звучит достаточно громко, чтобы весь мир узнал о ваших музыкальных вкусах! ![speaker_craft](https://cdn.modrinth.com/data/cached_images/c8e5b87a8a65d8202204cdd57ccbb555dcf0a628.png) ### Предметы **1. Пульт дистанционного управления** - используется для управления радио и динамиком: включения/выключения радио и динамика, привязки/отвязки динамика, изменения громкости радио и динамика, изменения ссылки на аудиопоток. ![remote_controller_craft](https://cdn.modrinth.com/data/cached_images/17ecfc0acfd60f7530a6b14ecf4a50679d2265b3.png) **2. Электронная схема** - используется для крафта радио и динамика. ![electronic_circuit_craft](https://cdn.modrinth.com/data/cached_images/804a9820cdec4496e57716a43a75760193d51d79.png) **3. Антенна** - используется для крафта радио и динамика. ![antenna_craft](https://cdn.modrinth.com/data/cached_images/b4849c359240a31af2aa68cb1b6a882078116a8e.png) **4. Батарея** - используется для крафта радио и динамика. ![battery_craft](https://cdn.modrinth.com/data/cached_images/7f5a6ceed9eff7d993ff4ca2bed0302524b7370e.png) **5. Маленькая батарейка** - используется для крафта пульта дистанционного управления. ![small_battery_craft](https://cdn.modrinth.com/data/cached_images/eacae622ee0b3f202430c55d7549fc106ea2c9b9.png) **6. Мембрана** - используется для крафта динамика. ![membrane_craft](https://cdn.modrinth.com/data/cached_images/dfba14cee8eaff11c7a30eb243406723b02570a3.png) **7. Маленькая мембрана** - используется для крафта радио. ![small_membrane_craft](https://cdn.modrinth.com/data/cached_images/bc9b7801f76ba0c68f2fa300133032b842f419ca.png) ## Функциональность ### Зарядка пульта дистанционного управления Для зарядки пульта дистанционного управления необходимо нажать SHIFT + ПКМ по заряженному радио с пультом в основной руке. ### Открытие гуи радио и динамика Для открытия гуи радио и динамика необходимо нажать ЛКМ по блоку с пультом в основной руке. ### Управление радио Чтобы задать URL аудиопотока, нажмите на основное текстовое поле и вставьте URL, затем включите радио, нажав на переключатель. Для регулировки громкости можно перетаскивать ползунок громкости с помощью мышки или ввести нужный уровень громкости вручную с помощью клавиатуры. ### Управление динамиком Чтобы включить динамик, нажмите на переключатель. Для регулировки громкости можно перетаскивать ползунок громкости с помощью мышки или ввести нужный уровень громкости вручную с помощью клавиатуры. ### Привязка динамика Чтобы привязать динамик, нажмите ПКМ заряженнным пультом сначала по радио, к которому хотите привязать динамик, а потом по динамику, который хотите привязать. ### Настройка звука Используя Mod Menu, вы можете регулировать общую громкость всех радио и динамиков: ![modmenu](https://cdn.modrinth.com/data/cached_images/8d7b9d84898c66f320c9ae695cd92bc78b82529f.png) ## Заметки #### К одному радио может быть привязано неограниченное кол-во динамиков #### Максимальное расстояние, на котором динамик может быть привязан к радио определяется определяется gamerule с названием "meyuugaosradioConnectRadius", которое по умолчанию равно 50. ## Гайд по установке AzuraCast (ваша личная публичная радиостанция) Если вы используете Windows, мы будем использовать инструмент "WSL" (Windows Subsystem for Linux), который позволяет запускать Linux-дистрибутивы в изолированной среде без необходимости использования виртуальных машин или перезагрузки ПК. Если вы используете Linux, просто пропустите установку WSL и Docker в Windows. ### Установка WSL Первым делом, откройте powershell от имени администратора и пропишите следующую команду: ``` wsl --install ``` Дождитесь скачивания и установки дистрибутива, задайте имя пользователя и пароль: ![wsl](https://cdn.modrinth.com/data/cached_images/63a1c2466a1cb7bdf7fb5ff57b4f83158a4a5216.png) **ЗАМЕТКА: В терминале при введении пароля все символы скрыты. Вы не будете видеть то, что пишете.** ### Установка и настройка Docker, AzuraCast, localtunnel Первым делом установите Docker Desktop по [этой ссылке](https://www.docker.com/products/docker-desktop). Откройте cmd от имени администратора и впишите туда следующие команды по очереди: ``` wsl --set-default-version 2 wsl --set-default Ubuntu ``` ![cmd_wsl](https://cdn.modrinth.com/data/cached_images/e65bfaf5996216a7edeb8041eaeda06513585e9a.png) Далее откройте терминал Ubuntu: ![ubuntu](https://cdn.modrinth.com/data/cached_images/3f67eb41de3e962cfc2f1a539a2c724cd4616819_0.webp) Впишите туда следующие команды по очереди и следуйте инструкциям по установке: ``` sudo su - mkdir -p /var/azuracast cd /var/azuracast curl /fsSL https://raw.githubusercontent.com/AzuraCast/AzuraCast/main/docker.sh > docker.sh chmod a+x docker.sh ./docker.sh install ``` **ЗАМЕТКА: Замените "/fsSL" на "-fsSL", сайт не разрешает написать "curl" и "-fsSL" вместе, отчего я вынужден был заменить '-' на '/'.** **ЗАМЕТКА: На вопрос "You should update the Docker Utility Script after changing release channels. Automatically update it now?", ответьте "n".** ![ubuntu1](https://cdn.modrinth.com/data/cached_images/1f2ae99eab9a35208f1bb8d93c40f40e26a71f0c.png) ![ubuntu2](https://cdn.modrinth.com/data/cached_images/4fb69bd8e2f65dca3940a18fd120f34d5fb87868.png) ![ubuntu3](https://cdn.modrinth.com/data/cached_images/41839cf74a33c7b7aff2b0c3677e9c0fd5624e5b.png) ![ubuntu4](https://cdn.modrinth.com/data/cached_images/4dfcb39fab1f891a5674e49c0a63dc4aaa0b99e1.png) Теперь нужно установить localtunnel. Не закрывая текущую сессию, введите в терминал Ubuntu следующие команды по очереди: ``` apt install nodejs npm npm install -g localtunnel ``` ![localtunnel](https://cdn.modrinth.com/data/cached_images/b47541122cae8e233db1d83bfb5cb5546b4dcd83.png) ### Запуск и настройка радио Запустите терминал Ubuntu и пропишите эти команды по очереди: ``` sudo su - cd /var/azuracast docker compose up -d lt --port 80 ``` ![run](https://cdn.modrinth.com/data/cached_images/5107ce7d0af86b123f9e1ee5f30eeca2bf7de85e.png) Далее копируйте ссылку и перейдите по ней в вашем браузере. При первом запуске вам необходимо будет создать учётную запись суперадминистратора: ![run1](https://cdn.modrinth.com/data/cached_images/afb2aac8a5f8d6eac8385c92497152afeb9198cf.png) После создания учётной записи, задайте название вашей радиостанции, включите HLS и как основной url-адрес сайта установите ссылку, которую вы скопировали: (каждый раз, когда вы делаете новую ссылку, её будет необходимо обновлять в настройках) ![run2](https://cdn.modrinth.com/data/cached_images/f874eb8957edd6f38d1680e6662784ca12da4c50.png) ![run3](https://cdn.modrinth.com/data/cached_images/90fa302bd36ce2f8141b55b4bedacc4977fb3a75.png) ![run4](https://cdn.modrinth.com/data/cached_images/bd0ce0036dbc1fc0b98f6a8eb7d83649f74fd690.png) А также установите ползунок "Всегда использовать HTTPS" в состояние ВКЛ: ![run5](https://cdn.modrinth.com/data/cached_images/037c59ae6e356dbda61b2400f0af84c19f65c0a4.png) Теперь запустите вашу станцию, перезапустив конфигурацию. ![run6](https://cdn.modrinth.com/data/cached_images/9bc3c80c4ce431ecd3236407c396b3bf2aff14f1.png) ![run7](https://cdn.modrinth.com/data/cached_images/e1167936517c1c4b427f345117cdff1fcdef30ed.png) Добавьте нужные вам треки в этой вкладке: ![run8](https://cdn.modrinth.com/data/cached_images/83e4ed163743111cc15f1f6cd541a100f5b9ce5b.png) Далее скопируйте эту ссылку: ![run9](https://cdn.modrinth.com/data/cached_images/0e1c3942fa175cbb73e4056cc708634f3eea0611.png) Включите станцию, вставьте ссылку на аудиопоток в радио, её конец автоматически изменится на aac_hifi.m3u8 и ваша музыка заиграет!

TheCMK