ImageOnMap

Have you ever wanted to view an image on a map ingame? ImageOnMap allows you to do it! (Inspired by ImgMap)


Features

ImageOnMap allows you to load a picture from the Internet to a Minecraft map.

• Loads an image from a URL onto a map. PNG, JPEG and GIF are supported.
• These images will be saved on your server and reloaded at restart.
• Big pictures will be cut automatically into several parts! As example, a 1024x1024 picture will be cut in 16 maps.
• Your image will be centered.
• You can put your map in an item frame.

This plugin is a free software lisensed under the GNU General Public License (version 3 or above). The source code is published on GitHub. You can also get unstable development builds here.

The latest version is only compatible with Minecraft 1.17+.

• For Minecraft 1.14 to 1.16, use 4.1.
  
• For Minecraft 1.13 and 1.14, use 4.0-pre1.
• For older versions, please use ImageOnMap 3.1.

Support and bug requests

If you need help with ImageOnMap, the preferred way is our Discord server. We speak English and French. You can also use the Spigot forum thread, but it will take us way longer to reply. In all cases, read the FAQ first!

If you want to report a bug or suggest features, by far the best option for us is GitHub issues, which you should use whenever possible. If you absolutely can't use GitHub, use the support options above.

We're a team behind ImageOnMap (and others), and private messages from Spigot can only be read by one person. So you should not send help requests, suggestions or bug reports using Spigot PMs. Any PM received after June 28, 2020 with any of these topics will be ignored.


Quick guide

1. Ensure that you have a free slot in your inventory, as ImageOnMap will give you a map.
   
2. Type /tomap URL, where URL is a link to the picture you want to render (see the section below).
3. Enjoy your picture! You can place it in an item frame to make a nice poster if you want.

German speakers, you can watch this video (thanks to StarlessMiner)
English speakers? Watch this one! (thanks to bebosny)
Another tutorial in English (thanks to ltjim007)


Commands and Permissions

/tomap <url>
Renders an image and gives a map to the player with it.

• This command can only be used by a player.
• The link must be complete, do not forget that the chat limit is 240 characters.
• You can use an URL shortener like tinyURL or bitly.
• If you want a picture in one map, type resize after the link.
  • If you want to resize to multiple maps, add the width and height after resize: e.g. /tomap url resize 2 4
  • You can change the scaling method by replacing the resize keyword in the /tomap command by:
    • resize-stretched to stretch the image to the surface (the image could be distorted); or
    • resize-covered to ensure the image covers the whole surface (the image will never be distorted, but some parts may be lost near the borders).
• Permission: imageonmap.new (or imageonmap.userender—legacy, but will be kept in the plugin).

/maps
Opens a GUI to see, retrieve and manage the user's maps.

• This command can only be used by a player.
• Opens a GUI listing all the maps in a paginated view.
• A book is displayed too to see some usage statistics (maps created, quotas).
• A user can retrieve a map by left-clicking it, or manage it by right-clicking.
• Maps can be renamed (for organization), deleted (but they won't render in-game anymore!), or partially retrieved (for posters maps containing more than one map).
• Permission: imageonmap.list, plus imageonmap.get, imageonmap.rename and imageonmap.delete for actions into the GUI.

/maptool <new|list|get|delete|explore|migrate>
Main command to manage the maps. The less used in everyday usage, too.

• The commands names are pretty obvious.
• /maptool new is an alias of /tomap.
• /maptool explore is an alias of /maps.
• /maptool migrate migrates the old maps when you upgrade from IoM <= 2.7 to IoM 3.0. You HAVE TO execute this command to retrieve all maps when you do such a migration.
• Permissions:
  • imageonmap.new for /maptool new;
  • imageonmap.list for both /maptool list and /maptool explore;
  • imageonmap.get for /maptool get;
  • imageonmap.delete for /maptool delete;
  • imageonmap.administrative for /maptool migrate.