Custom Images

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.



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.



Note that horizontal images are supported in 1.13+

Installation

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.

• /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

<button type="button" class="button bbCodeSpoilerButton ToggleTrigger Tooltip JsOnly" title="Click to reveal or hide spoiler" data-target="> .SpoilerTarget">Spoiler: Scaling Images</button>

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.

• 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 &lt;range&gt; command