ImageCanvas
A server-side plugin for uploading images
📖About ImageCanvas
ImageCanvas
Transform any image into stunning Minecraft map art with a single command!
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 15x15 in size.
Features
Easy Image Import
Simply paste an image URL and ImageCanvas handles the rest. The plugin downloads, processes, and converts your image to Minecraft's map color palette automatically.
Multi-Map Grids
Create massive displays spanning multiple maps! Support for grids up to 15x15 maps (that's 1920x1920 pixels of display space). Perfect for large artwork, server logos, or detailed builds.
Auto-Placement
No 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.
HD Quality Mode
Enable -HD mode for superior image quality using Floyd-Steinberg dithering. This advanced algorithm produces smoother gradients and more accurate colors compared to standard conversion.
Web Upload Support
Playing 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.
Persistent Storage
All your image maps are saved and persist through server restarts. Maps automatically restore their images when the server comes back online.
Commands
| Command | Description |
|---|---|
/imagemap create <name> <url> <WxH> [-auto] [-HD] |
Create a new image map |
/imagemap get <name> |
Get copies of a saved image map |
/imagemap list |
List all saved image maps |
/imagemap delete <name> |
Delete a saved image map |
/imagemap upload |
Get a secure upload link |
Examples
/imagemap create logo https://example.com/logo.png 3x3 -auto -HD
/imagemap create banner https://i.imgur.com/abc123.png 5x1 -auto
/imagemap get logo
How It Works
- Download - ImageCanvas fetches your image from the provided URL
- Process - The image is resized to fit your specified grid dimensions
- Convert - Each pixel is mapped to Minecraft's map color palette
- Render - Custom map renderers display your image in-game
- Place - Put maps in item frames manually or use auto-placement
Configuration
# Maximum grid dimensions (in maps)
max-width: 15
max-height: 15
# Download timeout (seconds)
download-timeout: 30
# Maximum file size (MB)
max-file-size: 10
# Restrict to specific image hosts
allowed-domains: []
# Built-in web server (for self-hosted servers)
web-server:
enabled: false
port: 8080
Permissions
| Permission | Description | Default |
|---|---|---|
imagecanvas.create |
Create image maps | op |
imagecanvas.get |
Get saved image maps | op |
imagecanvas.list |
List image maps | op |
imagecanvas.delete |
Delete image maps | op |
imagecanvas.upload |
Use web uploader | op |
Requirements
- Paper 1.21.11 or compatible fork
- Java 21 or higher
Tips & Tricks
- Optimal Sizing: Plan your grid size based on your image's aspect ratio. A 16:9 image works great as 4x2 or 8x4.
- Frame Preparation: For auto-placement, place empty item frames in a grid pattern before placing the map.
- HD Mode: Use HD mode for photographs and complex images. Standard mode works fine for logos and pixel art.
- Large Displays: For very large grids, consider using invisible item frames for a cleaner look.
Support
Found a bug or have a suggestion? Open an issue on our GitHub repository!
Transform your Minecraft world into an art gallery with ImageCanvas!