PixelPaste

PixelPaste: Beta Release — The Efficient Image-to-Block Plugin for Minecraft Servers

Video Demo

Note: The video is outdated; animation, speed, and rendering have been significantly improved in the latest version. Please be aware that this plugin is still in its beta stage—your feedback is crucial!

Overview
PixelPaste is a solo-developed, exceptionally lightweight (only 8KB and committed to remaining under 10KB) plugin designed to transmute any image into Minecraft blocks with surgical accuracy—all while maintaining optimal server performance.

Features
General Features

• Highly Efficient: Occupies only 8KB of disk space, with a promise to never exceed 10KB.
• Pixel-Perfect: Ensures high-fidelity image conversions.
• Scalability: Automatically resizes larger images without compromising the aspect ratio.

Technical Highlights

• Optimized Algorithms: Incorporates specialized Greatest Common Divisor (GCD) techniques for superior block placement.
• Resource Management: Utilizes fine-grained task scheduling and adaptive timing strategies during block placement operations to minimize server load.

What's New in Version 2.1

• 3D Capabilities: Step up your pixel art game with 3D rendering.
• Orientation Flexibility: Choose from vertical or horizontal orientations.
• Depth Through Darkness: Adds a touch of realism through depth shading in 3D conversions.

• Changed Code Flow: The underlying code has been restructured for more efficient operation and ease of future updates.
  
  
• New Optional Arguments: max_dims and max_depth arguments added for 3D image conversions.
  
  
• ️ Revised Commands:
  • Use /p2d filename.(png, jpg) for 2D images.
  • Use /p3d filename.(png,jpg) (vert/horz) (max_dimension_size) (max_depth_size) for 3D images.
• Confirmation & Highlighting: Before the build starts, a glass pane will outline the area it will occupy. You can choose to cancel or proceed, and if canceled, the space reverts to its original blocks.
  
  
• AI Module in Progress: Work has begun on an AI feature to generate images based on text descriptions. (Won't be available for at least 2 updates)

Installation

1. Download from spigot or build from the repository.
2. Place the file in your server's plugin directory.
3. Reboot your server.

Usage

1. The plugin auto-generates a folder 'pixelpaste' in the plugin's data folder.
   
   
2. Place your PNG or JPG images in the folder
   
   
3. Commands:
   • Use /p2d filename.(png, jpg) for 2D images.
   • Use /p3d filename.(png,jpg) (vert/horz) (max_dimension_size) (max_depth_size) for 3D images.

Note: If you encounter issues with tab completion, consider rebooting your server.

Your constructive feedback is vital, given that this project is still in beta.

Commendable Code Features

• The use of efficient algorithms not only offers high image accuracy but also maximizes resource optimization.
• Fine-grained task scheduling and adaptive timing strategies during block placement ensure that the plugin maintains low server overhead.

PixelPaste remains 100% open source and free to use forever. Your Minecraft creativity awaits!