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.
@frash23
Now. I just uploaded it. :)
Any chances we'll get that 1.8 update soon?
@Liger_XT5
You seem to use another plugin than this. However, this plugin doesn't work with Spigot 1.8 either. There have been changes in how ItemFrames are handled.
A patch has already been provded for me, however, I still have to make sure that it works properly, even with older CB versions. And that's a hard task, as I'm not at home...
Any possible updates for MC 1.8 spigot? When attempting to load an image with /tomap, it times out saying the render took many time. (Should be took too much time). The console error:
@SammyTheGamerPZ
Are there maps in the frames? Is there an error message in your server log?
Hi, I have a problem, when I create an image it doesn´t appear the map, just the frames, any help?
Really nice plugin! It works very well! But one nice thing to make it even better is to make it name the maps the same as the image, and just not "Map". But its a nice basic plugin. Straight forward and not a lot of shitty commands no one is using! Keep up the good work!
Here's an example on how much better the image can look by adjusting the color palette in an image editor. The original image is in the center, and the two outside ones are in-game screenshots. Note the coloring/texture of the hand and the area around the cat's nose. The image on the left is dithered, but it still looks much better than the one on the right.
http://www.bobcat00.com/palette_example.png
I created a PNG file that contains one pixel of each color used by Minecraft map items. You can use this file with an image editor to adjust the color palette of an image so it will match the one used by Minecraft: http://www.bobcat00.com/minecraft_palette.png
@iloveicecream11
The command requires input, only a player can provide. (Interaction with a block)
The commands all work as a player - but not as console. Any idea why? Is this possible?
@TheBlackBeltPanda
Sounds strange - it didn't happen with a lower 1.7.x version before?
How many different images do you use and how many instances of them are around? (And how big are the images) What CB build are you running? Are you getting the "Can't keep up!" message?
Using ImageMaps 0.4.0 on MC 1.7.10 results in my server hanging, often requiring 30-60 seconds to execute any command and lots of time-outs all around. No errors in the log. Disabling the plugin solves the issue.
Good plugin, found some problems, but works, that is important ;)
@rysroma
Thanks, will be fixed in the next release.
Please fix message: that shall be the upper left not conor but corner :D
@laurensvh
Are you sure you placed the image in the images folder as well? Did you have another image "png4.png" before? Have you restarted the server and does the problem persist?
Hello,
When I place a image with the command /imagemap png4.PNG , it shows a picture , but not the right one (See screenshots). What am I doing wrong?
Screenshots: http://gyazo.com/36d140f4d266bfa751da6f0cc6d889d0 http://gyazo.com/1894d5be70007412eab0623714eccd41 http://gyazo.com/76690b098ca602ac9a2408bc05432797
Regards, Laurens
@wwwnic
The plugin does not scale the image, you have to scale it yourself. If you don't want empty space make sure your image resolution is dividable by 128.
@SydMontague
http://i39.servimg.com/u/f39/17/82/52/56/2014-010.png
._.