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.
Hello, what does <filename> represent?
In reply to dovebodywash123:
The name of the image file you want to use.
In reply to SydMontague:
so for example would it be like
/imagemap <xyz.png> ???
In reply to dovebodywash123:
Yes, just without <> around the file name, I used them to signify that they get replaced with a mandatory variable.
Sorry, is there a command to delete ImageMaps (not the whole plugin, just individual image saves)? Such as, when I'm going to place one of the images, it shows a list of the current images I have available by name, and the list can get pretty long and requires some data for images I no longer even use. Is there a command to delete some of these image saves or do I have to just do it via the plugin files? I mean I CAN just do it in the files, it's just I think I have to restart the server if I wanna apply changes from the files directly is all. If there's a delete file command I can run in-game then I wouldn't have to restart.
In reply to 3dkaii:
The list of images is populated by the files in the plugin's images folder. If you remove them from there they won't show up in the command anymore, without a restart required.
How do I add the "imagemap.use" permission to players?
In reply to Forge_User_67215299:
Either use one of the plugins used to manage permissions for players or manually enable it using Bukkit's permissions.yml
great pluginn, no probles for me :)
When I load an image, it renders, finishes rendering, then nothing happens, no maps appear. Help appreciated!
How do you get maps that you put in the imagemap folder it only works with urls.
In reply to dyty:
Use the
command. You can use tab-complete to find/list all the images in the plugin's image folder.
Hey is there a way to make it so that you get the map without the item frame?
In reply to agudchristianboy:
No, but you can take the maps out of the item frames after it got placed.
Hi, im currently running a 1.14.4 spigot server. The plugin seems to be working as he should be until im supposed to right click on a upper left corner. I tried right clicking both with no items and items in my hand but it just doesnt work. I made sure the area is big enough too (there are no item frames nor maps on the wall) . I also tried deleting and installing the plugin multiple times but that didnt work as well. Is there something im doing wrong?
In reply to Forge_User_59971501:
Do you get any message from the plugin, either in chat or the server log? It should say something somewhere.
In reply to SydMontague:
I checked the console log and everything seems fine, at the beginning the plugin loads and enables as it should, but when i do /imagemap <name>.jpg then it doesnt do anything and it doesnt say anything in the console as well.
In reply to Forge_User_59971501:
Does the /imagemap command itself at least give you some message? There should be a message somewhere...
In reply to SydMontague:
When i do /imagemap <name>.jpg it says the scale of the image and right click on a upper left corner. After right clicking nothing happens neither in the console nor in the world.
In reply to Forge_User_59971501:
Are there entries in the plugin's maps.yml? What Server version are you using? Have you tried to check whether any of the other plugins you use creates a conflict?