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.
If you are experiencing that annoying 429 error/UnknownURL error:
*
*
Just go here: https://imgbb.com
(it's literally a image uploader that can convert a photo's link to whatever..)
Upload a photo and then copy (ONLY THE LINK PORTION) *inside that whole string of text* under the option: BBCode full linked
If it still doesn't work.. try messing with the other link types
Hope this helps!
Hey, whenever i try to download an image to imagemaps, it always shows the HTTP error 429
i have formatted the link, and it still doesn't work
https://i.imgur.com/Z4aiutF.png <- the image im attempting to download
In reply to Kmsad:
Just go here: https://imgbb.com
(it's literally a image uploader that can convert a photo's link to whatever..)
Upload a photo and then copy (ONLY THE LINK PORTION) *inside that whole string of text* under the option: BBCode full linked
If it still doesn't work.. try messing with the other link types
Pain in the freaking ass.. should just take the damn url but no. Hope this helps.
cant remove item frames. shift+right click with wooden hoe doesnt work
Hi, is there a way to have the maps as an item? Trying to set up an album cover shop on my server.
In reply to u_flipz:
Nevermind, you can just middle-click the map haha
How to limit map size for players?
Same issue here. really annoying :(
Getting some image map randomly deleted sections after updating to 1.19. Please update the plugin
How do I change the image size
How do I set the image size?
Hello!
Just uploaded all files from local server to hosted server. Despite files being in the same relative path, I get informed that "no image with this name exists". Is there anything that could help?
In reply to AtlasTh3Mage:
this happened to me all i did was change the format of the image to png
Would be great if plugin used Glow item frames!
I've installed ImageMaps on my server and it's working completely fine, but the problem is...
When I place an image anywhere, after that its permanantly added, I cant remove it!. Even if I break the supporting wall, it will keep showing, HELP ME!
In reply to rehmthegreat:
You have set the image to be "fixed", which means they can't be destroyed in regular fashion. You can remove that state by shift+right clicking the item frame with a wooden hoe. Alternatively create players as well as commands should be able to kill the item frame.
Is it possible to update to 1.18.2?
In reply to 冰砚炽:
Most Plugins don't need to be updated when Minecraft updates. Please verify the plugin is actually not working before asking for an update.
This plugin uses the BukkitAPI exclusively. It will likely still work in 3 or more years without any updates.
Hello,
Do you think it would it be possible to load images from an external server instead (and not from the plugin folder), with some tweaking to the plugin ?
In reply to The_Naeso:
The short answer is no, I don't intend to implement additional functionality to load images from remote servers besides the download functionality. There are too many things to consider, in particularly in terms of security.
What you could try however is replacing with images folder with a link or mount to an external server, maybe that works.
What are you trying to achieve?