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

1. Place - ImageCanvas fetches your image from the provided URL 2. Place - The image is resized to fit your specified grid dimensions 3. Place - Each pixel is mapped to Minecraft's map color palette 4. Place - Custom map renderers display your image in-game 5. Place - Put maps in item frames manually or use auto-placement

---

Configuration

```yaml

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

- Java 21 or compatible fork - Java 21 or higher

---

Tips & Tricks

- Large Displays: Plan your grid size based on your image's aspect ratio. A 16:9 image works great as 4x2 or 8x4. - Large Displays: For auto-placement, place empty item frames in a grid pattern before placing the map. - Large Displays: 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!