What ImageFrame Minecraft Plugin works with.
| Platform | Java Edition |
|---|---|
| Loaders | Folia, Paper, Purpur, Spigot |
| Minecraft versions | 1.16.5, 1.18.2, 1.19.4, 1.20.6, 1.21.11, 26.1.2, 26.2 |
ImageFrame is a Minecraft server plugin that loads images, including animated GIFs, onto maps and item frames without needing a resource pack or client mod. It runs on Paper, Spigot, Purpur, and Folia from 1.16 through the current 26.2 build. Images render at Minecraft's native map resolution by default, which loses detail at a distance; players who install the official companion ImageFrame Client see the same maps in HD and full color instead.
Installing the ImageFrame plugin on Paper and Spigot
ImageFrame has no required dependencies, so installation is a plain plugin drop. See our guide to installing plugins on a Minecraft server for the general Paper and Spigot setup steps.
- 1.Download the ImageFrame jar from Modrinth, SpigotMC, or Hangar.
- 2.Put the jar in the server's plugins folder.
- 3.Start or restart the server.
- 4.Edit config.yml if the defaults for storage, image limits, or invisible frames need changing.
- 5.Restart again after any config change.
Creating image maps with plugin commands
Every image map starts with /imageframe create, pointed at an image URL, with a chosen width and height in map units. Players can put the result straight onto selected item frames, get it as a single combined item that auto-places across a wall, or overlay it onto a vanilla map they are already holding.
- /imageframe create <name> <url> <width> <height> - create a new image map
- /imageframe create <name> <url> <width> <height> combined - create it as one combined item for easy placement
- /imageframe overlay <name> <url> - add an image overlay on a vanilla map
- /imageframe refresh <name> - reload a map from its source URL, useful for information boards
- /imageframe marker add <image_name> <marker_name> <direction> <marker_type> - place a map marker with an optional caption
- /imageframe list - list a player's own created image maps
Permissions and Bukkit permission plugins
ImageFrame ships its own permission nodes, such as imageframe.create and imageframe.overlay, most defaulting to op while imageframe.info and imageframe.list default to true for every player. Because these are standard Bukkit permissions, a server can manage who gets access through LuckPerms or any other Bukkit-compatible permissions plugin, without ImageFrame needing to know which one is installed.
Supported Minecraft versions and multi-server setup
The 2026.1.4 build, published June 29, 2026, supports Paper, Spigot, Purpur, and Folia together up to Minecraft 26.2, with earlier releases reaching back to 1.16. For networks running several servers, switching ImageFrame's storage to MySQL keeps the same image maps in sync everywhere without installing the plugin on a BungeeCord or Velocity proxy.
ImageFrame plugin tutorial by ServerMiner
Questions about ImageFrame Minecraft Plugin.
5 questions
How do I install the ImageFrame plugin?
Drop the ImageFrame jar into your server's plugins folder and restart. It needs no other plugins to run. Edit config.yml afterward if you want to change storage type, per-player image limits, or invisible item frame behavior, then restart again for those changes to apply.
Does ImageFrame work on Folia?
Yes. The same build that supports Paper, Spigot, and Purpur also lists Folia as a supported server platform, up through Minecraft 26.2 as of the 2026.1.4 release published June 29, 2026.
Does ImageFrame need a permissions plugin?
No. Every command node ships as a standard Bukkit permission defaulting to op or true, so vanilla permissions work out of the box. Server owners who want finer control can manage the same nodes through LuckPerms or any other Bukkit-compatible permissions manager.
What is ImageFrame Client, and is it the same plugin?
No. ImageFrame Client is a separate, official companion mod from the same creator, LOOHP, that players install to see HD, full-color images instead of Minecraft's native map resolution. ImageFrame itself needs no client-side mod to display images.
Can ImageFrame share maps across multiple servers?
Yes, with MySQL storage enabled instead of the default flat-file storage. That lets the same image maps stay in sync across every server in a network without installing ImageFrame on a BungeeCord or Velocity proxy.
