ImageMaps
ImageMaps
ImageMaps is a plugin for Bukkit Minecraft servers that enables you to place custom images in your world by rendering them onto maps and placing them in item frames.
This can be used to create info graphics, custom paintings and even the appearance of custom textures.
Installation
You will need a Server that implements Bukkit 1.13 or newer and the Spigot-API. Some features are only available in newer releases. Make sure to use the latest release of your server software before reporting issues.
Put the plugin into your servers plugins
folder and start it up. A folder for the plugin will be created automatically. You can place your images in the images
folder inside it.
Upgrading from versions < 1.0.0
The plugin should convert your maps.yml automatically. It will attempt to create a backup before doing so, but it is recommended to do one manually as well.
Usage
In order for you use place images they must be present in the images
folder. You can either put them there via FTP or just copying it, or by using the plugin's download command, allowing you to access images from the Internet.
To place images just run the /imagemap place
command and right click the block that should be the upper left corner of the image (based on your perspective).
Images will by default split into 128x128 pixel sub-images to fit on a map. The image may be scaled via command parameters, however it is recommended to prepare correctly scaled images.
The color palette of Minecraft maps is very limited, requiring the plugin/Bukkit to convert the input image. This will result in your images looking different ingame than the source. The available color table can be found here: https://minecraft.gamepedia.com/Map_item_format#Color_table
The invisible and fixed item frame properties are only available in 1.16+. You can modify them for any item frame by using a configurable (default a wooden hoe) items. Right click to toggle visibility and Shift+Right click to toggle the fixed state.
Commands
- /imagemap place <filename> [frameInvisible] [frameFixed] [frameGlowing] [size]
- Starts the placement process
- frameVisible and frameFixed are only available on 1.16+
- frameGlowing is only available on 1.17+
- /imagemap download <filename> <sourceURL>
- downloads an image from the given URL into the
images
folder
- downloads an image from the given URL into the
- /imagemap delete <filename>
- deletes an image from the
images
folder
- deletes an image from the
- /imagemap info <filename>
- prints info, such as resolution and expected size
- /imagemap reload <filename>
- reloads an image, to be used when the image file changed
- /imagemap list [page]
- lists all images in the
images
folder
- lists all images in the
- /imagemap help [command]
- prints help for commands
Permissions
imagemaps.*
- grants access to all permissions
imagemaps.place
- grants access to /imagemap place command
imagemaps.download
- grants access to /download place command
imagemaps.delete
- grants access to /imagemap delete command
imagemaps.info
- grants access to /imagemap info command
imagemaps.list
- grants access to /imagemap list command
imagemaps.reload
- grants access to /imagemap reload command
imagemaps.help
- grants access to /imagemap help command
imagemaps.toggleFixed
- allows to toggle the "fixed" state of frames with a wooden hoe
imagemaps.toggleVisible
- allows to toggle the "visible" state of frames with a wooden hoe
All permissions are default true for OPs.
Maven
You will need to configure your environment to access GitHub repositories.
<repository>
<id>github</id>
<name>ImageMaps repository</name>
<url>https://maven.pkg.github.com/SydMontague/ImageMaps</url>
</repository>
<dependency>
<groupId>net.craftcitizen</groupId>
<artifactId>imagemaps</artifactId>
<version>1.0.1</version>
</dependency>
This plugin has been developed for the CraftCitizen survival Minecraft server.
@SammyT291
It states that it can't connect to the X11 server, so the cause is most likely in your Server (Linux) setup/configuration rather than in Spigot or my plugin.
Hmm, seems to be incompat with 1.9.4 Spigot,
When I create a map it will crash the server when a player loads the chunk containing the map, forcing the server to fall into a crash restart loop since im in that chunk.
To fix I have to remove the map file from the world save.
Error log:
http://pastebin.com/yJW2aZsG
Hope its an easy fix, I love this plugin so much, adds a lot to a servers visual appeal without forcing players to DL a resource pack ^^
Yes, i tried. Maps not loading from hand :c
And now i cant see them on my admin account D:
I know nice plugin that im using PERFECTLY on 1.8.9
CameraObscura. With fastsend and img to map.
@Bodyash
This certainly sounds weird. Is there any other player that is/was at some point able to see the maps? Also, have you tried to give one of the maps to a player (i.e. by cloning it out of the item frame)? If yes, does it show the image then?
I highly suspect it's actually a Minecraft/Spigot bug, as sending the image is actually something my plugin doesn't mess around with (fastsend only adds an extra layer). The Nether portal bug also shouldn't only affect the Nether but all world transitions. The Nether is just where most people will notice it, as it's the most common world.
Just look. First screenshot from admin accout. I Created imgmaps with fastload true. I can see them. And i can see them if i restart the server.
https://pp.vk.me/c633418/v633418094/25123/rdF5yefYfEU.jpg
Other players says me that item frames is empty. So i logged in with another nickname and:
https://pp.vk.me/c633418/v633418094/2512d/WrJ6KJkShgs.jpg
And i think its not Nether portal bug. Cause at my another account i`d never been in nether world.
Maybe it happens becase my spawn at world Empty, but main world for building, nether and end - is named world. All new players spawns at world Empty.
@Bodyash
So you're saying it works sometimes? If yes that means the problem is most likely not related to my plugin but to either another plugin, the server software or some misconfiguration on your side.
If there anything noticeable in the server logs?
(My first guess would be it being this Bug in Minecraft itself, as it affects another of my map based plugins as well.)
@mat41997
If they don't work already then the library I'm using doesn't support gif images, which isn't suprising considering how obsolete the format is.
I recommend to convert these images to PNG's.
If you're specifically talking about animations, I did some tests with them quite a while back and came to the conclusion that they're not worth the trouble of implementing them, considering the technical problems that come with them. (High bandwidth and resource usage, able to cause lags on both, server and client.)
Work so bad :c
http://cs633418.vk.me/v633418094/24f4b/O3gA5BAcTsY.jpg
Has a 1% chance to load img.
1.9.2 spigot
you can add .gif support?
@SydMontague
xD Yeah, thanks!
@U1T1MATE
Done. When I uploaded these files there was no option to do so and I had to select some version... >_>
(Curse should really get their shit together...)
@SydMontague
Just a suggestion, you should update the file saying it's for game version 1.9 (rather than 1.8.1, which it says now, slightly misleading)
@jwpwns
Just uploaded the update, thank you for reminding me. :)
@SydMontague
NVM i solved that problem However this no longer works for 1.9 its a AWESOME plugin can you please update when you try to place the image it does nothing now
@jwpwns
Well, is there enough room for the image?
It worked perfectly when I tried it on a local server.
no matter what i do it says there is not enough room any1 else have this problem?
Thanks for the awesome plugin! I was using a similar plugin that was created for MC 1.8.8 and it keeps breaking. This plugin has not been updated for over a year and it still works. Very nicely done!
@pilvimaa
Is there any error or message form the plugins in your server logs that might hint towards the cause of the problem?
The only ideas I have right now should all yield at least something in the log...
Sometimes after restart the map ID's have changed resulting in the old map images being normal maps.
Any idea if this is caused by Minecraft or by ImageMaps?
I'm using latest spigot - but the issue has been around for quite some time.
EDIT: I noticed that something has caused my maps.yml to reset. It's empty. This seems to happen regularly but I can't reproduce it every time. Could for example a server crash cause this to happen or error in ImageMaps code?
@SydMontague
I am having the same problem.. It happens when you tp from one world to another.. When you enter the world where the images are in (and if you have a few images) only parts of it (sometimes nothing) will load in.. I am using multiverse and spigot :)
@TheBlackBeltPanda @aasikki @jonghyek
I have problems reproducing the error locally... Looking at the code there is nothing that should be able to break, as it fully uses the Bukkit API (which didn't get changed) for handling the maps...
I have the feeling the Spigot Team or Mojang fucked up Maps in 1.8 >_>