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 mr_pineapple_was_taken:
/imagemap place <filename> [frameInvisible] [frameFixed] [size]
With [size] being formatted like 5x5. It's strongly recommended to resize the images with a proper image manipulation program instead, though.
When i restart the server the images stay, however, if I change the world from my SMP to another world, then when i restart back to my main world they reset to normal maps
In reply to jpengelly345:
Uh, changing the primary world might break the plugin, it's not expecting that to happen.
i cant remove the image because its just pasted on the ground how do i remove it?
In reply to andyedits:
Use a wooden hoe to toggle the "fixed" state of the item frames, then you can destroy them like regular item frames.
Hi, how do I give people permissions to use the plugin commands without making them OP?
In reply to corbeenie:
Use a permission plugin.
I can't seem to get a custom image that i made onto the item frames from my computer. Any advise?
In reply to siguyman5:
You have to upload the image to your server or in a place it can be downloaded from.
When trying to resize an image it doesn't let me do it. Is there a certain way i'm meant to be typing it in to resize it?
When I try placing the image, it tells me to right click the block on the upper left corner to place the map. When I do that, it says theres another entity infront of it and it won't place. The ingame size I was given was 6x6, and I did that. I'm confused.
edit for some more info: im using a 1.16.4 aternos server if that does anything
Hey, im using the plugin, download a image but the iframe dosent show nothing.
any fix for that?
when i try to place it it says its blocked what i can do?
In reply to dream_simp29:
Make sure there is enough space for the image you want to place.
how do i remove images i can't get them out of there frame? i also cant remove the frame itself
In reply to pete_k12:
They're regular item frames with maps, so hitting them should destroy them. If you've made them fixed/invisible you might have to do that in creative mode or change that state first.
is there a way to rotate the images, i can't put any portrait photos in
In reply to Ibach7:
You have currently two options:
a) rotate the image with an image manipulation program
b) place the image, take the maps out of the item frames and put them back+rotate them
I have a question, does this plugin work on 1.16.4? (also does it work on bukkit and paper?)
In reply to LoveULucasAndParlok:
The plugin should work on all Spigot-API implementations from Minecraft 1.13 upwards. So Spigot and Paper yes, but not CraftBukkit.