ImageMaps
ImageMaps
Description
With this plugin you can take an image and hang it on the wall with the help of maps and item frames. Every map represents 128x128 pixels of the original image, allowing you to create unscaled copies of existing images. You could use it for displaying information on your server's spawn, or added quasi custom images to your server.
Notice
I'm not too active with Minecraft anymore, so new features and updates may be rare. I will try to keep the plugin in a working shape, so feel free to report bugs. I won't guarantee for anything, though.
Technical Notice
Minecraft has a very limited color palette for maps. Your images may look different in-game.
Too many Item Frames within an area may cause performance issues for players.
Too many Maps within an area may put additional strain on the network connection.
The number of maps per server is limited to 65536, so this plugin may use plenty of them.
Usage
Place your images in the plugins/ImageMap/images folder. Supported formats are JPEG, PNG, BMP and GIF, there is no need for a restart or reload after adding an image.
You can also download images from the Internet via the following command:
/imagemap <fileName> download <URL>
In order to place an image run
/imagemap <fileName> [scale <blocksX> <blocksY>] [fastsend (true/false)]
The optional scale arguments will scale the image according to the size you entered while keeping the aspect ratio. If left empty the size will be calculated by the image resolution, splitting the image in 128x128 pixel sub-images.
The optional fastsend argument (entered as true or false) determines whether the plugin will send the entire map at once to the player or if the Server should handle sending the data itself. True -> faster loading, more bandwidth usage when playing/loading images.
After entering the command you have to right click on the top left block of an area that has enough space for the image. When you right click into the air you can cancel the selection (requires item in hand).
To see the size of an image run
/imagemap <fileName> info
To reload an image (e.g. after changing it) run
/imagemap <fileName> reload
The imagemaps.use permission is needed to run any command. The imagemaps.download permission is needed to run the download command.
The plugin limits how many fastsend maps are sent per timeframe to prevent connection lag, by default 8 maps per second (20 ticks), amounting to 128 KiB/s.
You can change this behavior by creating a config.yml in the plugin folder with the following contents:
sendPerTicks: 20 mapsPerSend: 8
Source
The plugin's source code can be found on GitHub.
Comments
-
SydMontague Owner
-
View User Profile
-
Send Message
Posted Jul 2, 2014@ForXP
There are 3 ways this message can occur: 1. You clicked a wrong blockface 2. You used a invalid image name 3. There is not enough space to place the image
1. and 2. trigger also cause a message in the server log, so it should be easy to find out.
-
View User Profile
-
Send Message
Posted Jul 1, 2014hey i just installed your plugin and i am trying to do what it says and its not working. Wherever i try to right click on the upper left corner it says i cannot place the image there. Please help!!! Thanks
-
View User Profile
-
Send Message
Posted Jun 18, 2014Great plugin! Have a look at the screenshots the links below lead you to! http://i.imgur.com/ZG1QnSp.png http://i.imgur.com/ldkflxr.png
Also, this is the best of all other plugins like this! The only thing I do not like is I need to use something to resize the pictures to make them the size I want.
I would highly recommend!
-
View User Profile
-
Send Message
Posted Apr 27, 2014This is a great plugin man. I didn't even realise you could do this with maps. Thanks a bunch.
-
View User Profile
-
Send Message
Posted Apr 26, 2014thing is its not missing the library.. cus after i restart it after this error.. it works perfectly fine
-
View User Profile
-
Send Message
Posted Apr 25, 2014@XeonG8
After some code lookup and googling it seems, like it is a problem with your Java/Linux installation. There is really nothing I can fix, as these errors happen deep inside CraftBukkit/JVM code. Basicly it's missing a class/library.
And I'm not enough Linux pro to give you an ultimate answer to fix it, sorry...
-
View User Profile
-
Send Message
Posted Apr 24, 2014works sometimes.. and other times i get this...
-
View User Profile
-
Send Message
Posted Mar 22, 2014@TheBlackBeltPanda
Okay, I still did not manage to reproduce the error. As ItemFrames are entities, it's really strange that you see the frame and they disappear after a relog.
Are you able to reproduce this behaviour on a controlled enviroment, where you are able to remove plugins to see if another plugin is causing the problem?
Also, are you able to pick the map out of the frame before it disappears? This way you could at least repair the images with the picked maps...
-
View User Profile
-
Send Message
Posted Mar 21, 2014@SydMontague
Version: 1.7.2-R0.4
Not sure about plugin conflicts. I have one called AntiFrame that prevents people from breaking frames in protected areas and also WorldGuard which also has some frame protection. Other than that, I don't know what would conflict.
-
View User Profile
-
Send Message
Posted Mar 21, 2014@TheBlackBeltPanda
That's really strange. What CB version are you using, and is there any plugin that may have some conflicts with this one?
-
View User Profile
-
Send Message
Posted Mar 21, 2014@SydMontague
It doesn't seem to be breaking, just disappearing. I tried using the command in survival mode, still did the same thing.
This is after using the command:
http://gyazo.com/c10121ac9236c457570dbdd0f8095034
This is after relogging:
http://gyazo.com/db4f5decffe213a844a08c21b6ee2d45
Happens every time. =/
-
View User Profile
-
Send Message
Posted Mar 21, 2014@TheBlackBeltPanda
I could not reproduce the problem on my local server, so I would suspect that you or something else on your server destroys the image by accident.
Are you in creative mode when creating the image? If yes, try it without and look if there are map items on the ground, when the problem occures.
-
View User Profile
-
Send Message
Posted Mar 21, 2014When I try to use this, the top-left most image disappears after logging out and back into the server. The item frame, as well as the rest of the image, remains.
-
View User Profile
-
Send Message
Posted Mar 19, 2014@DunderMifflinDMI
When we're talking about a completly new image with a new, currently unused, file name there is no need for a restart or reload in any way.
Just move the image to the folder and start using it ingame.
-
View User Profile
-
Send Message
Posted Mar 19, 2014Would a reload command be possible so that servers dont have to be restarted when a new image is placed in the files?
-
View User Profile
-
Send Message
Posted Mar 16, 2014@Riverdon
Check your serverlog if there is an additional message.
There are basicly 3 options how this message can pop up.
1. The specified file does not exists (make sure you include the file ending!) - you can use Tab-Complete for the file name.
2. There are solid blocks where the item frames would be placed.
3. You tried to place the image with clicking on a illegal block face (basicly upper side or lower side)
1. and 3. will create a message in your log, so it should be easy to see what's the reason.
-
View User Profile
-
Send Message
Posted Mar 16, 2014Hey Sydmontague.
This looks like a nice plugin but I am having some problems using it.
I do the following but doesnt seem to work for me I am doing something wrong but dont know what.
Stand on the ground and type /imagemap Tinalund01
Then it tells me to click on the left upper corner. I have tried this range from 10 block to 100 block but i gett this message:
"Can't place the the image here!"
What I am do need to do?
Pleased to hear
Riverdon
-
View User Profile
-
Send Message
Posted Mar 15, 2014@Bobcat00
Yes, you need to restart the server in order to see the changed image. I'll look into adding some kind of reload command, but I just uploaded 0.3.1, so I don't want to push another update too soon...
If WorldEdit supports moving ItemFrames while keeping all of their data (items), it's like moving the images around. (Afaik it does not) Also, there is no performance hit in making a new instance of an existing image. It will reuse the maps if you have multiple instances of the same map. A fullHD picture will always use the same 135 maps, no matter who often you placed it in the world.
Fast mode can be activated by adding a "true" after the image file in the command. If you're creating a fastMode image of a already existing slowMode image it will override the slowmode image, making all instances of this image to fastMode. (This way you could also change a slowMode image into a fastMode one.)
However, I need to say that, even if the map_xx.dat files are not used by the plugin, they are created for every map I need to create. Therefore, they count towards the 2^16 limit, even if they aren't used by the plugin anymore. They just act like normal maps after that.
However, you could use over 400 different FullHD images and you would still have over 10000 maps left for your players.
-
View User Profile
-
Send Message
Posted Mar 15, 2014Thank you for your reply. I really like this plugin.
For changing an image, I mean having a new png file displayed. So all I need to do is replace the png file on the server. I guess I also need to restart the server? Perhaps there should be a command to reload the plugin.
For moving an image (I was thinking with WorldEdit's move command, would that work?), it sounds like deleting the old image and making a new one. And another FAQ entry if you make one would be how to switch between fast and normal modes.
I guess part of my confusion is I don't know the way Minecraft handles maps internally. I was worried the deleted maps would continue to count towards the 65535 limit. It sounds like there isn't anything to worry about.
-
View User Profile
-
Send Message
Posted Mar 15, 2014@Bobcat00
1. What do you mean with replacing an image? Making it to another image (with the same resolution) is simply replacing the file in your file system. Using space, taken by an existing image ingame will require you to destroy the existing item frames and run the /imagemap command again with your new image.
2. Simply by using the /imagemap command again. If you don't want the old image where it is, just destroy them like you would do with normal item frames. You could also retain the maps from the item frames and place them manually where you want them...
3. Remove the image file from your file system (or rename/move it). On startup the plugin will see, that the image is no longer avilable and will remove every entry. Deleting the map_XX.dat file is NOT required, as the plugin does not use them in any way. The image data is completly virtual and plugin maps will behave like normal maps without the plugin.