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, ищите на проверенных площадках модов и в каталогах лаунчеров, а после установки просто играйте: библиотека сделает свою работу тихо и в фоне.