ImageMaps Plugin 1.7.2

Updated: May 27, 2015 | 653 views |


With this plugin you can take an image and hang it on the wall with the help of maps and itemframes. Every map represents 128×128 pixels of the orginal image, allowing you to create unscaled copies of existing images. You could use it for displaying informations on your server’s spawn, or added quasi custom images to your server.

Beta Notice

This plugin is currently in Beta state. It is working, but you may find some bugs or missing features. Please report bugs and wanted features, so that I’m able to adress them.

Technical Notice

When there are too many ItemFrames in an area, your players might have FPS drops. That’s an clientside issue. You should also keep in mind that your server needs to send 16KiB of data to every player for every map once. Having a lot of maps close to a player’s login position may cause connection lag on one of both sides, if the internet connections are not very fast. (Minecraft does split up the maps in several smaller packets to reduce the bandwidth needs, but if you have too many maps, that might not work.)

After placing a image, you may see that the itemframes are placed on the wrong side of blocks. This is a clientside issue, that can be solved by reloading the chunks of the itemframes (relogging).

Also, keep in mind that every server is limited to 65536 maps and every 128×128 pixel block is using one of these maps. There might be some optimizations to reduce the amount of used maps by this plugin in the future.


After starting up the server the first time the plugin should create it’s own folder, which contains another folder called “images”. Drop pictures you want to use in this folder. Supported should be JPG, PNG, BMP and GIF. You don’t need to restart or reload after adding a picture to this folder.

The “imagemaps.use” permission is needed to run the commands.

To place an image, type /imagemap <file>. Where <file> is file name from your images folder. You can use tab complete for the filename. After this you need to right click on the block face where you want the upper left conor and if there’s enough room, it’ll place the image on this wall.

You can calculate the needed room by dividing the orginal image’s resolution by 128 and ceil the result. (A 1920×1080 images will need 15×9 blocks).


This plugin utilises Hidendra’s plugin metrics system. You can opt-out under <yourPluginFolder>/PluginMetrics/config.yml

The following informations will be collected:

  • A unique identifier
  • The server’s version of Java
  • Whether the server is in offline or online mode
  • The plugin’s version
  • The server’s implementation and game version
  • The OS version/name and architecture
  • The core count for the CPU
  • The number of players online
  • The Metrics version
  • Your online-mode
  • Your server location


The plugin’s source code can be found on GitHub.

ImageMaps Plugin 1.7.2 Download Links

Credits: SydMontague