Files
NavidromeMod/README.md
T

51 lines
3.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Navidrome Player Mod (Minecraft 1.16.5 Forge)
Мод для Minecraft 1.16.5 (Forge), добавляющий **блок-проигрыватель с поддержкой Subsonic / Navidrome API**.
---
### Основные возможности:
1. **Качественный стереозвук («звук в наушниках»):**
* Музыка играет напрямую в аудиовыход игрока без затухания и искажений ванильного 3D-звука пластинок.
* Звук играет **везде** (на любой дистанции), пока вы не остановите плеер.
2. **Поддержка форматов (включая FLAC):**
* Полноценная поддержка стриминга **FLAC (Lossless)** и **MP3** без предварительной загрузки всего файла.
* В интерфейсе отображаются бейджи формата: `[FLAC]` (голубой) и `[MP3]` (золотой).
3. **Безопасность и приватность в мультиплеере:**
* Блок привязывается к игроку, который его поставил (`ownerUuid`).
* Меню выбора музыки, поиск и настройки сервера видит **только владелец блока**.
* Другие игроки при нажатии ПКМ видят сообщение: *"Этот проигрыватель принадлежит <Имя_Игрока>. Доступ закрыт!"*.
* Пароль и токен доступа к вашему серверу Navidrome сохраняются **только локально** на вашем клиенте (`config/navidrome_player.json`) и не передаются другим игрокам на сервере Minecraft.
4. **Удобный и красивый интерфейс (GUI):**
* **Поиск:** строка поиска по трекам, альбомам и исполнителям.
* **Плейлисты:** отображение ваших плейлистов из Navidrome и треков внутри них.
* **Альбомы:** список недавних альбомов с переходом к списку треков.
* **Панель управления воспроизведением:**
* Отображение текущего трека: *"Исполнитель - Название"*.
* Прогресс трека и таймер (`01:23 / 03:45`).
* Кнопки: `|<` (предыдущий), `Пауза` / `Играть`, `Стоп`, `>|` (следующий).
* Интерактивный ползунок громкости `0% - 100%`.
* **Настройки:**
* Адрес сервера (например `http://192.168.1.100:4533` или домен `https://music.example.com`).
* Логин и пароль.
* Кнопка «Проверить» (выполняет ping к Subsonic API и показывает статус/версию).
* Кнопка «Сохранить».
---
### Крафт блока:
* В верстаке:
* В центре — ванильный **Проигрыватель** (Jukebox).
* Сверху, снизу, слева и справа — **Красная пыль** (Redstone Dust).
* Или возьмите блок из вкладки «Красный камень» в креативе.
---
### Сборка и установка:
* Готовый JAR-файл мода:
`build/libs/navidromeplayer-1.0.0.jar`
* Для установки:
1. Скопируйте `navidromeplayer-1.0.0.jar` в папку `.minecraft/mods`.
2. Убедитесь, что установлен **Minecraft Forge 1.16.5** (версия 36.2.39 или новее).
3. Для работы на мультиплеерном сервере установите мод и на сервер, и на клиенты.