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.
In reply to SydMontague:
There is nothing in the maps. yml. The server version is 1.14.4 spigot. I tried removing plugins where could be potential conflicts but that didnt do anything.
In reply to Forge_User_59971501:
I'm out of ideas then, it works fine on my local 1.14.4 testserver and the plugin should give you some message/feedback in any case. oO
In reply to SydMontague:
Im gonna try to reinstall it one more time. Thanks for the help anyway :)
What does fastsend do?
In reply to zenxy1:
It sends the entire maps/images directly to the player instead of waiting for the vanilla mechanics to do so. I'm not sure it's relevant in current MC versions anymore, but back in the days maps took several seconds to be fully loaded when using the vanilla mechanics.
Do you by any chance have an API that can automatically generate the maps off of provided images?
In reply to incompatibletype:
Not really, but a third party plugin should be able to use the placeImage() function quite easily after obtaining the plugin instance from Bukkit.
In reply to SydMontague:
Solved the issue by just saving in the imagemaps folder and silently running the command to update them. Great plugin!
Hello, whenever i download an image from a url, the image gets cut off at the end, is there a way i can fix this weird cropping issue?
Hi, This Plugin is perfect but I want to ask something, does it work in 1.14.3 or 1.14.4 ?, Thanks
In reply to rexito7w7:
It should work, not sure if I tested those specific 1.14 releases yet but there shouldn't be any changes in them that could break the plugin to begin with.
Ok, Thanks :)
If I can't put pictures into the image file, will using a url still work? I tried a few times with just a url but there is always an error. Might also be cause im trying on 14.4 idk
How do I use the whole space of the item frames, I have it where it's at 290 by 174 according to the image map info, but I do not understand how to use the:
/imagemap <fileName> [scale <blocksX> <blocksY>] [fastsend (true/false)]
to fill up the item frames
In reply to Melondyzounds:
/imagemap <fileName> scale 3 2
This should upscale the image to use the entire frames without changing the aspect ratio (which means an area may remain empty). Alternatively scale the image manually with a image editing software to be the size you need it to be, on frame contains a 128x128 sub-image so at least one dimension should be a multiple of 128.
Why does it say 403 error when I use try to add a image using a link
In reply to Rewind_Shot:
HTTP 403 means that the server you try to download the image from doesn't allow you to do so.
Hey does this work for 1.14.3?
In reply to pleasenaenae:
It should.
Hello,
When I try to create an image, I get the error message that the area isn't large enough and that there shouldn't be anything in the way. I've tried this on a giant wall created by world edit, and it didn't change anything. I don't have any item frames in the way, just a stone wall. I'm running a spigot server, so that might be it, but I'm using a server host that lists this under the plugins that I can install. It's a 1.13 Spigot server, and I can't find the problem. Is there anyway you can help? I'm new to this