ImgMap

Status: In Beta

ImgMap is an extension to Minecraft Maps that allows any website image to be rendered on a map!

Original Idea came from md_5 (whose idea I do not claim) and his wonderful troll face: http://forums.bukkit.org/threads/why-the-map-api-is-awesome.85195/

In full description, 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.

Noob How-To

Step 1 > Get a map. One may either craft a new map or one may spawn one using commands. The ID for a map is 358 and the data value defines the specific map. For example, use /i 358:49 1 to spawn 1 of map 49.

Step 2 > Get URL of desired image. Get the URL which points to your image from your browser. If your image is on your computer and not on the internet yet, drag it into http://imgur.com/ to upload it then copy the URL.

Step 3 > Put pretty image onto map. Hold the chosen map in hand and type in this command followed by the URL to your image: /map http://...

Step 4 > ???

Step 5 > Profit!

There's a lot more one can do using this fantastic plugin, read on for slideshows and animated maps!

Known Bug

Ghosting bars.

Features

So far, ImgMap supports the following (NOTE: This plugin is under heavy re-write, so features are volatile):

Any image (assuming that the file returns a Content-type of "image", non-tech savvy people, this reads as essentially any image, with the exception of a few.)
Slideshow feature

Planned Features

Many features are planned.

Commands

/map <url> - Maps the image.
/smap <time in seconds> <url1> [url2] [url3]... - Renders a slideshow of the given images.
/rmap (/restoremap) - Restores a map.
/imgmap (/imap) - Outputs the version and plugin name.

Permissions

imgmap.cmd.map - /map
imgmap.cmd.slideshow - /smap
imgmap.cmd.restoremap - /rmap (/restoremap)
imgmap.cmd.imgmap - /imgmap (/imap)

Examples

Google Logo Cornell Box

Volatile, Constantly Updating Source (LosingPixels)

https://github.com/CirnoTheGenius/ImgMap-LosingPixels

Pull n' Push *

https://github.com/CirnoTheGenius/ImgMap-LosingPixels/tree/community

Pull n' Push was a suggestion by evilham, where this repository is used to provide users to push new features and/or bug fixes without pushing them to the main LosingPixels branch.

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

210 comments
1
2
3
6
9
12
15
18
19
20
21
Next →

- Reply
- #213
XenonRide May 09, 2013 at 16:43 UTC - 0 likes
I get [ImgMap] The specified image is not compatable! When I try and add a image to it
- Reply
- #212
noname202 May 09, 2013 at 10:29 UTC - 0 likes
The /rmap command seems to be broken in the current release.
- Reply
- #211
OtterTrotter Apr 25, 2013 at 05:53 UTC - 1 like
@rangewonk: Go

I had your second issue and fixed it by placing the original copy of the map in the item frame whilst in survival mode. Placing in creative only seemed to allow me to see the image.
- Reply
- #210
rangewonk Apr 24, 2013 at 23:09 UTC - 1 like
i'm having 2 problems with this plugin. One -p only saves the most recent one on restart. and the second problem is only people that have held the map in their had can see the pictures on them if they are mounted on an item frame.
- Reply
- #209
Antiman9 Apr 24, 2013 at 20:02 UTC - 0 likes
I can confirm that -p only saves the most recent image added.

You can reset the server each time and it WILL save, but only the first image with -p any other image that you try to save ends up disappearing upon reset.
- Reply
- #208
OtterTrotter Apr 21, 2013 at 20:19 UTC - 3 likes
Using -p flag on latest build and it only saves the most recent map I made after a restart.
- Reply
- #207
CaptainJohnnyBlu Apr 20, 2013 at 19:55 UTC - 2 likes
@Antiman9: Go

Works fine for me on spigot...

JohnnyBlu of Isaiki
- Reply
- #206
poiNt3D Apr 19, 2013 at 04:52 UTC - 0 likes
@nejcneo: Go

You can just make the map permanent.
- Reply
- #205
Dunbaratu Apr 18, 2013 at 19:05 UTC - 1 like
Caveat: I post this to help fellow users of this plugin do a thing that I did, but I am NOT the plugin developer so things I say here could be mistaken.

If you already had permanent images (via the -p option or the MapsDefaultPermanent option in the config.yml file) generated with older versions, and they reverted back to their map image after the update, you CAN get them back the way they were because the URL data is still there after the upgrade but its in a different format and under a different filename which is why the plugin doesn't see them anymore. You can edit the files behind the scenes and get those images back. Here's how:
1. Stop the server.
2. On your server host, go to the plugins/ImgMap directory.
3. I'm going to ask you to edit a file. Obviously if you don't follow the standard safety practice of making a copy of a file before you alter it, well, that's at your own risk.
4. The filename for saving the URLs is now different. Append the contents of MapData.list (the old filename) to Maps.list (the new filename). If there is no Maps.list file yet, then that just means you haven't made any new permanent (-p) image maps after the upgrade yet. If that's the case then just make a new Maps.list file that's a copy of MapData.list.
5. The format for saving the URLs is now different and you'll have to change the format of all the older lines you've just inserted into Maps.list. To do this, edit the file called Maps.list and replace all instances of " > " (space greater-than space) with a single colon (:) instead.
6. I have no idea if this matters to the plugin or not but it can't hurt so I did it anyway: Ensure the lines in Maps.list are still sorted in order by map number after the insertion, by moving lines up or down as needed to make this happen.
7. Restart the server and see if it worked. If not, restore the files to their original state (I did say to make copies, right?)
Note, since I run on a linux server, I did the above with the following shell commands, but I gave it in detail above like that so people could do it manually or write their own scripts in their own OS's preferred way:
# Do the steps described above in bash shell commands: cd $MYCRAFTBUKKITHOME/plugins/ImgMap sed 's/ > /:/g' < MapData.list >> Maps.list sort -n Maps.list > sortedMaps.list mv sortedMaps.list Maps.list
On another unrelated note:

The config.yml option "MapsDefaultPermament: true" doesn't seem to work anymore. This is why you now have to give the "-p" option explicitly when before you didn't if you had that in your config file.
- Reply
- #204
Antiman9 Apr 17, 2013 at 09:20 UTC - 0 likes
@OtterTrotter: Go Keep in mind that this wasn't developed for Spigot and was initially created for Bukkit.

As someone who has tried to compile plugins for Bukkit I can tell you just how frustrating it is when the code changes. I'm sorry that ImgMap doesn't work on spigot but there isn't much we can do to help.

However, since the source code is available, try asking around for people to help you recompile this for spigot. You may find someone willing to help.