ImgMap
ImgMap: Render any image on an in-game map!
By Evangon, Maximvdw, 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.
Installation
Just drop it into the /plugins/ folder! No special configuration needed!
How to use
- 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!
- 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".
- Hold the map with the super specific ID and type in "/drawimage" and paste it! For most users, to paste, you do "CTRL+V".
- 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!
- Viola! Your map now has that pretty picture of a kitty or something!
Commands
- /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> 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!
- /drawytvideo <yt-ID> Experimental. Downloads a video and converts it to a GIF format. See /drawanimatedimage for more information as the same process is used.
- /emulategb <rom name> Highly experimental. Emulates a GameBoy (only GameBoy, not GameBoy Advanced or GameBoy Color) game on a map. Fully integrated, no client mods needed! Click on the chat messages given in chat to control the emulator.
- /emuaction <save|load|a|b|left|right|up|down|holdinput> Simulates input for emulated GameBoy games on a map. Used by the gamepad, you can also use it as a command if you wish. Note that "save" and "load" do not work as of current. Any input button just simulates input. "holdinput" makes the emulator act as if the person is holding down a directional button and directional only.
- /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.
Permissions
- 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!) https://github.com/CirnoTheGenius/ImgMap-LosingPixels
Examples
I'm having the same issues. Maps are reset on a restart... Thanks for a fix in advance
@Marsi77
Same here. Fix it please.
Yes after restart, the maps are cleaned. Please fix.
Nvm it still does not work after RS. the only difference is that its saved in the file.
Please fix this!
After reading the comments Ifigured that I only neded to add a -p to make it permanent, it would be very helpfull if that actually was mentioned in the descriptions.
First I tried with latest spigot.
But since that did not work I tried with latest bukkit and the first 1.6.2 bukkit build on a compleetly empty server, this was the only plugin and everyting else was on defult settings.
It did not save maps on restart. However if i manually put the image in the image folder I can just use "/map image.png". But since I have no idea how Maps.list is suppose to look like I cant code it manually.
Does somone hav a way of adusting the config manually?
@maxiz22
I have the same problem...
Looks like we all need to find a new plugin that puts images on maps (if there is such another plugin)
@tonymchugh97
Juggling around school, being a private plugin developer for a server, and real life in general isn't easy, I'll say that much :P
Hi I have a problem with the plugin. When the server is restarted, the maps are not saved so return to normal map. This is so? or is it a bug?
@FrauKoujiro
wow what a bad decision on your part with 10,000 downloads. What a shame
Well, it's became apparent that I'm not updating this anymore (no dur), so if anyone wants to take over the project, PM me about it; the only request I ask of you is set and leave myself as the original author. I don't know if CaptainJohnnyBlu or Maximvdw are still going to keep updating them (for which I thank you so much for), nor do I know if they are going to become the next authors or not, but I prefer for them to become to give them the original author rank because I believe in giving credit when it's due.
@CaptainJohnnyBlu
Can't argue with that copy-paste logic. Although, the source code for that jar is perfectly visible here. If you need the fix, you can build it from my fork or wait for the PR to be looked at. Which it hasn't yet. At all.
Edit: It's merged. Thanks!
@tman0
WARNING: Do not trust plugin JAR files provided by other members in the comments.
Plugin JAR's provided by other people in the comments have not been checked by us or anyone from the Bukkit team, and often contain malicious code.
Only download the official plugin JAR file, which can be downloaded using the "Download" link in the top right of this page.
@tman0
yeah, not sure what you are "fixing" but its definitely not working with this problem
@tman0
Didnt fix the problem.
@tman0
Ok thank you
How can we save slideshow maps into the "SlideshowData" folder ? What's the syntax ?
@dueruem
We could have a "/spawn" command which spawns a new map and associates the data value of that new map with the player who created it in a yaml or database, so that when the map command is used, the plugin checks to see if they are the owner of that map.
I think this is a very good idea. ;3
Would it be possible to integrate an option so that a Player who created a map is the owner of that map id? So that only he is capable to modify the map and it's copies. Or just completely forbid to modify already painted maps, so that it is not possible to modify all copies of maps of the same ID , that's really annoying if everyone is allowed to use /map as it is on my 6 player server .