Media HUD

Полное описание

Media HUD добавляет локальный медиаплеер прямо в HUD Minecraft.

Он создан для игроков, которые хотят слушать музыку, смотреть видео и использовать визуализаторы внутри Minecraft, не переключаясь постоянно через alt-tab. Вы можете просканировать локальную папку с медиа, загружать файлы напрямую, перетаскивать плеер в любое место экрана, переключаться между полной и компактной раскладками и выбирать один из нескольких визуальных режимов — от обычного воспроизведения видео до мозаичного рендеринга в стиле Minecraft.

Этот мод работает только на стороне клиента и только с локальными файлами. Он не требует установки на сервер, не использует стриминговые сервисы и не зависит от онлайн-воспроизведения.

Возможности

• Мод Fabric только для клиента
• Воспроизведение только локальных файлов
• Перетаскиваемый HUD с сохранением позиции
• Полная и компактная раскладки HUD
• Раскрывающаяся панель библиотеки для папок и файлов
• Прокручиваемая панель библиотеки со слежением за текущим треком
• Воспроизведение аудио для mp3, wav и ogg
• Воспроизведение видео для mp4
• Полоса прогресса с перемоткой по клику
• Управление воспроизведением, паузой, остановкой, следующим, предыдущим, повтором, случайным порядком и громкостью
• Режимы фильтрации для аудио, видео или обоих
• Сохранение настроек масштаба и прозрачности HUD
• Встроенные цветовые темы HUD
• Пользовательские цвета темы HUD с вводом hex-кода
• Обычный режим видео с учётом пропорций
• Режим визуализатора-волны
• Режим визуализатора-танца
• Режим плотной мозаики видео
• Режим мозаики из предметов, построенный вокруг визуала иконок предметов Minecraft
• Псевдонимы команд /media и /m

Поддерживаемые форматы

• Аудио: mp3, wav, ogg
• Видео: mp4

Рекомендуемый формат видео для наиболее плавной работы:

• Видео H.264
• Аудио AAC
• Контейнер .mp4

Поддерживаемые версии Minecraft

На данный момент Media HUD имеет рабочие сборки для:

• 1.20.5
• 1.20.6
• 1.21
• 1.21.1
• 1.21.2
• 1.21.3
• 1.21.4
• 1.21.5
• 1.21.6
• 1.21.7
• 1.21.8
• 1.21.9
• 1.21.10
• 1.21.11

Руководство по версиям Fabric API

Используйте jar-файл Media HUD, собранный для вашей точной версии Minecraft, и сопоставьте его с версией Fabric API из списка ниже:

• Minecraft 1.20.5 -> Fabric API 0.97.8+1.20.5
• Minecraft 1.20.6 -> Fabric API 0.100.8+1.20.6
• Minecraft 1.21 -> Fabric API 0.102.0+1.21
• Minecraft 1.21.1 -> Fabric API 0.116.9+1.21.1
• Minecraft 1.21.2 -> Fabric API 0.106.1+1.21.2
• Minecraft 1.21.3 -> Fabric API 0.114.1+1.21.3
• Minecraft 1.21.4 -> Fabric API 0.119.4+1.21.4
• Minecraft 1.21.5 -> Fabric API 0.128.2+1.21.5
• Minecraft 1.21.6 -> Fabric API 0.128.2+1.21.6
• Minecraft 1.21.7 -> Fabric API 0.129.0+1.21.7
• Minecraft 1.21.8 -> Fabric API 0.136.1+1.21.8
• Minecraft 1.21.9 -> Fabric API 0.134.1+1.21.9
• Minecraft 1.21.10 -> Fabric API 0.138.4+1.21.10
• Minecraft 1.21.11 -> Fabric API 0.141.3+1.21.11

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

• Fabric Loader 0.18.4 или новее
• Java 21

Установка

1. Установи Minecraft Java Edition одной из поддерживаемых версий, указанных выше
2. Установи Fabric Loader 0.18.4 или новее
3. Установи подходящую версию Fabric API для своей версии Minecraft
4. Используй Java 21
5. Положи jar-файл mediahud нужной версии в папку mods
6. Запусти игру и используй /m ui, чтобы открыть оверлей взаимодействия

Media HUD работает только на стороне клиента. Устанавливать его на сервер для мультиплеера не нужно.

Этот публичный билд собран для Windows x86_64. Для этого файла релиза не требуется дополнительно скачивать FFmpeg или JavaCV. Этот пакет релиза включает материалы с уведомлениями третьих сторон для встроенных компонентов среды выполнения.

Руководство по командам

Можно использовать как /m, так и /media. Это одинаковые алиасы.

Основные команды HUD

• /m show Показывает HUD.

• /m hide Скрывает HUD.

• /m toggle Включает или выключает HUD.

• /m ui Открывает оверлей взаимодействия для перетаскивания.

• /m pos reset Сбрасывает позицию HUD обратно к стандартному расположению.

Команды воспроизведения

• /m play Запускает воспроизведение выбранного медиа.

• /m pause Ставит воспроизведение на паузу.

• /m stop Останавливает воспроизведение.

• /m next Выбирает следующий трек или видео.

• /m prev Выбирает предыдущий трек или видео.

• `/m seek Перематывает на определённое время в секундах. Пример: /m seek 90`

• /m volume <0-200> Устанавливает громкость от 0 до 200. Пример: /m volume 75

Команды библиотеки и файлов

• `/m folder Задаёт корневую папку медиа и сканирует её. Пример: /m folder C:\Users\Name\Music`

• /m refresh Повторно сканирует текущую папку медиа.

• `/m load Загружает конкретный локальный файл напрямую. Пример: /m load C:\Users\Name\Videos\clip.mp4`

• `/m probe ` Проверяет локальный файл через медиа-бэкенд. Полезно, когда нужно проверить, правильно ли определяется файл.

Команды параметров воспроизведения

• /m loop Включает или выключает повтор.

• /m loop on Включает повтор.

• /m loop off Выключает повтор.

• /m shuffle Включает или выключает перемешивание.

• /m shuffle on Включает перемешивание.

• /m shuffle off Выключает перемешивание.

• /m shuffle toggle Явно переключает перемешивание.

Команды фильтров

• /m filter audio Показывает в библиотеке только аудиофайлы.

• /m filter video Показывает в библиотеке только видеофайлы.

• /m filter both Показывает и аудио, и видео.

Команды режимов отображения

• /m mode normal Стандартный режим предпросмотра видео.

• /m mode waveform Режим визуализации звуковой волны.

• /m mode dance Режим танцевальной визуализации.

• /m mode mosaic Режим плотной мозаики из видео.

• /m mode itemmosaic Режим мозаики из предметов на основе видео.

Команды разрешения

• /m wave resolution <3-8> Задаёт разрешение звуковой волны.

• /m video resolution <64-2048> Задаёт разрешение предпросмотра видео в пикселях.

• /m mosaic resolution <4-160> Задаёт разрешение плотной мозаики.

• /m itemmosaic resolution <4-160> Задаёт разрешение мозаики из предметов.

Более высокие значения могут выглядеть лучше, но и нагружать производительность сильнее.

Команды компоновки HUD

• /m hud mode full Использует полную компоновку HUD.

• /m hud mode compact Использует компактную компоновку HUD.

• /m hud scale <50-200> Задаёт масштаб HUD в процентах. Пример: /m hud scale 125

• /m hud transparency <0-80> Задаёт прозрачность HUD в процентах. Пример: /m hud transparency 25

Команды встроенных тем

Можно использовать как /m theme ..., так и /m hud theme ....

• /m theme Показывает текущую тему HUD.

• /m theme classic Использует тему Classic.

• /m theme midnightpurple Использует тему Midnight Purple.

• /m theme bluemoon Использует тему Blue Moon.

• /m theme hacker Использует тему Hacker.

• /m theme sunset Использует тему Sunset.

• /m theme obsidian Использует тему Obsidian.

• /m theme rosegold Использует тему Rose Gold.

• /m theme frost Использует тему Frost.

• /m theme custom Переключает обратно на сохранённые цвета вашей кастомной темы.

Команды цветов кастомной темы

Hex-цвета можно вводить без #. Примеры:

• FFAABB

• /m theme color Показывает текущие цвета вашей кастомной темы.

• `/m theme color gradientprimary ` Задаёт первый цвет градиента.

• `/m theme color gradientsecondary ` Задаёт второй цвет градиента.

• `/m theme color main ` Задаёт основной акцентный цвет.

• `/m theme color border ` Задаёт цвет рамки.

• `/m theme color button ` Задаёт цвет кнопки.

• `/m theme color text ` Задаёт цвет текста.

Примечания:

• Установка кастомного цвета автоматически переключает HUD на кастомную тему.
• Работают и gradientprimary, и gradient_primary.
• Работают и gradientsecondary, и gradient_secondary.

Зачем это нужно

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

Примечания и ограничения

• Только локальные файлы. Никакого YouTube, стриминговых ссылок и онлайн-источников медиа.
• Этот релиз рассчитан на локальное воспроизведение внутри игрового HUD, а не на полноценный десктопный медиаплеер.
• Высокие разрешения видео, мозаики и мозаики из предметов всё ещё могут нагружать систему в зависимости от клипа.
• Используйте jar, собранный под вашу точную версию Minecraft.
• Лучший результат дают чистые локальные файлы и отдельная папка для медиа.
• В этот пакет входит runtime FFmpeg для Windows x86_64. Сборки для Linux и macOS в этот файл не включены.

Лицензия и сторонние компоненты

• Исходный код Media HUD лицензирован под MIT.
• В этот релиз входят сторонние runtime-компоненты, включая JavaCV, JavaCPP и runtime FFmpeg для Windows x86_64 через ByteDeco.
• Уведомления о сторонних компонентах и ссылки на исходники/соответствие требованиям включены в THIRD_PARTY_NOTICES.md.
• Runtime FFmpeg в этом релизе взят из стандартных артефактов пресета ByteDeco, а не из отдельных артефактов -gpl.

• Публичный текст уведомления для страницы проекта:

  • Это программное обеспечение использует библиотеки проекта FFmpeg под лицензией LGPL.
  • Страница юридической информации/соответствия FFmpeg: https://ffmpeg.org/legal.html
  • Соответствующий исходный код FFmpeg 7.1.1: https://ffmpeg.org/releases/ffmpeg-7.1.1.tar.xz
  • Исходники/скрипты сборки пресета ByteDeco: https://github.com/bytedeco/javacpp-presets/tree/1.5.12/ffmpeg