Update 1.2.8

[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