ParticlePictures [1.8 - 1.16.1] | 1.16 Support!

Have you ever wanted to create a picture, image, or logo in Minecraft, but found that blocks didn't fit your needs? Don't like the color, size, and angle limitations of map-based image plugins? Want your picture to pop out to players? Then you should consider ParticlePictures!

ParticlePictures is a plugin that allows for the creation of images in Minecraft. Unlike other plugins, which use maps and item frames to display images in-game, ParticlePictures uses particles to make your image come to life.



__________________________________________________




While some existing plugins use single-color particles to allow display images or make see-through pictures with spaced-out particles, ParticlePictures puts complete control of the image into your hands! Every single aspect of the picture is modifiable via commands in-game, in real-time. Here's a list of all of the available modifiable values for each image:

• Image file:You can change which image file each in-game picture reads from on the fly, and this supports most standard image types (I.E. PNG's, JPG's, and even GIFs). All image files can just be placed in the plugin's folder (The folder with the config, for those unfamiliar).
  
  
• Image location:This is fairly self-explanatory, supporting up to 1/100 of block adjustments in all directions to allow for complete placement control.
  
  
• Image rotation (on / off):All images also come with a togglable rotation feature that spins the image around automatically in a seamless loop.
  
  
• Image rotation rate:Allows speed control of the image rotation. As a note, higher refresh rates are usually needed if you want to spin the image faster (otherwise it looks jerky if you are trying to spin it too quickly without a proper refresh rate).
  
  
• Image refresh rate:How many ticks before the image are refreshed. This allows you to control how substantial your image is, at the cost of creating a higher server load for larger images.
  
  
• Image angle:For stationary images, this allows 360-degree rotation control.
  
  
• Image scale:Controls the spacing between each particle (a pixel of the image). Setting this lower will make a more dense image, setting it higher can create a larger image from the same-sized file, at the cost of making the image appear less solid.
  

• /pp -The core command of the plugin, an abbreviation of/ParticlePictures. This command lists basic command usage.
  
  
• /pp create <fileName> -The command used to create a new particle image.
  
  
• /pp edit -Lists the edit instructions and commands for the nearest image.
  
  
• /pp defaults-Lists the default values, in case you want to know what a standard image's values are for each modifiable setting.
  
  
• /pp delete -Deletes the nearest particle image
  
  
• /pp reload -Reloads ParticlePictures. This command isn't needed when editing images, as the images will automatically update themselves in real time. Use this if you need ParticlePictures to re-read an image file (for example, if you've modified an image that you're currently displaying), or to update config values (if you decide to manually edit an image's values via the config instead of in-game).
  
  
• /pp files -Lists all of the available non-yml (config) files in the plugin folder. This is particularly useful if you can't remember what the names of your images are, or if you just want to see what you have available to use.
  
  
• /pp list -Lists all images in your current world, as well as their coordinates. This is another helpful tool if you can't remember where you put a particle image, or want to find out what images you are currently using.
  

There's all of the information that you need to get started! Now for the fun part, example images!










Here's some 3D Schematics (Please note that due to WorldEdit API changes, schematics may be non-functional on newer versions):

A few islands I found in the world


A second island


A ship model


A hot air balloon

Here's a demonstration of a rotating 3D Schematic:
Link:Schematic Rotation Example

Here is a demonstration of the rotation function. I apologize for the jerky image, a gif doesn't properly demonstrate the smoothness of the rotation, especially since my computer had trouble recording it while rendering the image.
(Gifs do not properly embed for some reason)
Link:Rotation Example

Here is a gif displaying an in-game gif (again, apologies for the lag, my computer was hard-pressed to record these while running the game and server process.

Link:Gif Example

Another gif example, see if you can figure out what this one's from:

Link:Mystery Example



Thanks to the folks at TestPlugins.com, we now have a location where you can see an example of the plugin in action!

Please note that large images are not recommended for use with this plugin!The plugin is designed to support a variety of image sizes and types, but images should be used in relatively small numbers per area and using small pixel sizes. 32 x 32 images should run fine no matter how weak your server is. 64 x 64 should run fine on any dedicated server, or test server runs on a decent computer. Anything larger than this may cause server lag depending on your server build.I am not liable for lag issues caused by larger images (images exceeding 32 x 32 pixels), having multiple images in the same area, or having rapid refresh rates!Odds are, most servers can handle larger images in moderation, but TPS drops should be expected if you try to run your 17 logos in a 50 block radius of each other on a refresh rate of 1

Just released a new update to improve efficiency with a lookup table system for some of the calculations! TPS drops have been minimized for static images, and if I get reports that this has a positive impact, I'll implement it for GIFs as well!!!

Thankssssssssssssss alot for this plugin <3