ImgMap: Render any image on an in-game map!

By Evangon, Maximdv, and JohnnyBlu

Originally coming from a picture of a troll face by md_5, this plugin allows a user with a map in hand (obviously with the proper permissions) to essentially put an image onto the map. The image could be anything: Instructions, rules, messages, warnings, a very nice picture of a cat, whatever you want! All images are resized to the proper dimension of 128x128. The image is then sent over to a rendering process (Devs: Check the source on how it's done if you want), which then the map renders the image for that map. Anyone with a map with the same ID (Typically, it says when you hover over it, e.g "Map #0") to see the same image too! The only downside to all of this is that due to the nature of Minecraft maps, they do not support full color. This is due to a limitation on the clients themselves.


Just drop it into the /plugins/ folder! No special configuration needed!

How to use

  1. Give yourself a map with a specific ID. This ID can be anything, but remember, once you draw an image on it, it will pertain only to that specific ID!
  2. Get the URL of the desired image! This is where some people mess up. In order for the plugin to successfully render it, it has to be a direct link to the image. Simply right click on the image and hit "Copy Image Location".
  3. Hold the map with the super specific ID and type in "/drawimage" and paste it! For most users, to paste, you do "CTRL+V".
  4. Wait a bit; rendering can take a bit. You'll notice several segments appear on the map; this it indicating that it's loading. If nothing happens, you're either met with a message that says something along the lines of "Server Internal Error" or you're staring a blank map. If you get kicked with the message with "Server Internal Error", simply type, in console, "fixmap <your super specific id>". This basically fixes the map with the old over world rendering. Try again; if it doesn't work, report it in the comments! However, if you are getting nothing, be sure the image is accessible directly from your browser (clear your cache before you do so!) Sometimes, what happens is that the owner of the website has set privileges denying anyone from accessing the image directly. A bit bothersome, but you can probably save the image and upload it somewhere else. However, when doing so, please follow the copyright usage on said images!
  5. Viola! Your map now has that pretty picture of a kitty or something!


  • /drawimage <image url> Draws the specified image to the map you're holding. If you want to "save" the picture to the map, you add "-s" to the end of the command. The reason why "save" is written in quotations is because it doesn't actually save the map's picture; it simply saves the URL and it's corresponding ID to a flatfile and is loaded on start up.
  • /drawanimatedimage <gif url> Experimental. Attempts to draw an animated gif image. A little buggy here and there, but it works for the most part! Please be warned that this takes up a lot of bandwith (You're sending anywhere between 0 to 16kilobytes nearly every second!) and that it also is resource intensive!
  • /clearmap With a map in hand, this command wipes the image off of it and puts the old Minecraft map rendering back.
  • /fixmap <id> A debug command, Caused an issue with a map that psudo-bans them? No worries! Simply get the ID of the problematic map, and type this command in, replacing <id> with the map's id. It's like /clearmap, only this time, you can target maps!
  • /getmap <id> More of a debug command, but can be helpful for some, it allows you to get a map by almost any ID. The reason why this is "almost" is because if you try to get a map that is above the number that exists, it merely just goes over and gets the next ID, rather than the one you want. This is something that's within Minecraft that I cannot fix.


  • imgmap.*: Grants almost all rights to ImgMap. This does not include debug commands.
  • imgmap.debug: Grants debugging rights to ImgMap. Does not include drawing or restoring capabilities.
  • imgmap.drawimage: Allows you to draw an image to a map.
  • imgmap.drawanimatedimage: Allows you to draw an animated image to a map.
  • imgmap.clearmap: Allows you to clear a map and restores the overworld rendering.
  • imgmap.debug.fixmap: Debug command. Allows you to remove all renderers on a given map ID.
  • imgmap.debug.getmap: Debug command. Allows you to get a map by any ID.

Source for Developers/Contributors

Found a bug that you want to squash yourself? Go ahead and fork me! (Please don't actually stab me with a fork!)


Google Logo Cornell Box

Upcoming Feature

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Evangon Evangon Feb 09, 2014 at 01:39 UTC - 0 likes

    Sorry for the wait! Uploaded v1.4.1a; just awaiting approval. Also, I pushed the source to GitHub, so be sure to check it out!

    Life is a turn-based game. Screw up a turn, you screw your life up. However, I have all the time to decide what to do. BFAK:90605958,092f233e0971d1f4e789deca64d1356b912a82925512cccc9acc39197018137d

  • Avatar of Simo389 Simo389 Feb 06, 2014 at 21:59 UTC - 0 likes

    @Evangon Hey, just thought I'd give a heads up. On enabling, the file ImgMap/maps.dat isn't being created; so it's causing numerous errors/issues on startup and when players create maps (Because it's thinking the file exists when it doesn't I assume?).

    I haven't actually looked at your code, but I'm guessing it's an easy fix. :-)

    Last edited Feb 06, 2014 by Simo389
  • Avatar of PrivCraftAssociates PrivCraftAssociates Jan 26, 2014 at 20:00 UTC - 1 like

    Why is it that every time I restart my server the images I put on the maps get rolled back to its original form?

  • Avatar of haydenminecraftth1234 haydenminecraftth1234 Jan 26, 2014 at 08:57 UTC - 0 likes

    Hello nice plugin

  • Avatar of alexmarkey alexmarkey Jan 25, 2014 at 04:08 UTC - 0 likes

    command /drawimage -s <URL> resulted in my client crashing (as expected from reading the "how to use"), however i typed in console, fixmap <id> which returns me with the following error:

    If i attempt to log in any time after this, my client crashes straight away, if i restart the server the map is just empty (not saved).

    Also, plugin doesnt seem to be creating the directory with the maps.dat and stuff on server startup.

  • Avatar of Evangon Evangon Jan 24, 2014 at 02:31 UTC - 0 likes

    @TheBlackBeltPanda: Go

    I don't get what you're asking to be honest; are you asking for me to send it to specific people?

    @Madlifeee: Go

    Add -s to the command.

  • Avatar of Madlifeee Madlifeee Jan 23, 2014 at 00:37 UTC - 0 likes

    it works great in game. but when i stop my server and boot it up again. the map becomes a regular map showing the land and water and my image is gone.. is there a way i can save the image so it wont dissapear

  • Avatar of TheBlackBeltPanda TheBlackBeltPanda Jan 22, 2014 at 06:50 UTC - 0 likes

    @Evangon: Go

    Would you be able to incorporate player.sendmap(map view)? =)

    Last edited Jan 22, 2014 by TheBlackBeltPanda

    Subscribe and become a Pandaling today!

    Owner of PandaCraft


  • Avatar of Evangon Evangon Jan 22, 2014 at 04:18 UTC - 0 likes

    @TheBlackBeltPanda: Go

    The first one, I'll try fixing it soon as possible. I'll have to fix the one involving /drawimage; for now, make sure your urls start with "http://". To get out of this, try using the /fixmap command with the maps ID.

    @tornado18504: Go

    I can't really help you without any more information. Are you running other plugins? Do you have permission? Perhaps the plugin was disabled for an odd reason?

    Last edited Jan 22, 2014 by Evangon
  • Avatar of TheBlackBeltPanda TheBlackBeltPanda Jan 22, 2014 at 01:35 UTC - 0 likes

    @Evangon: Go

    Using ImgMap v1.4a on CraftBukkit version git-Spigot-1257 (MC: 1.7.2) (Implementing API version 1.7.2-R0.3-SNAPSHOT)
    When the plugin loaded, I received this error:
    Then, when using the /drawimage command, I crashed with this error:

    Last edited Jan 22, 2014 by TheBlackBeltPanda


Date created
Jul 21, 2012
Last update
Feb 16, 2014
Development stage
GNU Lesser General Public License version 2.1 (LGPLv2.1)
Curse link
Recent files