MapImage Plugin

MapImage is a Minecraft plugin that lets server operators turn any online image URL into an in-game map item using the /mapimage command. Maps are persisted and re-rendered after server restarts using a lightweight YAML config, so they require no large image file storage on the server.

---

Features

• Convert any image to a Minecraft map.
• Automatically maps image colors to the closest vanilla map palette.
• Stores URL ↔ map ID pairs in config.yml to persist across restarts.
• Restricts usage to server operators or players with permission.

---

Usage

Command

/mapimage <image-url-or-filename> [size]

• Converts a 64×64 image from the given URL or local file into a map.
• Works for PNG, JPG, GIF, BMP, and WEBP images
• If argument size (HxW) you can get a matrix of maps (2x3 would give you 2 high, 3 wide image, 6 maps) and given in order from top left to bottom right
• Make sure your local images are located in the same folder as config.yml (MapImage/)
• The player receives the filled map in their inventory.

🌐 Make sure the image is accessible from the server (internet access required on every start and restart) and returns a valid image format (e.g., PNG or JPEG).

---

Permissions

| Permission Node | Description | Default |
|-------------------------|--------------------------------------|---------|
| mapimage.use | Allows using /mapimage | OP only |

Notice

While this plugin works fine with small amounts of images, if you have excessive amounts of images it may cause increased server RAM usage. This is planned on being fixed at the moment, but beware that sometimes you may have your server's RAM higher than normal until the patch is released.