Initial commit: NavidromePlayer mod

2026-09-29 20:46:28 +03:00
commit 34d66d6bed
123 changed files with 135791 additions and 0 deletions
@@ -0,0 +1,50 @@
+# 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. Для работы на мультиплеерном сервере установите мод и на сервер, и на клиенты.