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.
The plugin works great in 1.13!..... minus this weird lighting glitch. The lighting is inconsistent and changes depending on where I place them. It seems that this is due to chunk borders not completely sure. Is there a possible fix???
In reply to thirtyvirus:
In reply to SydMontague:
In reply to thirtyvirus:
In reply to SydMontague:
I want to ask you something:
How did you fixed the map rendering on minecraft 1.13, because when I create a map it doesn't show up and it gets replaced by the normal world map.
https://bukkit.org/threads/fixing-custom-maps-for-1-13.474616/
In reply to the_spaceman2000:
yes yes yes it works .... finally ... you have done mega good Thank you honestly a good job .... Thank you :)
Can you update image map to 1.13 please
In reply to blueeyestar:
Is there any way to "delete" a map once created?
Can you implement a configurable limit how many imagemaps there can be? I'd like to set it to something like 10.000 or so, so that players can still use 22.000 maps.
@SydMontague
It does work now. It must have been a spigot issue the first time. Thanks anyways!
@ashley0891
After doing some tests I couldn't find anything that broke with 1.11...
Will there be an update for 1.11? Using maps only loads the first square, and overwrites older map.
@vasyaok
It's a bug in Minecraft itself, so I can't do anything about it. :(
The good news is that it's going to be fixed in 1.11 according to the bug tracker.
It doesn't show pictures if I change worlds. 1.9.4
Working with bukkit for MC 1.8.9. Very nice plugin. Only thing that's unfortunate is you have to place the image into the folder, would be nice if it could grab it from a URL.
Working well on my Spigot 1.10 test server.
Thanks to your hardly work :)
@SydMontague
Hmm, This only happens when I make a map with your plugin, otherwise everything has been running fine for 1+ years now without issue.
Edit:
Yep I made a test server running 1.9.4 on our windows machine and the plugin works fine there, any ideas why this might be?
Edit 2:
After some more messing around Iv resolved the issue, for future reference if anyone else comes across this issue:
Stop server,
enter 'unset DISPLAY'
if using Tmux/Screen, recreate the terminal session.
start server
And the issue should be resolved :)
Thanks for the great plugin! Its a fantastic addition.