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 variabletalis:
Are you interacting with the upper left corner? What's the resolution of the image?
Spigot should be compatible.
In reply to SydMontague:
I'm right clicking the top left corner. I've tried multiple imaged that didn't work, and the ones that I tried using have a resolution of 960 x 577 and 1067 x 758.
In reply to variabletalis:
Does your image have spaces in its name? Try replacing them with underscores or something, that fixed it for me...
Hello,
What does mean that message?
[23:54:43 INFO]: [ImageMaps] Some error occured while placing the ItemFrames. This can for example happen when some existing ItemFrame/Hanging Entity is blocking.
[23:54:43 INFO]: [ImageMaps] Unfortunatly this is caused be the way Minecraft/CraftBukkit handles the spawning of Entities.
And what should i put on the block first of all? First - a frame, then - a map, and next - enter /imagemap ?
Please, give the step-by-step instruction. I got error.
(Spigot, 1.11)
Thank you.
In reply to swordin2:
The plugin will spawn frames and maps by itself, so all your need to do is create a surface large enough for the image. The message should appear when there are already frames at the location(s) you selected.
So
1. Create wall large enough for the image
2. Use /imagemap command to select the image
3. Right click on the top left corner of the wall
Bonjour, j'aimerais savoir s'il serait possible que vous créiez la version 1.12.2. Je ne peux donc pas utiliser celle de 1.13 et j'aimerais avoir une image dans Minecraft mais mon service est fourni dans 1.12.2.So I did not understand how to place the maps and how to resize them. Je vous remercie d'avance.
1.14?
hi can you make the viewing distance longer it vanishes when you back away from it thanks
edit nvm
When a new update comes along, it would be great to be able to block players from placing these maps in WorldGuard/GrievPrevention areas in which they don't have build permission!
pls update love this plugin broke last update they disappear every restart
In reply to jwpwns2:
In reply to SydMontague:
yea sorry bout that was something i had installed
In reply to jwpwnz:
Would you mind to tell me which plugin caused the issue? I'm having the same problem...
this works great! however in 1.13.2 the maps seem to disappear after reboot :(
This doesn't work, for me..
It won't let me place it so i resized my images by 384x384 (divided by 128 is 3x3). There's no entities in the way and i also tried it with a larger thing, still didn't work. Does there need to be item frame on every space?
In reply to meso27_:
when i place a picture i get only one frame every time with nothing in it.
i am using a png file, there is plenty of room on the wall. my picture is sized exactly to increments of 128 pixels. i am using spigot 1.12.2 i am admin. have added permissions. im not sure where to go to from here to fix the issue. i am using the latest version you have imagemaps 0.4.5
In reply to ff87bullwinkle:
In reply to SydMontague: