Emage 🎨
A highly-optimized image and GIF renderer built for modern Paper servers. By completely bypassing Minecraft's heavy default map API, Emage uses a custom packet pipeline to stream media directly to your players. You get the freedom to decorate your world with smooth animations without compromising server performance.
Requirements
- Java 22
- Paper 1.21 or higher
- PacketEvents (Required dependency)
Installation
- Place the
PacketEvents.jarandEmage-VERSION.jarinto yourplugins/folder. - Start the server.
- Edit
plugins/Emage/config.ymlto adjust various limits or customize messages.
Usage
To display an image, place Item Frames on a wall in a rectangular grid. Look at one of the frames and run the apply command.
Commands
| Command | Description |
|---|---|
/emage apply-grid <columns> <rows> <url> |
Manually specify the grid size to apply the image/GIF. |
/emage apply <url> |
Auto-detects the frame grid and applies the image/GIF. |
/emage remove |
Remove the grid and its files. |
/emage reload |
Reload the configuration. |
Building
mvn clean package
The compiled jar will be output to the target/ directory.
