Compatibility
Minecraft: Java Edition
26.2
26.1.x
Platforms
Supported environments
Client and server
Links
Tags
Creators
Details
Licensed AGPL-3.0-only
Created 2 months ago
Updated 2 months ago
FFCraft
A powerful Minecraft Java Edition media playback mod that allows you to play any media content in your world, supports custom-shaped screens, and is fully compatible with shaders.
✨ Features
- Full-format media playback — Based on FFmpeg, supports almost all audio and video formats.
- Arbitrary-shaped screens — Build polygonal display areas by placing vertices, supporting up to 64 vertices.
- Perfect shader compatibility — Screens correctly reflect and respond to shader pack lighting effects for natural display.
- Convenient GUI management — Press the
Gkey by default to open the graphical interface for easy creation, configuration, and deletion of players. - Comprehensive command system — Provides a full set of commands for administrator and player interaction.
- High-performance decoding — Ensures smooth playback of high-resolution videos.
🛠 Tech Stack & Dependencies
- Mod Framework: Fabric
- Language: Java
- Media Engine: FFmpeg
- Required Mod: ImGui (must be installed)
📥 Installation
For Regular Players
- Make sure you have installed Fabric Loader and Fabric API.
- Install the required mod ImGui.
- Install the required mod DrawLib
- Go to the Releases page.
- Download the latest build
.jarfile for your game version. - Place it into Minecraft's
modsfolder. - Launch the game.
For Developers
git clone https://github.com/Sashwind888/FFCraft.git
cd FFCraft
./gradlew build
The build output is located in build/libs/.
For Special Instruction Set Users
- After cloning the repository, edit
build.gradle. - Add the FFmpeg dependency that matches your platform architecture.
- Run:
./gradlew jar
🚀 Quick Start
- After entering the game, press the G key to open the FFCraft management GUI.
- In the GUI, click "Create Player", then click "Create Screen".
- Right-click to place the screen's vertices (up to 64), left-click to cancel the last vertex, and click the starting point to complete the polygon creation.
- Assign a name to the player and choose its public/private status.
- In the player interface, load a media file or enter a stream URL to start playback.
📋 Command System
| Command | Permission | Description |
|---|---|---|
/ffcraft create <name> [public|private] |
Admin | Create a player |
/ffcraft list |
Everyone | List all players |
/ffcraft info <uuid> |
Everyone | View player details |
/ffcraft rename <uuid> <newName> |
Edit | Rename a player |
/ffcraft delete <uuid> |
Admin | Delete a player |
/ffcraft setpublic <uuid> <true|false> |
Admin | Set public status |
/ffcraft reload |
Admin | Resync all clients |
- Permission nodes:
ffcraft.admin,ffcraft.edit, etc. (configured according to your server's permission plugin). - All
uuidparameters refer to the unique identifier of the player.
🤝 Contributing
Issues and Pull Requests are welcome to help improve FFCraft!
📄 License
This project is licensed under the AGPLv3 license. You are free to use, modify, and distribute it, but modified versions must also be open-sourced under the same license. For details, see the LICENSE file.
Hope this project helps you, meow~ --sashwind Plugin version: Modrinth
