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

1. Download - ImageCanvas fetches your image from the provided URL
2. Process - The image is resized to fit your specified grid dimensions
3. Convert - Each pixel is mapped to Minecraft's map color palette
4. Render - Custom map renderers display your image in-game
5. 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!