Image To Painting v1.4.0

Minecraft Compatibility

• Added support for Minecraft Java Edition 26.3.

• Updated compatibility with Paper and Purpur 26.3.

• Preserved compatibility with Paper 26.2.

• Updated and verified support for Java 25.

• Adapted map handling for Minecraft 26.3's changes.

• Preserved compatibility with existing paintings, configurations, and map IDs.

New Features

Physical Item Payments

• Added an optional payment system using Minecraft items instead of virtual currency.

• Server owners can configure the required item type and quantity.

• Works without Vault or an economy plugin.

• Includes inventory validation and payment refund handling.

• Existing Vault payments remain supported.

• Item payments are disabled by default.

Improved Automatic Update Checker

• Automatically checks SpigotMC for newly published versions.

• Notifies players when a new update is available.

• Added clickable download links directly in Minecraft chat.

• Added configurable notification audiences: all players, administrators, or disabled.

• Added periodic update checks without requiring a server restart.

• Prevents duplicate notifications and unnecessary update requests.

• Improved handling of network failures and unavailable update services.

Rendering Improvements

• Improved FIT mode to select map dimensions that better preserve the original image's aspect ratio.

• Reduced unnecessary empty space when rendering images into map grids.

• FIT now avoids unwanted image cropping.

• Preserved FILL mode for creating paintings that completely fill the requested dimensions.

• Improved consistency when processing portrait, landscape, and square images.

• Preserved existing image quality presets and rendering algorithms.

Placement and Item Frame Fixes

• Improved automatic detection of item-frame grids.

• Fixed ambiguous item-frame selection when multiple frames are nearby.

• Improved handling of large paintings, including 8×12 and 16×16 mosaics.

• Improved detection of missing, duplicate, incorrectly facing, or obstructed frames.

• Verified correct map ordering and orientation across supported placement directions.

• Improved wall placement and free-standing air placement reliability.

• Improved handling of incomplete item-frame grids.

• Preserved automatic painting placement and frame creation.

Bug Fixes

• Fixed valid map ID 0 being incorrectly rejected.

• Fixed a race condition that could allow overlapping rendering or rebuilding operations.

• Improved cleanup when rendering is interrupted or the plugin is disabled.

• Improved handling of player disconnections during asynchronous rendering.

• Improved inventory overflow handling to prevent lost or duplicated map items.

• Improved map persistence and reconstruction after server restarts.

• Preserved legacy numeric painting IDs.

• Fixed unsafe handling of malformed render registry files to prevent accidental data loss.

• Improved validation of local image files and remote image responses.

• Improved handling of payment failures and refunds.

Configuration and Data Improvements

• Improved automatic migration of older configuration files.

• Preserves existing customized settings wherever possible.

• Improved detection and migration of deprecated configuration keys.

• Prevents repeated migration warnings on subsequent restarts.

• Improved backup and recovery behavior during configuration migration.

• Preserved existing painting definitions and persistent map references.

• Improved protection against malformed or corrupted registry data.

Commands and Quality of Life

• Cleaned up the in-game help menu.

• Improved command descriptions and argument explanations.

• Clarified image URL and local-file usage.

• Improved error handling for unsupported image links and invalid files.

• Preserved existing painting management commands.

• Preserved full-painting, row, and column map retrieval.

• Improved permission handling and documentation.

Performance and Stability

• Preserved asynchronous image downloading and processing.

• Improved render-task lifecycle management.

• Reduced unnecessary update-checker requests.

• Improved handling of interrupted rendering operations.

• Improved server shutdown cleanup.

• Added additional regression testing for large paintings, map persistence, inventory handling, and economy transactions.

Important Notes

Image URLs: The /itp render command requires a direct image URL. Links to ordinary webpages, product listings, or image-hosting preview pages may not work. Use a direct PNG, JPEG, or other supported image response.

Existing Paintings: Existing saved paintings and configurations are intended to migrate automatically. Backing up your plugin data before updating is recommended.

Economy: Physical item payments are optional and disabled by default. Existing Vault-based economy configurations remain supported.

Requirements: Minecraft Java 26.3, Paper/Purpur 26.3, and Java 25. Paper 26.2 compatibility was also tested.