MiraHUD

MiraHUD

Твой экран Minecraft — твои правила. MiraHUD — клиентский мод для Fabric, который выводит изображения, видео и кнопки команд в один клик прямо на твой HUD. Смотри фильм, пока копаешь руду. Закрепи референс в углу экрана. Открывай эндер-сундук, аукцион или магазин без ввода команды. Никакой настройки на сервере не нужно. Просто закинь в папку mods. И всё готово.

Что умеет MiraHUD

Оверлеи изображений и видео

Ты можешь вывести что угодно поверх игрового экрана. Картинку, зацикленное видео, референс-лист, карту. Где угодно и любого размера.

• Накладывай сколько угодно оверлеев. Изображения, видео — любые комбинации. У каждого свои позиция, размер, прозрачность и точка привязки. Никаких жёстких лимитов.
• Поддерживается почти любой формат изображений. PNG, JPG, WEBP, TGA, BMP, GIF. Всякий случайный хлам, скачанный из интернета. Со всем справится.
• Пиксельная точность. Задай точные координаты X и Y, меняй размер свободно, зафиксируй соотношение сторон, чтобы ничего не растягивалось. Прозрачность — от непрозрачного до едва заметного 1%, что отлично подходит для ненавязчивых референс-оверлеев.
• Пять точек привязки. Прикрепляй оверлеи к любому углу или центру. Они остаются на месте при любом разрешении.
• Режим перетаскивания. Если не хочешь возиться с цифрами — просто таскай оверлей, пока не будет выглядеть как надо. Правый клик возвращает его к точке привязки.
• Живой предпросмотр. Любое изменение сразу отображается на экране, ещё до закрытия меню настроек. Не нужно перезаходить, чтобы увидеть результат.

Настоящий видеоплеер внутри Minecraft

Это не какая-то сырая поделка. MiraHUD использует видеоконвейер FFmpeg. Твои видео воспроизводятся со звуковой дорожкой и не рассинхронизируются.

• Проигрывает практически всё. MP4, MKV, WEBM, AVI, MOV, FLV, WMV. Если это видеоформат — скорее всего, заработает.
• Звук, который реально не отстаёт. Звуковая дорожка — главные часы. Видеокадры придерживаются до их меток времени, так что звук и картинка никогда не расходятся. Это покадровая точность, а не «и так сойдёт».
• Полное управление воспроизведением. Продолжить по P. Перемотать на 10 секунд вперёд или назад стрелками. Начать сначала по R. Включить или выключить зацикливание. У видеооверлеев также есть полоса перемотки в стиле VLC в экране настроек: тяни, чтобы перемотать в любой момент, рядом — живой счётчик прошедшего и общего времени.
• Зацикливание без швов. Ни мерцания, ни перезагрузки, ни скачков GPU. Просто чисто начинается заново.
• Громкость для каждого оверлея. У каждого оверлея свой ползунок громкости, и он учитывает общую громкость Minecraft. Можно запустить видео в одном углу и тихое в другом.
• FFmpeg сам о себе позаботится. Если FFmpeg не установлен, MiraHUD тихо скачает сборку в фоне, пока ты продолжаешь играть. Твоя собственная установка FFmpeg (если она вообще есть) никогда не трогается, не перемещается и не изменяется. На Windows, Linux и macOS это полностью автоматически.
• Самовосстанавливающееся воспроизведение. Если видеоконвейер падает или файл не загружается, MiraHUD замечает это, отступает и повторяет попытку сам. Он не просто зависает на кадре и сдаётся.

Виджеты инвентаря в один клик

Если ты устал вводить /ec. Снова и снова, MiraHUD превращает эти команды в кликабельные кнопки на экране инвентаря.

• Шесть встроенных виджетов: Ender Chest, Auction House, Sell, Trash, Shop и Market. Один клик — команда сработала. Готово.
• Автоматическая раскладка. Виджеты аккуратно выстраиваются рядом с инвентарём. Если их много для одного ряда, они автоматически переносятся на второй. Ничего не нужно расставлять вручную.
• Переключение каждого виджета. Не используешь виджет Trash? Выключи его. Нужны все шесть? Включи все. Нажми I, чтобы открыть менеджер виджетов и переключить нужные. У каждого виджета есть подсказка, чтобы ты знал, какую команду он выполняет.
• Весь HUD инвентаря можно отключить. Если хочешь на время чистый ванильный инвентарь — щёлкни главный переключатель в менеджере виджетов. Включи обратно, когда снова понадобятся кнопки. Ты всегда контролируешь, что отображается.
• Поддержка кастомных виджетов. Если ты разработчик, можешь создавать свои виджеты с собственными иконками, текстурами предметов и поведением при клике.

Настройки, которые просто работают

Ничего не спрятано в конфиг-файлах. Всё понятно.

• Всё сохраняется автоматически. Позиции оверлеев, размеры, громкость, какие виджеты включены. Всё записывается в аккуратные JSON-файлы внутри config/mirahud/. Всё возвращается как было при следующем запуске.
• Пресеты оверлеев. Настроил оверлей как нравится? Сохрани его как именованный пресет. Применяй позже одним кликом. Переключайся между сохранёнными пресетами для игр или ситуаций.
• Настоящий выбор файлов. Нажми Browse. Откроется системный диалог выбора файлов. Он работает в фоновом потоке, так что игра не зависает, пока ты ищешь файл.
• Умное разрешение путей. Ввёл путь неправильно? Вставил что-то странное? MiraHUD автоматически ищет по имени файла в папках Videos, Downloads, Desktop и Documents. Исправляет путь за тебя. Удивительно хорошо находит.

Дерево оверлеев

Нажми O, и экран настроек вырастит пиксельное дерево посреди экрана. Дерево — это и есть твой список оверлеев.

• Пень — это кнопка добавления. Нажми на пень у основания ствола, чтобы вырастить новую ветку (оверлей). Когда дерево пустое, он спрашивает, хочешь ли ты изображение или видео; иначе просто выращивает одну ветку.
• Ветки — это оверлеи. Каждый оверлей — ветка на стволе. Включённый оверлей отращивает полную крону листьев; выключенный остаётся голым. Листья видеооверлеев слегка колышутся на ветру, листья изображений остаются неподвижными, так что их можно различить с первого взгляда.
• Кликни по ветке, чтобы отредактировать её. Слева откроются её настройки: путь, позиция, размер, прозрачность, громкость, воспроизведение/зацикливание, полоса перемотки и пресеты. < Back возвращает к дереву, а - Remove отрубает ветку.
• Всё на виду. Оверлей, который ты редактируешь, получает фиолетовое пиксельное сердечко, прикреплённое к стволу. При наведении на ветку она подсвечивается зелёным и показывает полный путь к файлу.

Быстрое управление

Все привязки клавиш можно изменить в стандартном меню «Управление» Minecraft.

Что понадобится

• Minecraft 26.1 – 26.2
• Fabric Loader 0.19.5 или новее
• Fabric API
• Java 25 или новее MiraHUD полностью клиентский. Устанавливается на твою машину. Работает на любом сервере. Ванильном, модифицированном, мини-играх, где угодно. Серверу ничего устанавливать не нужно. На Windows, Linux и macOS MiraHUD проверяет наличие FFmpeg при запуске и, если его нет, автоматически скачивает портативную сборку в фоне, пока ты играешь. Он проверяет загрузку перед использованием, и если бинарники окажутся повреждены, удаляет их и скачивает заново. Твоя собственная установка FFmpeg (если она есть) никогда не затрагивается.

Установка

1. Установи Fabric Loader для Minecraft 26.1 или 26.2. Положи jar-файл Fabric API в папку mods.
2. Положи jar-файл в папку mods.
3. Запусти игру. Нажми O, чтобы открыть дерево оверлеев, затем нажми на пенёк у его основания, чтобы вырастить свой первый оверлей.

Сборка из исходников

./gradlew build

Скомпилированный jar-файл окажется в build/libs/.

Лицензия

MiraHUD распространяется под лицензией MIT.