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.
is there a solution on "Download failed, HTTP Error code 502"
In reply to zattrik:
Make sure the URL you enter does actually work. Error Code 502 implies an error on the side of the server you're trying to download the image from.
I can't delete a picture with invisible item frames? Is there a way too?
In reply to FoggyJarl:
Just destroy the item frame. If it doesn't work while they're invisible toggle their visibility with the wooden hoe or whatever item you configured.
We have a little (maybe big) Problem with our maps
So, alot of them look like this:
But they used to, for example, like this:
The Plugin is on the server since 10 days, but 2 days in use. Can you help us?
We do not reached the map limit yet. The newest map created was number #1699.
Also item frames who once were invisible are still invisible, so that still works properly :)
EDIT: We think we fixed the problem. It may has something to with the fact that we renamed the images afterwards.
does this plugin auto update if i am using aternos server?
In reply to Onionn_Z:
There is no built-in auto updater in the plugin itself, so you'll have to ask your server host whether they have their own updater.
how do I give players access to the commands with the permission.yml? (without giving them op)
In reply to andrewtheweeb235:
You need a Permissions plugin like LuckPerms to give specific players and groups the permission, the standard permission.yml is not capable of doing that.
is there a way to resize an image with the plugin?
In reply to gentoi_gamer:
Yes, via: /imagemap place yourImage.png false false 1x1
Alternatively (and preferably) use a proper image editor to scale it to your desired resolution before uploading it.
How do I upload files to ImageMaps with FTP?
In reply to gentoi_gamer:
There should be an images folder in the plugin folder for this plugin. Put them there.
i need help how do i resize my image the it only need one frame to place it it
i dont my image do be rly huge
In reply to clifs12:
You got two options for that. You either scale the source image yourself using tools like GIMP or you specify it in the command, like this:
/imagemap place yourImage.png false false 1x1
how do i give other people the option to place and stuff
In reply to couch_milk:
Use a permission plugin
How do I get rid of a 2D image?
In reply to lokipuck4:
Destroy the item frames/map items and remove the images from the folder. If any map items remain they'll revert to normal maps.
In reply to SydMontague:
Thank you