Music Player

Minecraft Music Player

Minecraft Music Player — это музыкальный мод для Fabric для Minecraft 1.21.11. Он добавляет поиск по NetEase Cloud Music, заказ песен, воспроизведение из общей очереди, воспроизведение плейлистов, кастомные музыкальные диски и воспроизведение музыки по URL из музыкальных блоков.

Сервер обрабатывает команды, логику очереди, поисковые запросы, синхронизацию, случайную генерацию дисков в луте и управление музыкальными блоками. Клиент отвечает за фактическую загрузку аудио, воспроизведение и отрисовку обложек на музыкальных блоках. Это двусторонний мод, а не чисто серверный аудиомод.

▶YouTube · плеер загрузится по нажатию

Возможности

• Поиск песен, исполнителей, плейлистов и пользователей
• Просмотр топовых песен исполнителя, деталей плейлиста и плейлистов пользователя
• Единая пагинация и кликабельная навигация для всех основных страниц списков
• Кликабельные действия для заказа, записи, просмотра деталей и скачивания
• Общие заказы песен, воспроизведение из очереди, автопереход и голосование за пропуск
• Дедупликация повторных заказов и поддержка перемещения трека из очереди в следующий
• Серверная предзагрузка очереди для уменьшения задержки между треками
• Запись песен на ванильные музыкальные диски и воспроизведение музыки по URL из музыкальных блоков
• /music random каждый раз генерирует 10 случайных популярных песен
• Любые контейнеры с лутом могут выдавать случайные популярные музыкальные диски в зависимости от настроек админа

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

• Сервер обрабатывает выполнение команд, поисковые запросы, очередь воспроизведения, генерацию дисков в луте и синхронизацию музыкальных блоков
• Клиент отвечает за фактическое воспроизведение аудио и отрисовку обложек на музыкальных блоках
• Если мод установлен только на сервере, команды и логика очереди работают, но клиенты не слышат музыку
• Игрокам, которые хотят слышать музыку, нужно установить мод на клиент

Рекомендуемая настройка:

1. Установите Minecraft Music Player на сервер
2. Установите Minecraft Music Player на клиенты, которые должны слышать музыку
3. Убедитесь, что сервер или клиенты имеют доступ к рабочему эндпоинту музыкального API

Требования

• Minecraft 1.21.11
• Fabric Loader 0.18.4 или новее
• Fabric API 0.141.3+1.21.11 или совместимая версия
• Java 21
• Доступный музыкальный API-сервис, связанный с NetEase, по умолчанию https://mycelis.dpdns.org/

Установка

Сервер

Поместите jar мода и Fabric API в папку mods сервера.

Клиент

Поместите jar мода и Fabric API в папку mods клиента.

Адрес API по умолчанию

Конфигурация по умолчанию использует:

https://mycelis.dpdns.org/

Админы могут переопределить его командой и позже восстановить значение по умолчанию.

Музыкальные диски

Процесс записи

1. Держите любой ванильный музыкальный диск в основной руке
2. Выполните /music burn song <song_id>
3. Или нажмите [Burn] на поддерживаемых страницах списков
4. Получите кастомный музыкальный диск с метаданными трека и URL

Метаданные диска

Записанный диск хранит:

• ID песни
• название песни
• имя исполнителя
• ID исполнителя
• URL обложки
• длительность
• доступные URL источников

Воспроизведение через музыкальный блок

• Вставка записанного диска в музыкальный блок автоматически запускает музыку по сохранённому URL
• Воспроизведение пространственное — звук идёт от музыкального блока, а не как глобальный фоновый трек
• На четырёх сторонах музыкального блока отображается вращающийся эффект обложки в стиле диска
• Воспроизведение останавливается, когда диск извлекают или заменяют, музыкальный блок ломают, чанк выгружается или игрок выходит за пределы слышимости
• Ожидающие диски-заглушки нельзя вставить в музыкальные блоки — при использовании на них ничего не произойдёт

Точки входа для записи

Когда игрок держит записываемый диск в основной руке, действие [Burn] автоматически показывается в этих разделах:

• /music now
• /music queue
• /music random
• /music search song ...
• /music view playlist ...
• /music view artist ...
• /music view author ...

Случайная популярная музыка

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

/music random

Поведение:

• Каждый раз генерирует 10 случайных популярных песен
• Источник — популярные плейлисты, выбранные из категорий популярных плейлистов
• Каждое обновление выдаёт другой список

• Каждая запись поддерживает:

  • запрос песни
  • запись на диск
  • просмотр информации об исполнителе
  • открытие прямой ссылки на скачивание

Случайные музыкальные диски в контейнерах с лутом

Мод может добавлять случайные диски с популярной музыкой во все контейнеры, привязанные к таблицам лута, при первом открытии.

Поведение:

• Работает как с блочными контейнерами, так и с контейнерами сущностей, привязанными к таблицам лута
• Для каждого контейнера решение принимается только один раз
• При первом открытии сначала вставляется временный диск-заглушка «генерация», а настоящий диск определяется асинхронно в фоне
• Если игрок заберёт диск-заглушку раньше, он всё равно определится позже — в инвентаре игрока или в текущем открытом контейнере
• Исходный тип ванильного предмета-диска сохраняется после определения, поэтому цвет и внешний вид не меняются
• Сгенерированные диски берутся из случайных популярных песен, выбранных из популярных плейлистов
• Администраторы могут настроить, включена ли эта функция, шанс генерации и сколько дисков может сгенерироваться на контейнер

Команды игрока

Команды администратора

Конфигурация

Путь к файлу конфигурации:

config/minecraft-music-player.json

Пример конфига по умолчанию:

{
  "neteaseBaseUrl": "https://mycelis.dpdns.org/",
  "proxy": "",
  "useSystemProxy": true,
  "preferIpv4": true,
  "allowCustomServer": true,
  "allowSongRequest": true,
  "allowPlaylistRequest": true,
  "autoAdvance": true,
  "announceQueueChanges": true,
  "showLoadingHints": true,
  "connectTimeoutSeconds": 10,
  "readTimeoutSeconds": 20,
  "searchLimit": 8,
  "maxQueueSize": 40,
  "playlistQueueLimit": 20,
  "queueCacheSize": 3,
  "enableLootMusicDiscs": true,
  "lootMusicDiscChance": 0.3,
  "lootMusicDiscCount": 1,
  "voteSkipPercent": 0.6
}

中文

Minecraft Music Player — это музыкальный мод для Fabric для Minecraft 1.21.11, предоставляющий общую очередь воспроизведения, поиск, заказ песен и синхронизацию воспроизведения на основе NetEase Cloud Music.

Сервер отвечает за команды, очередь, поиск, синхронизацию и управление конфигурацией; клиент отвечает за фактическую загрузку и воспроизведение аудио. Поэтому это мод с совместной работой обеих сторон, а не чисто серверный аудиомод.

Обзор возможностей

• Поиск песен, исполнителей, плейлистов и пользователей
• Просмотр популярных песен исполнителя, деталей плейлиста и плейлистов пользователя
• Все основные списки поддерживают постраничную навигацию с кликабельными элементами
• Все часто используемые элементы поддерживают клик для просмотра деталей, заказа, записи или скачивания
• Общий заказ песен, очередь ожидания, автопереход к следующей, голосование за пропуск
• Автоматическая дедупликация повторных заказов, песни в очереди можно поднять на следующую позицию
• Серверное предкэширование очереди снижает ожидание при разборе переключения треков
• Запись песен на ванильные пластинки и воспроизведение URL-музыки в проигрывателе
• /music random каждый раз генерирует 10 случайных популярных треков, которые можно сразу заказать и записать
• Любые контейнеры с таблицами добычи могут по конфигу случайно генерировать популярные музыкальные пластинки

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

• После установки мода на сервере он отвечает за обработку команд, поисковые запросы, очередь воспроизведения, случайные пластинки в сундуках с добычей и синхронизацию проигрывателя
• После установки мода на клиенте он отвечает за фактическое воспроизведение аудио и отрисовку обложки проигрывателя
• Если мод установлен только на сервере, команды и логика очереди работают, но клиент не слышит звук
• Игроки, которые хотят слушать музыку, должны установить клиентский мод

Рекомендуемый способ развёртывания:

1. Установите Minecraft Music Player на сервер
2. Установите Minecraft Music Player также на все клиенты, которым нужно слушать музыку
3. Сеть сервера или клиента должна иметь доступ к рабочему музыкальному API

Требования к зависимостям

• Minecraft 1.21.11
• Fabric Loader 0.18.4 или выше
• Fabric API 0.141.3+1.21.11 или совместимая версия
• Java 21
• Доступный API-сервис, связанный с NetEase Cloud Music, адрес по умолчанию — https://mycelis.dpdns.org/

Установка

Сервер

Поместите основной файл мода и Fabric API в директорию mods сервера.

客户端

将模组主文件和 Fabric API 放入客户端的 mods 目录。

默认 API 地址

默认配置使用：

https://mycelis.dpdns.org/

管理员可以通过命令修改地址，也可以恢复到默认值。

音乐唱片

刻录流程

1. 主手持有任意原版唱片
2. 使用 /music burn song <歌曲ID>
3. 或在支持的列表页面中点击 [刻录]
4. 获得带有歌曲 URL 和元数据的自定义音乐唱片

唱片保存的数据

• 歌曲 ID
• 歌曲名
• 作者名
• 作者 ID
• 封面 URL
• 时长
• 可用音源 URL 列表

唱片机播放

• 将刻录后的唱片放入唱片机后自动播放其中的 URL 音乐
• 播放会跟随唱片机位置同步，而不是全局背景音乐
• 四个侧面会渲染旋转中的唱片封面效果
• 唱片被弹出、替换、唱片机被破坏、区块卸载或玩家离开可听范围后会停止播放
• “正在生成”的占位唱片不能放入唱片机，使用时不会有任何反应

支持的刻录入口

当主手持有可刻录唱片时，这些界面会自动出现 [刻录]：

• /music now
• /music queue
• /music random
• /music search song ...
• /music view playlist ...
• /music view artist ...
• /music view author ...

随机热门音乐

使用：

/music random

行为说明：

• 每次生成 10 首随机热门音乐
• 来源是热门歌单分类下的热门歌单，再从歌单中随机抽歌
• 每次生成的列表都不同

• 列表中的每一首歌都支持：

  • 点歌
  • 刻录
  • 查看作者详情
  • 下载当前直链

战利品箱随机音乐唱片

本模组支持在所有带战利品表的容器第一次被打开时，按配置随机注入热门音乐唱片。

行为说明：

• 对所有带 loot table 的方块容器和实体容器生效
• 每个容器只会决策一次，不会重复生成
• 首次打开时会先放入“随机音乐唱片生成中”的占位唱片，后台异步生成真正的音乐唱片
• 如果玩家先把占位唱片拿走，生成完成后会自动在玩家背包或当前打开的容器里替换成真正的音乐唱片
• 生成完成后会保留原始唱片底盘类型，不会改变颜色和外观
• 生成的唱片内容来自热门歌单中的随机热门歌曲
• 可由管理员配置是否启用、生成概率和每个容器的数量

玩家命令

管理员命令

配置文件

配置文件路径：

config/minecraft-music-player.json

默认配置示例：

{
  "neteaseBaseUrl": "https://mycelis.dpdns.org/",
  "proxy": "",
  "useSystemProxy": true,
  "preferIpv4": true,
  "allowCustomServer": true,
  "allowSongRequest": true,
  "allowPlaylistRequest": true,
  "autoAdvance": true,
  "announceQueueChanges": true,
  "showLoadingHints": true,
  "connectTimeoutSeconds": 10,
  "readTimeoutSeconds": 20,
  "searchLimit": 8,
  "maxQueueSize": 40,
  "playlistQueueLimit": 20,
  "queueCacheSize": 3,
  "enableLootMusicDiscs": true,
  "lootMusicDiscChance": 0.3,
  "lootMusicDiscCount": 1,
  "voteSkipPercent": 0.6
}