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.
Sorry, I am new to plugins, but how do you let people use these commands without giving them OP?
In reply to ABTW32:
use luckperms plugin
Hey Syd, is there any way that a command block could give a map to a player? Such as in CallMeCarson's SMPLive server, where I'm told they use this plugin for custom maps. They have a self-made plugin called "the wacky wheel" where a random outcome was given to a streamer when they were paid by their audience to spin the wheel. Among other things, it gave them some custom maps. How would I do this? (I am trying to build a similar thing to the "wacky wheel" with command blocks).
In reply to castlebear199:
The maps are regular map items, so you can copy and distribute them like any other map. Their plugin probably just saves the map as item and gives out a copy of it.
Hey Syd, I'm trying to learn how to create plugins, one thing that I really don't understand is how to make a plugin that grabs images from the internet, and how you are converting the image pixels to blocks via the plugin. Is the project opensource for me to look at on Github? I really like how you've setup your plugin and I want to learn how to make my own, and yes I will link to this one, giving credit.
In reply to MadDog443:
The plugin source is available under the MIT License here: https://github.com/SydMontague/ImageMaps or via the "Source" button in the header of the project.
In reply to SydMontague:
Thanks, this helps a lot.
how to delete image once its up?
In reply to parkat69g:
Destroy the item frames.
Hi! I'm making a server with minigames and I was wondering if I could possibly download a file from my own device. I have tried converting it to a public link and a data URL link but it just said "find and image link" or "malformmatted URL." If anyone knows how to upload files, please let me know! :) If it is not possible, I might just find one on the web. Thanks!
In reply to polarfalcon2:
Easiest solution would be to access your server via FTP or other means to upload the file directly. Alternatively you can use image hosts like imgur instead.
I download plugin and upload my image in .png...
And the version is 1.7.10 (plugin version too).
And i have a problem:
I don't know why because the image.png is :
In reply to TenUx:
What version of the plugin were you using? Is there any error message somewhere in chat or the server log?
No matter what command I use I just get "[ImageMaps] You cant run this command"
my server is 1.16.4 and uses the most recent version of spigot
the server was made using Aternos
How do I make it so that I stop getting this message?
In reply to krazz0801:
It means you didn't give yourself the permissions or OP necessary for the plugin.
I am in 1.16.3 I keep being told I have a malformatted url. I am trying to get pictures from rogue company. Do I put images into the folder on the server side or do I download the picture from client side, or do I just get the link from online? Because when I do anything it says it is not formatted correctly.
Edit: I think I figured out how to fix it.
I have an error. Is there anybody who can help me?
I use Bukkit 1.16.1 but I also testet it with 1.16.2
[15:09:09 ERROR]: Could not load 'plugins\ImageMaps.jar' in folder 'plugins'[15:09:09 ERROR]: Could not load 'plugins\ImageMaps.jar' in folder 'plugins'org.bukkit.plugin.InvalidPluginException: java.lang.NoClassDefFoundError: net/md_5/bungee/api/chat/BaseComponent at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.java:137) ~[craftbukkit.jar:git-Bukkit-43c7ff9] at org.bukkit.plugin.SimplePluginManager.loadPlugin(SimplePluginManager.java:393) ~[craftbukkit.jar:git-Bukkit-43c7ff9] at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager.java:301) ~[craftbukkit.jar:git-Bukkit-43c7ff9] at org.bukkit.craftbukkit.v1_16_R2.CraftServer.loadPlugins(CraftServer.java:379) ~[craftbukkit.jar:git-Bukkit-43c7ff9] at net.minecraft.server.v1_16_R2.DedicatedServer.init(DedicatedServer.java:180) ~[craftbukkit.jar:git-Bukkit-43c7ff9] at net.minecraft.server.v1_16_R2.MinecraftServer.w(MinecraftServer.java:786) ~[craftbukkit.jar:git-Bukkit-43c7ff9] at net.minecraft.server.v1_16_R2.MinecraftServer.lambda$0(MinecraftServer.java:155) ~[craftbukkit.jar:git-Bukkit-43c7ff9] at java.lang.Thread.run(Unknown Source) [?:1.8.0_201]Caused by: java.lang.NoClassDefFoundError: net/md_5/bungee/api/chat/BaseComponent at java.lang.Class.forName0(Native Method) ~[?:1.8.0_201] at java.lang.Class.forName(Unknown Source) ~[?:1.8.0_201] at org.bukkit.plugin.java.PluginClassLoader.<init>(PluginClassLoader.java:64) ~[craftbukkit.jar:git-Bukkit-43c7ff9] at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.java:133) ~[craftbukkit.jar:git-Bukkit-43c7ff9] ... 7 moreCaused by: java.lang.ClassNotFoundException: net.md_5.bungee.api.chat.BaseComponent at java.net.URLClassLoader.findClass(Unknown Source) ~[?:1.8.0_201] at org.bukkit.plugin.java.PluginClassLoader.findClass(PluginClassLoader.java:167) ~[craftbukkit.jar:git-Bukkit-43c7ff9] at org.bukkit.plugin.java.PluginClassLoader.findClass(PluginClassLoader.java:96) ~[craftbukkit.jar:git-Bukkit-43c7ff9] at java.lang.ClassLoader.loadClass(Unknown Source) ~[?:1.8.0_201] at java.lang.ClassLoader.loadClass(Unknown Source) ~[?:1.8.0_201] at java.lang.Class.forName0(Native Method) ~[?:1.8.0_201] at java.lang.Class.forName(Unknown Source) ~[?:1.8.0_201] at org.bukkit.plugin.java.PluginClassLoader.<init>(PluginClassLoader.java:64) ~[craftbukkit.jar:git-Bukkit-43c7ff9] at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.java:133) ~[craftbukkit.jar:git-Bukkit-43c7ff9] ... 7 more
In reply to Forge_User_69524661:
You're using CraftBukkit but you must use Spigot, since it contains some necessary API additions.
In reply to SydMontague:
ohh! Ok. now i use the beta version of imagesmaps and it goes very well.
In reply to Forge_User_69524661:
The beta version is heavily outdated and wont be supported anymore, it's not recommended for anything buy legacy versions of Minecraft (<1.13).
I strongly recommend using Spigot instead, since it's the primary Bukkit implementation nowadays, with BuildTools not even exposing CraftBukkit to the user anymore.