ImageFrame lets eligible players turn online images into Minecraft maps and display them across item frames.
Before creating an image
- Use a direct image URL, not a webpage URL.
- Only display content allowed by the server rules.
- Do not use copyrighted, explicit, hateful, deceptive, or personally identifying imagery.
- Use reasonable image dimensions to avoid wasting map space or affecting clients.
Create an image map
/imageframe create <name> <url> <width> <height>width and height are measured in Minecraft maps. For example, 2 1 creates an image two maps wide and one map tall.
To receive the result as a combined item when supported:
/imageframe create <name> <url> <width> <height> combinedPlace an image on frames
- Build an item-frame rectangle matching the image dimensions.
- Run
/imageframe select. - Select the required frame area by following the in-game prompts.
- Create or retrieve the image using the selection option when offered.
The frames must face the same direction and form a valid rectangle.
Manage your images
| Command | Description |
|---|---|
/imageframe list | List your image maps. |
/imageframe get <name> | Receive an existing image map. |
/imageframe get <name> combined | Receive it as a combined item when supported. |
/imageframe refresh [name] [new-url] | Reload an image or change its source. |
/imageframe rename <name> <new-name> | Rename an image map. |
/imageframe clone <name> <new-name> | Clone an existing image map. |
/imageframe delete <name> | Delete an image map you own. |
/imageframe playback <name> pause | Pause or resume an animated image. |
Sharing access
Image owners can grant another player access when enabled:
/imageframe setaccess <name> <player> <permission>Use /imageframe help or command suggestions to see the access values supported by the installed version.
Troubleshooting
The image will not load
Confirm the URL points directly to a supported image and is publicly reachable. Some hosts block server downloads or expire their links.
The frame selection fails
Check that all item frames are loaded, face the same direction, and exactly match the requested width and height.
I cannot create more images
Image count, map size, animated-image support, and URL access can be limited by permissions or rank.