Custom Images 2.2.4

Load custom images into Minecraft

  1. Andavin
    Native Minecraft Version:
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    • 1.15
    • 1.16
    • 1.17
    • 1.18
    Source Code:
    The title says it all. I decided randomly to make a plugin that could load custom images into Minecraft since I didn't see anything similar readily available. This started off as a fling project that took me about a day to write, but seems to have gained a good amount of popularity.

    Therefore, I have rewritten it from the ground up to have native support of all 1.8+ Minecraft versions and use packet based entities for an entirely new experience.

    Basic Information
    You can load any image doesn't matter the size (within reason), however, it should be kept in mind that all blocks are 128x128 pixels. So, if your image is massive then it may take a lot of blocks to display and may also lag the client.

    On that note, images are rendered better if they are in increments of 128 pixels, but it doesn't make too much of a difference since it is resized in the background to fit regardless. These images below are examples of random images that I loaded into the game to be displayed.

    Any image format that Java can support is also supported.
    However, types other than PNG or JPG/JPEG may not be displayed in the list command.

    Basic Example.png

    To add an image without clicking a block, hold an item in your hand when creating the image and right click anywhere in the air; the image will be placed in front of you.

    Horizontal Example.png

    Note that horizontal images are supported in 1.13+

    1. Download images-2.x.x.jar and place it in your plugins folder.
    2. Start your server to load the plugin and then stop the server.
    3. Open the config.yml found in the Images folder and configure the desired database (see spoiler for more information).
    4. Place any images in the Images folder.
    5. Start your server and start placing your images.
    Three types of database are supported:
    • SQLite (Default)
      • If you don't have a dedicated database or don't know how to configure databases, this is the option for you. This is the default so just leave it as is.
    • MySQL
      • If you already have a MySQL database and wish to have CustomImages use that, then this can be set by setting the type to MYSQL in the config and add the login credential for your MySQL server.
      • (Advanced Users) If access to table creation permissions for the Custom Images MySQL user is an issue, set the database.initialize setting to false in the config and contact me for table information if needed.
    • Raw data file
      • This is a simple completely raw byte file that is written to. It is much slower than the other two options, but is slightly more space efficient since it does not have the overhead of table structures etc. This is not applicable to almost anyone, but if you are really tight on drive space you can use this format.

    • /image create <image name|url> [scale percent] - Create and begin pasting a new custom image
    • /image delete - Delete an existing image by clicking on it
    • /image delete near <range> - Delete images within a range
    • /image list - Show a list of the options of images that can be added
    • /image import - Import legacy images to the new format
    • /image transfer - Transfer images to a new database

    Tabbing is supported so you can easily see all your file options by typing /image create and then tab.

    You can scale an image while creating it by adding a percentage after the image name.
    Code (Text):
    /image create myImage.png 200
    the above command would create an image scaled to 200% of the original image size. Any percentage is acceptable as long as it is greater than 0.

    Scaling Example.png

    • images.command.create
    • images.command.delete
    • images.command.delete.near
    • images.command.list
    • images.command.import
    • images.command.transfer

    • If you are having issues deleting images:
      • Right click the image in multiple places and in the center of blocks
      • Ensure you are on the same version of Minecraft on your client as your server (i.e. Spigot 1.14.4 try using 1.14.4 for your client too if not already).
      • Install ProtocolLib (this may or may not improve things)
      • Use the /delete near <range> command
    • If there is an error in console that contains the line below, this means you have deleted a world without first removing all the images. Recreate the world and delete all of the images (I recommend using the /delete near <range> command) before removing it
      Code (Text):
      java.lang.IllegalStateException: unknown world with ID deletedWorldName
    • If there is an error in console that contains and of the lines below, you most likely have an issue with your version of Java; update to at least Java 8 and either Oracle or OpenJDK. Java 11 can also have issues; I would recommend trying a JDK version if no other solution works.
      Code (Text):
      java.awt.AWTError: Assistive Technology not found: org.GNOME.Accessibility.AtkWrapper
      Code (Text):
      java.lang.NoClassDefFoundError: Could not initialize class sun.awt.X11.XToolkit
    • Please ensure that you are always on the most up-to-date minor version of each major version of Spigot or Paper. For example, if you are running 1.13 you should be running 1.13.2; for 1.8 it should be 1.8.8
    • I will attempt to give more tips here as more things become relevant
    Report an Issue

    Note: Please do not write a review in order to get help or report a bug. I will not help in this way. Write a discussion post or message me directly and I will help as quickly as possible.
    1. Make sure to read this entire post thoroughly especially the above troubleshooting and commands section before deciding that you have an issue and it is not user error.
    2. If you do have a bug, check the server console for errors after running a command that is having an issue or on server startup. An error may be many lines and is usually indented and/or red. This is very helpful in fixing issues.
    3. Write a discussion post or message me directly clearly describing your issue and giving relevant screenshots and any errors that you found.
    4. I will help as soon as I have time; I promise I'm not ignoring anything on purpose.

    If you wish to donate to support development, you may use the link below to do so. Anything is appreciated :)


Recent Updates

  1. 1.18.1 Support
  2. 1.17+ Bug Fixes
  3. Update to 1.17.1

Recent Reviews

  1. tacopoop
    Version: 2.2.4
    Great plugin, works as expected and brings an awesome future to the game. However, I wish that there were separate permissions for being able to create an image from the images already hosted on my server, and being able to create an image from an URL. That way, I could allow players to create images from pre-selected/pre-screened and safe images on our server, but keep them from posting potentially inappropriate/dangerous pictures on the server. I hope the author considers please implementing this!
  2. Ronal99
    Version: 2.2.4
    i have no idea how to use it, any information pls? I will really be thankful for that info
  3. Alcerious
    Version: 2.2.4
    Woooot 1.18.1 is here fantastic work. A giant map of spawn greets my players at spawn people love it. So easy to work with too.
  4. ShadowSkull20
    Version: 2.2.4
    This plugin is simply awesome. It works exactly as expected, I got no complaints here :)
  5. daniealth
    Version: 2.2.4
    Super Plugin, du bekommst jedes beliebige Bild auf deinen Server. Fake-Wände, Spielanleitungen die in Photoshop gefertig twurden, Graffitis an Wänden, Himmen-und-Hölle Hüpfspiel auf der Straße, ich habe alles mögliche mit diesem Plugin umsetzen können.
  6. TheHooper
    Version: 2.2.3
    Please update this plugin to 1.18, i need it because its awesome plugin i using only your plugin for this.
  7. _SHO_
    Version: 2.2.3
    Please update the plugin to the new version 1.18
    Thanks for such a great plugin!
    Version: 2.2.3
    Great plugin!
    However, can you add that the gif works.

    If you add gif support ...
  9. Phantom6422
    Version: 2.2.3
    Its working great but can you add so we can download the image from internet? its kinda difficult for me to transfer the image to my home hosting server (sorry for my bad English)
    1. Andavin
      Author's Response
      This is already supported. Please read the main post.
      TL;DR /image create <url>
  10. zabir
    Version: 2.2.3
    Its gud and its works very find. but when i try to use the delete command
    It doesnt delete the image, please help!