Download File

## [1.2.8-BETA] - 2025-12-29 ### 🎉 Big Update - Major Improvements & API Migration This release includes significant improvements, API migrations, and enhanced compatibility features. ### Changed - **Update Checker**: Complete migration to CraftingStudio Pro API - ✅ Migrated from SpigotMC Legacy API to CraftingStudio Pro API - ✅ New API endpoint: `https://craftingstudiopro.de/api/plugins/playerdatasync/latest` - ✅ Uses plugin slug (`playerdatasync`) instead of resource ID - ✅ Improved JSON response parsing using Gson library - ✅ Better error handling for HTTP status codes (429 Rate Limit, etc.) - ✅ Enhanced update information with download URLs from API response - 📖 API Documentation: https://www.craftingstudiopro.de/docs/api - **Plugin API Version**: Updated to 1.13 for better modern API support - Minimum required Minecraft version: 1.13 - Still supports versions 1.8-1.21.11 with automatic compatibility handling - Improved NamespacedKey support and modern Material API usage ### Fixed - **Version Compatibility**: Fixed critical GRAY_STAINED_GLASS_PANE compatibility issue - ✅ Prevents fatal error on Minecraft 1.8-1.12 servers - ✅ Automatic version detection and Material selection - ✅ Uses `STAINED_GLASS_PANE` with durability value 7 for older versions (1.8-1.12) - ✅ Uses `GRAY_STAINED_GLASS_PANE` for modern versions (1.13+) - ✅ Filler item in inventory viewer now works correctly across all supported versions - **Inventory Synchronization**: Enhanced inventory sync reliability - ✅ Added `updateInventory()` calls after loading inventory, armor, and offhand - ✅ Improved client synchronization for all inventory types - ✅ Better inventory size validation (normalized to 36 slots for main inventory) - ✅ Improved enderchest size validation (normalized to 27 slots) - ✅ Better armor array normalization (ensures exactly 4 slots) - **ItemStack Validation**: Enhanced ItemStack sanitization and validation - ✅ Improved validation of item amounts (checks against max stack size) - ✅ Better handling of invalid stack sizes (clamps to max instead of removing) - ✅ Improved AIR item filtering - ✅ More robust error handling for corrupted items - **Logging System**: Complete logging overhaul - ✅ Replaced all `System.err.println()` calls with proper Bukkit logger - ✅ Replaced all `printStackTrace()` calls with proper `logger.log()` calls - ✅ Better log levels (WARNING/SEVERE instead of stderr for compatibility issues) - ✅ More consistent error messages across the codebase - ✅ Stack traces now properly logged through plugin logger - ✅ Improved logging for version compatibility issues ### Improved - **Code Quality**: Significant improvements to error handling and resource management - ✅ Comprehensive exception handling with proper stack trace logging - ✅ Better debug logging throughout inventory operations - ✅ Improved client synchronization after inventory changes - ✅ Better resource management and cleanup - ✅ Enhanced error diagnostics throughout the codebase - **Performance**: Optimizations for inventory operations - ✅ Better item validation prevents unnecessary operations - ✅ Improved error recovery mechanisms - ✅ Enhanced memory management ### Technical Details - **API Migration**: Complete rewrite of UpdateChecker class - Old: SpigotMC Legacy API (plain text response) - New: CraftingStudio Pro API (JSON response with Gson parsing) - Improved error handling for network issues and rate limits - **Compatibility**: Maintained support for Minecraft 1.8-1.21.11 - Version-based feature detection and automatic disabling - Graceful degradation for unsupported features on older versions - Comprehensive version compatibility checking at startup ### Breaking Changes ⚠️ **Plugin API Version**: Changed from `1.8` to `1.13` - Plugins compiled with this version require at least Minecraft 1.13 - Server administrators using 1.8-1.12 should continue using previous versions - Automatic legacy conversion may still work, but not guaranteed ### Migration Guide If upgrading from 1.2.6-RELEASE or earlier: 1. No configuration changes required 2. Update checker will now use CraftingStudio Pro API 3. All existing data is compatible 4. Recommended to test on a staging server first