FFmpegLib — медиабиблиотека для модов Minecraft

FFmpegLib для Minecraft — лёгкая библиотека с асинхронной обработкой видео и звука через FFmpeg. Узнайте, зачем она нужна и как установить.

Скачать ffmpeglib для Minecraft 1.21.1, 1.20.1

Оригинальное название: ffmpeglib

Версии Minecraft: 1.20.1, 1.21.1

Загрузчик: Forge, NeoForge

ФайлВерсияЗагрузчикРазмер
ffmpeglib-0.6.7-forge-1.20.1.jar1.20.1Forge10 КБСкачать
ffmpeglib-0.6.7-neoforge-1.21.1.jar1.21.1NeoForge24 КБСкачать
ffmpeglib-0.6.9-neoforge-1.21.1.jar1.21.1NeoForge27 КБСкачать

FFmpegLib

Если вы автор мода или просто любопытный игрок, который наткнулся на этот мод в списке зависимостей, картина простая: FFmpegLib — техническая библиотека, а не контентное дополнение. Она не добавляет ни блоков, ни предметов, ни мобов. Зато даёт другим модам удобный мост к внешнему FFmpeg, чтобы тяжёлая работа с видео и аудио не тормозила игру. Звучит сухо? На деле за этим стоят катсцены, внутриигровые экраны, превью и звуковые дорожки, которые иначе пришлось бы делать вручную и с риском уронить клиент.

Зачем нужна библиотека обычному игроку

Вы можете скачать FFmpegLib для Minecraft и даже не заметить изменений в геймплее — и это нормально. Библиотека работает в фоне: она открывает другим модам асинхронный API для обработки медиа. Каждый вызов возвращает CompletableFuture и выполняется в отдельном потоке, поэтому FPS не проседает, пока где-то в глубине распаковывается видео на кадры.

Отдельная гордость автора — изоляция сбоев. Декодирование идёт в отдельном процессе операционной системы. Если файл битый или повреждён, падает только этот процесс, а Minecraft продолжает работать. Для модпаков с кучей самодельного контента это спасение.

Что умеет FFmpegLib

Функционал сфокусированный, без лишнего. Вот основные возможности:

  • Автоматическая установка FFmpeg. При первом запуске мод скачивает сборку win64 и распаковывает ffmpeg.exe в папку config/ffmpeglib/. Если файл уже на месте, повторной загрузки не будет.
  • Извлечение кадров. Любое видео превращается в последовательность PNG с выбранным FPS — готовый материал для кастомных GUI, катсцен и экранов.
  • Извлечение аудио. Дорожка вытаскивается в указанную папку: ogg и mp3 перекодируются, остальные форматы копируются потоком без потерь.
  • Превью. Один кадр с любой секунды видео сохраняется как <name>_thumb.png — удобно для меню и галерей.

Повторная обработка не выполняется: если результат уже лежит в папке, мод его переиспользует. Мелочь, но на больших файлах экономит кучу времени.

Совместимость и загрузчик

Сейчас FFmpegLib для Minecraft собран под NeoForge 1.21.1. Это узкая, но актуальная ниша: моды на NeoForge для свежих версий активно развиваются, а готовых медиарешений мало. Автор честно предупреждает, что автоматическая загрузка FFmpeg поддерживает только Windows x64, и для первого запуска нужен интернет. Учитывайте это, если играете на Linux или macOS.

Тем, кто собирает сборку через лаунчер foxygame.net, повезло с каталогом дополнений: FFmpegLib находится поиском по названию, ставится в пару кликов и подтягивается вместе с остальными модами без ручной возни с папками.

Как установить FFmpegLib

Установка не отличается от типового мода для NeoForge. Порядок такой:

  • Убедитесь, что у вас установлен NeoForge 1.21.1 и запускался хотя бы раз.
  • Поместите jar-файл библиотеки в папку mods.
  • Запустите игру и дайте моду скачать FFmpeg при первом старте.
  • Проверьте, что в config/ffmpeglib/ появился ffmpeg.exe.

Если файл не скачался, проверьте соединение и права на запись в папку конфигурации. Иногда помогает просто перезапустить клиент.

Для разработчиков: API в двух словах

Мод-авторам библиотека даёт несколько статических методов. Путь к исполняемому файлу берётся через FFmpegProvider.getExecutable(), а каталог — через getDirectory(). Дальше доступны extractFrames с параметром FPS, extractAudioCustom с форматом и extractThumbnail с указанием секунды. Все методы возвращают CompletableFuture, так что вызывать .join() стоит только вне главного потока.

Автор не скрывает: он не профессиональный программист, и библиотека выросла как спутник мода Lost in Fog. Но именно поэтому код компактный и понятный — его легко читать и подключать в собственные проекты.

Итог

FFmpegLib — это не украшение сборки, а фундамент. Игроку она даёт стабильность и работающие медиа-фичи в модах, разработчику — готовый асинхронный инструмент без велосипедов. Если вы ищете, где скачать FFmpegLib, ищите на проверенных площадках модов и в каталогах лаунчеров, а после установки просто играйте: библиотека сделает свою работу тихо и в фоне.