Mine-ify

Mineify — серверный музыкальный плеер для Minecraft

Мод для Minecraft на Fabric, который включает воспроизведение музыки на всём сервере. Игроки могут искать видео на YouTube, добавлять песни в общий плейлист и слушать вместе в реальном времени прямо внутри Minecraft.

Использование

1. Зайдите на сервер с установленным Mineify
2. Нажмите N+M, чтобы открыть интерфейс
3. Введите название песни в строке поиска и нажмите Enter
4. Кликните по результату, чтобы добавить его в плейлист
5. Песня скачается и автоматически заиграет у всех подключённых игроков

Как это работает

Всё работает внутри процесса сервера Minecraft — никаких дополнительных сервисов и открытых портов не требуется.

┌─────────────────────────────────────────────────────────────────────┐
│                         MINECRAFT SERVER                            │
│  ┌─────────────────┐    ┌──────────────────┐                        │
│  │  Mineify Mod    │◄──►│ Playlist Manager │                        │
│  │  (Server-side)  │    │ (Track Queue)    │                        │
│  └────────┬────────┘    └──────────────────┘                        │
│           │                                                         │
│           │  ┌─────────────────┐  ┌──────────────────────────────┐  │
│           ├─►│ YouTubeService  │  │   AudioDownloadService       │  │
│           │  │ (InnerTube API) │  │   yt-dlp subprocess          │  │
│           │  └─────────────────┘  └──────────────────────────────┘  │
│           │                                                         │
│           │  Minecraft packets (chunked audio data)                 │
│           ▼                                                         │
│  ┌─────────────────┐    ┌──────────────────┐                        │
│  │  Mineify Mod    │───►│  AudioPlayer     │                        │
│  │  (Client-side)  │    │  (javax.sound)   │                        │
│  └─────────────────┘    └──────────────────┘                        │
└─────────────────────────────────────────────────────────────────────┘

1. YouTubeService обращается к внутреннему API YouTube InnerTube напрямую из Java — API-ключ не нужен.
2. AudioDownloadService запускает yt-dlp как подпроцесс, чтобы скачать и конвертировать аудио в WAV.
3. Сервер разбивает WAV-файл на чанки и рассылает их каждому клиенту через существующее соединение Minecraft — открывать дополнительные порты не нужно.
4. Клиенты собирают чанки в памяти и воспроизводят аудио локально через javax.sound.sampled.

Возможности

• Клавиша N+M — открывает интерфейс Mineify из любого места в игре
• Поиск на YouTube — ищите песни прямо внутри Minecraft
• Общий плейлист — все игроки видят одну и ту же очередь и могут её пополнять
• Автовоспроизведение — песни играют сразу после добавления и сменяются по очереди
• Синхронизация для подключившихся позже — игроки, зашедшие посреди песни, автоматически перематывают на нужную позицию
• Остановка при удалении — удаление текущей песни мгновенно останавливает воспроизведение у всех
• Кэш сессии — скачанные файлы переиспользуются в течение всей сессии сервера
• Без дополнительных портов — аудио передаётся через соединение Minecraft; менять настройки фаервола не нужно
• Самодостаточность — всё внутри одного JAR-мода, никаких дополнительных сервисов

Требования

Клиентам нужен только JAR-мод — никаких дополнительных инструментов.

Установка

Сервер

1. Установите Fabric Loader для Minecraft 1.21.11.
2. Установите yt-dlp и ffmpeg на машине сервера (см. руководство ниже).
3. Поместите Fabric API и mineify-1.3.0.jar в папку mods/ сервера.
4. Запустите сервер. Mineify инициализируется автоматически.

Опционально — создайте config/mineify.json, чтобы настроить поведение:

{
  "downloadDir": "./mineify-downloads",
  "maxPlaylistSize": 50
}

Клиент

1. Установите Fabric Loader для Minecraft 1.21.11.
2. Поместите Fabric API и mineify-1.3.0.jar в .minecraft/mods/.
3. Запустите Minecraft с профилем Fabric. Больше ничего настраивать не нужно.

Установка yt-dlp и ffmpeg

Оба инструмента нужны только на сервере.

Linux (Debian/Ubuntu)

sudo apt update && sudo apt install ffmpeg
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp

Linux (Fedora/RHEL)

sudo dnf install ffmpeg
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp

macOS

brew install ffmpeg yt-dlp

Windows (выберите один пакетный менеджер)

scoop install yt-dlp ffmpeg

choco install yt-dlp ffmpeg

winget install yt-dlp ffmpeg

Windows — ручная установка

yt-dlp:

1. Скачайте yt-dlp.exe со страницы релизов
2. Поместите его в папку, например C:\yt-dlp
3. Добавьте эту папку в системную переменную PATH

ffmpeg:

1. Скачайте с gyan.dev
2. Распакуйте в папку, например C:\ffmpeg
3. Добавьте C:\ffmpeg\bin в системную переменную PATH

Добавление в PATH (Windows):

1. Нажмите Win + R, введите sysdm.cpl, нажмите Enter
2. Перейдите в Дополнительно → Переменные среды
3. В разделе Системные переменные выберите Path → Изменить → Создать
4. Добавьте путь к папке и нажмите ОК во всех диалогах
5. Перезапустите терминал/сервер

Проверка установки

yt-dlp --version
ffmpeg -version

Обе команды должны вывести информацию о версии без ошибок.

Структура проекта

mine-ify/
├── fabric-mod/
│   └── src/
│       ├── main/java/com/mineify/
│       │   ├── Mineify.java                  # Точка входа сервера и жизненный цикл
│       │   ├── MineifyConfig.java            # Загрузчик конфига (mineify.json)
│       │   ├── server/
│       │   │   ├── PlaylistManager.java      # Состояние плейлиста и отправка аудио
│       │   │   ├── YouTubeService.java       # Поиск по YouTube через InnerTube API
│       │   │   └── AudioDownloadService.java # Обёртка для скачивания через yt-dlp
│       │   └── network/
│       │       ├── MineifyPackets.java       # Регистрация пакетов
│       │       └── packets/
│       │           ├── SearchRequestPacket.java
│       │           ├── AddToPlaylistPacket.java
│       │           ├── SearchResultsPacket.java
│       │           ├── PlaylistSyncPacket.java
│       │           ├── AudioChunkPacket.java  # Доставка аудио по чанкам
│       │           └── NowPlayingPacket.java
│       └── client/java/com/mineify/
│           ├── MineifyClient.java            # Точка входа клиента и обработчики пакетов
│           └── client/
│               ├── MineifyScreen.java        # Внутриигровой GUI
│               ├── MineifyKeybinds.java      # Регистрация клавиши N
│               └── audio/
│                   └── AudioPlayer.java      # Буферизация чанков и воспроизведение
└── README.md

Разработка

Требуется Java 21.

cd fabric-mod
./gradlew build          # Собрать JAR мода
./gradlew runClient      # Запустить тестовый клиент Minecraft
./gradlew runServer      # Запустить тестовый сервер без графики

Правовая информация

Этот мод предназначен для личного и образовательного использования. Пользователи несут ответственность за соблюдение Условий использования YouTube и применимых законов об авторском праве.

Лицензия

MIT License — подробности в LICENSE.