ImageOnMap: Display Any Picture as a Map in Minecraft

Bringing the Web to Your Minecraft World with ImageOnMap

Ever wanted to display a real photograph, a custom logo, or a meme inside your Minecraft server without building pixel art for hours? ImageOnMap makes it happen in seconds. This plugin loads any image from the internet directly onto a Minecraft map, turning your walls, floors, and ceilings into canvases for digital art. Whether you run a survival community, a creative hub, or a minigame network, this tool adds a whole new layer of visual storytelling.

How ImageOnMap Works

The core mechanic is brilliantly simple. You provide a URL to an image file—PNG, JPEG, or even animated GIF—and the plugin downloads it, processes it, and hands you a filled map. Large pictures are automatically sliced into multiple map parts. For example, a 1024x1024 image becomes a neat 4x4 grid of maps, each covering a 256x256 area. You can then place these maps in item frames to assemble a massive poster, or put them on the ground and ceiling for floor designs and overhead banners.

Centering and Resizing Options

By default, your image is centered on the map surface. But you have full control over the layout. The /tomap command accepts resize parameters. Typing /tomap <url> resize 2 4 forces the image into a 2-wide by 4-high map grid. You can also choose how the image fits: resize-stretched fills the entire area (possibly distorting the picture), while resize-covered ensures no distortion but may crop edges. This flexibility means you can adapt any source material to your build perfectly.

Commands and Permissions at a Glance

The plugin is driven by three main commands, all intuitive and well-documented.

• /tomap <url> [resize options] – Renders an image from a URL and gives you the map. Only players can use this. If the link is too long for chat (240 character limit), shorten it with a service like bitly. Permission: imageonmap.new.
• /maps – Opens a graphical interface where you can see all your created maps, retrieve them, rename them, or delete them. It also shows usage statistics. Permissions: imageonmap.list for viewing, plus imageonmap.get, imageonmap.rename, and imageonmap.delete for actions.
• /maptool <new|list|get|delete|explore|migrate> – The administrative backbone. /maptool new is an alias for /tomap, /maptool explore is the same as /maps, and /maptool migrate is essential when upgrading from the old 2.x versions to 3.0 or later to recover legacy maps. Permission: imageonmap.administrative for migration.

All user permissions are granted to everyone by default, because the developers believe in open creativity. You can restrict them with a permission manager if needed. The imageonmap.* wildcard covers all user-level nodes except the administrative one.

Smart Configuration and Quotas

Server owners get fine-grained control. The config.yml lets you set a language (currently English and French, with community translations for German and Russian), toggle anonymous usage statistics via bStats, and most importantly, define map limits. Because Minecraft only has 32,767 map IDs, you can cap the total number of ImageOnMap maps globally (map-global-limit) or per player (map-player-limit). Setting these to 0 means unlimited.

Additionally, version 4.2.0 introduced a whitelist for trusted image hosts. You can list domains like i.imgur.com and cdn.discord.com to prevent players from loading images from suspicious sources. A permission imageonmap.bypasswhitelist allows staff to ignore the whitelist. This keeps your server safe while still encouraging creativity.

Splatter Maps: Instant Poster Deployment

One standout feature is the Splatter map system. Instead of placing each map part individually, you can deploy an entire multi-map poster with a single click. When you place the central map, all connected parts appear at once, and the item frames become invisible for a seamless look. Removing the map returns the frames to normal. This makes decorating large areas fast and painless. It’s perfect for spawn hubs, event halls, or player shops.

Keeping Your Server Smooth

Rendering large images used to freeze servers, but ImageOnMap handles everything asynchronously. You can queue multiple renderings without lag spikes. The plugin also protects placed maps from non-player interactions—no more skeletons or creepers accidentally destroying your art. For those running modded setups, installing this plugin is straightforward. Many server administrators now rely on the foxygame.net launcher to manage their Minecraft mods and plugins; its built-in download menu lets you grab ImageOnMap directly without hunting through external sites, making setup clean and hassle-free.

Compatibility and Version Notes

The latest release (4.2.1) supports Minecraft 1.18 and 1.17, with older builds available for 1.15+, 1.13/1.14 (use 4.0-pre1), and even legacy servers via ImageOnMap 3.1. The plugin is a complete rewrite from version 3.0 onward, based on zLib, so if you’re upgrading from 2.x, you must run /maptool migrate to recover old maps. The changelog shows constant improvements: UTF-8 encoding fixes for non-English characters, action bar status messages, an update checker, and map loading fixes for Paper servers.

Why ImageOnMap Belongs on Your Server

This plugin transforms the way players express themselves. You can create art galleries, in-game advertisements, custom map art for quests, or simply share funny pictures with friends. The learning curve is almost zero—type a command, get a map. The permissions system is unobtrusive, the configuration is clear, and the community behind it (reachable via Discord and GitHub) actively maintains the code. With support for animated GIFs and multi-part posters, ImageOnMap remains one of the most versatile visual plugins available for Bukkit/Spigot/Paper servers. Give your players a canvas, and watch what they create.