# ImageCanvas<\/p>\n
**Transform any image into stunning Minecraft map art with a single command!**<\/p>\n
ImageCanvas is a powerful Paper plugin that lets you display images from URLs directly onto Minecraft maps. Create breathtaking galleries, pixel art displays, or custom decorations using multi-map grids up to 15×15 in size.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Easy Image Import
\nSimply paste an image URL and ImageCanvas handles the rest. The plugin downloads, processes, and converts your image to Minecraft’s map color palette automatically.<\/p>\n
### Multi-Map Grids
\nCreate massive displays spanning multiple maps! Support for grids up to **15×15 maps** (that’s 1920×1920 pixels of display space). Perfect for large artwork, server logos, or detailed builds.<\/p>\n
### Auto-Placement
\nNo more tedious manual map placement! With the `-auto` flag, simply place one map on an item frame and watch as ImageCanvas automatically fills all surrounding frames with the correct tiles. Works in any direction – horizontal, vertical, or even on floors and ceilings.<\/p>\n
### HD Quality Mode
\nEnable `-HD` mode for superior image quality using **Floyd-Steinberg dithering**. This advanced algorithm produces smoother gradients and more accurate colors compared to standard conversion.<\/p>\n
### Web Upload Support
\nPlaying on a shared host like Minefort or Aternos? No problem! Use `\/imagemap upload` to get a secure link to our web uploader. Upload images directly from your browser without needing server file access.<\/p>\n
### Persistent Storage
\nAll your image maps are saved and persist through server restarts. Maps automatically restore their images when the server comes back online.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | ### Examples<\/p>\n “` —<\/p>\n ## How It Works<\/p>\n 1. **Download** – ImageCanvas fetches your image from the provided URL —<\/p>\n ## Configuration<\/p>\n “`yaml # Download timeout (seconds) # Maximum file size (MB) # Restrict to specific image hosts # Built-in web server (for self-hosted servers) —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## Requirements<\/p>\n – **Paper 1.21.11** or compatible fork —<\/p>\n ## Tips & Tricks<\/p>\n – **Optimal Sizing**: Plan your grid size based on your image’s aspect ratio. A 16:9 image works great as 4×2 or 8×4. —<\/p>\n ## Support<\/p>\n Found a bug or have a suggestion? Open an issue on our GitHub repository!<\/p>\n —<\/p>\n **Transform your Minecraft world into an art gallery with ImageCanvas!**<\/p>\n","protected":false},"excerpt":{"rendered":" A server-side plugin for uploading images<\/p>\n","protected":false},"featured_media":83895,"template":"","meta":{"_minecraft_slug":"imagecanvas","_minecraft_project_id":"v0YPSYfQ","_minecraft_author":"BlazeyCrazey","_minecraft_license":"MIT","_minecraft_downloads":419,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"imagecanvas.zip","_minecraft_size_bytes":44028,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T10:55:32.192471Z","_minecraft_date_created":"2026-01-14T22:21:38.362842Z","_minecraft_date_modified":"2026-01-08T02:56:11.322518Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/imagecanvas","_minecraft_icon_attachment_id":83895,"_minecraft_imported_at":"2026-06-04T19:14:54+00:00","_minecraft_import_hash":"155d81a0c818a6660fd7fd6078f8cfe4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,89,126,127,867,91,123,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-83894","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-social","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|
\n| `\/imagemap create
\n| `\/imagemap get
\n| `\/imagemap list` | List all saved image maps |
\n| `\/imagemap delete
\n| `\/imagemap upload` | Get a secure upload link |<\/p>\n
\n\/imagemap create logo https:\/\/example.com\/logo.png 3×3 -auto -HD
\n\/imagemap create banner https:\/\/i.imgur.com\/abc123.png 5×1 -auto
\n\/imagemap get logo
\n“`<\/p>\n
\n2. **Process** – The image is resized to fit your specified grid dimensions
\n3. **Convert** – Each pixel is mapped to Minecraft’s map color palette
\n4. **Render** – Custom map renderers display your image in-game
\n5. **Place** – Put maps in item frames manually or use auto-placement<\/p>\n
\n# Maximum grid dimensions (in maps)
\nmax-width: 15
\nmax-height: 15<\/p>\n
\ndownload-timeout: 30<\/p>\n
\nmax-file-size: 10<\/p>\n
\nallowed-domains: []<\/p>\n
\nweb-server:
\n enabled: false
\n port: 8080
\n“`<\/p>\n
\n|————|————-|———|
\n| `imagecanvas.create` | Create image maps | op |
\n| `imagecanvas.get` | Get saved image maps | op |
\n| `imagecanvas.list` | List image maps | op |
\n| `imagecanvas.delete` | Delete image maps | op |
\n| `imagecanvas.upload` | Use web uploader | op |<\/p>\n
\n– **Java 21** or higher<\/p>\n
\n– **Frame Preparation**: For auto-placement, place empty item frames in a grid pattern before placing the map.
\n– **HD Mode**: Use HD mode for photographs and complex images. Standard mode works fine for logos and pixel art.
\n– **Large Displays**: For very large grids, consider using invisible item frames for a cleaner look.<\/p>\n