NavidromeMod/README.md

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. Для работы на мультиплеерном сервере установите мод и на сервер, и на клиенты.