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.