FFmpegLib
Most Minecraft mods are built from blocks, items and mobs. FFmpegLib is something different: a technical library mod that adds no gameplay content at all. Instead, it hands other mod authors a clean, asynchronous bridge to FFmpeg, the industry-standard tool for video and audio processing. If you have ever wondered how a mod could play a cutscene, build an animated menu or pull a soundtrack out of a video file without tanking your frame rate, this is the plumbing that makes it possible.
What FFmpegLib Actually Does
FFmpegLib for Minecraft is aimed squarely at developers, not at players browsing for new content. It exposes a small API that wraps an external FFmpeg process, so every heavy media operation runs outside the game thread. In practice, that means a mod can decode a video, extract audio or grab a thumbnail while you keep playing at full FPS.
The mod is built for NeoForge 1.21.1, and that version target matters: it is the current long-term home for a lot of technical and client-side mods, and library mods like this one tend to follow the loader that their companion projects use.
Automatic FFmpeg Setup
On first launch, FFmpegLib downloads an FFmpeg build and unpacks ffmpeg.exe into config/ffmpeglib/. If the file is already present, nothing is downloaded again. Mod authors can retrieve the path through FFmpegProvider.getExecutable() and check it before doing anything else. The automatic download currently supports Windows x64 only, and the very first launch needs an internet connection.
Fully Asynchronous API
Every method returns a CompletableFuture and executes on a background thread. Frame extraction, audio extraction and thumbnail extraction all follow the same pattern, so mod code stays readable while the game stays smooth. The documentation is blunt about one thing: if you call .join(), do it off the main thread.
Crash Isolation
This is the feature that quietly matters most. Decoding happens in a separate OS process, so a corrupted or broken media file cannot take Minecraft down with it. Only that process fails, and the game carries on. For a mod that loads user-supplied video files, that is a genuine safety net.
Core Features at a Glance
- Frame extraction — turn any video into a numbered PNG sequence at your chosen FPS, ready for custom GUIs, cutscenes or in-game screens.
- Audio extraction — pull the audio track into a folder of your choice. OGG (Vorbis) and MP3 are re-encoded; other formats use a stream copy without re-encoding.
- Thumbnail extraction — grab a single frame from any second of a video and save it as <name>_thumb.png, ideal for menus, galleries and previews.
- Result reuse — existing outputs are detected, so the same file is not processed twice.
If you are setting this up alongside other technical mods, the foxygame.net launcher makes life easier by handling FFmpegLib installation in a single click and keeping it updated as new builds appear. The launcher's add-on catalog also flags version compatibility, so you can see at a glance whether FFmpegLib matches your NeoForge 1.21.1 setup before anything is downloaded.
How to Install FFmpegLib
Installation is straightforward, and there is no in-game configuration screen to worry about:
- Confirm you are running Minecraft 1.21.1 with NeoForge installed.
- Place the FFmpegLib jar in your mods folder, or add it through your launcher's mod browser.
- Launch the game once with an internet connection so FFmpegLib can download and unpack FFmpeg into config/ffmpeglib/.
- Verify that ffmpeg.exe exists in that folder. If it does, you are done.
When you download FFmpegLib, remember that it does nothing visible on its own. It only becomes useful once a mod that depends on it is also installed. If a mod author ships a screen warning that FFmpeg is missing, that is FFmpegLib telling you the executable was not found.
Who Should Use It
FFmpegLib is a companion library, originally built to support the Lost in Fog project, but any mod author is free to use it. The API surface is deliberately small and focused, which makes it easy to learn. Players will rarely notice it directly, yet it is the reason a video-driven mod can exist without stuttering or crashing. If you are building media features into a NeoForge 1.21.1 mod, FFmpegLib is the sensible foundation to start from.