[1.2.4-SNAPSHOT] - 2025-12-29

[HR][/HR]

➕ Added

Extended Version Support: Full compatibility with Minecraft 1.8 to 1.21.11

• Comprehensive version detection and compatibility checking
• Maven build profiles for all major Minecraft versions (1.8, 1.9–1.16, 1.17, 1.18–1.20, 1.21+)
• Automatic feature detection and disabling based on server version
• VersionCompatibility utility class for runtime version checks

Project Structure Reorganization: Complete package restructuring

• Organized code into logical packages:
  
  core, database, integration, listeners, managers, utils, commands, api​
• Improved code maintainability and readability
• All imports and package declarations updated

Version-Based Feature Management: Automatic feature disabling

• Offhand sync disabled on 1.8 (requires 1.9+)
• Attribute sync disabled on 1.8 (requires 1.9+)
• Advancement sync disabled on 1.8–1.11 (requires 1.12+)
• All features validated during plugin initialization

[HR][/HR]

Fixed

Issue #43 – Experience Synchronization Error

• Switched from reset + giveExp() to setTotalExperience()
• Validation for negative experience values
• More reliable experience restoration across versions

Issue #42 – Vault Reset on Server Restart

• Economy integration reconfigured during shutdown
• Balance restoration with 5-tick delay and retry system
• Improved Vault provider availability checks

Issue #41 – Potion Effects Restored After Death

• Effects only restored if player is alive
• Death and respawn state validation added
• Potion effects properly cleared on death

Issue #40 – Heartbeat HTTP 500 Errors

• Improved HTTP error handling and logging
• Specific messages for 400, 401, 404, 500+ status codes
• Connection and socket timeout handling
• More detailed API debugging output

[HR][/HR]

Changed

Minecraft Version Support

• Extended support from 1.20.4–1.21.9 to 1.8–1.21.11
• Default Java version set to Java 8
• Java build profiles: 8, 16, 17, 21
• Plugin API version set to 1.8

Build System

• Maven compiler now uses variable-based source/target versions
• Multiple Minecraft & Java version profiles
• Correct Java handling per Minecraft version

Code Organization

• core/ – Main plugin class (PlayerDataSync)
• database/ – Database handling (DatabaseManager, ConnectionPool)
• integration/ – Plugin integrations
• listeners/ – Event listeners
• managers/ – Feature managers
• utils/ – Utility & compatibility helpers
• commands/ – Command handlers
• api/ – API & update checker

Version Compatibility Checking

• Detects Minecraft versions from 1.8 to 1.21.11
• Logs enabled/disabled features on startup
• Warnings for unsupported versions
• Critical API methods tested with version guards

[HR][/HR]

⚙ Technical Details

Build Profiles

• mvn package -Pmc-1.8 – Minecraft 1.8 (Java 8)
• mvn package -Pmc-1.9 to -Pmc-1.16 – Minecraft 1.9–1.16 (Java 8)
• mvn package -Pmc-1.17 – Minecraft 1.17 (Java 16)
• mvn package -Pmc-1.18 to -Pmc-1.20 – Minecraft 1.18–1.20 (Java 17)
• mvn package -Pmc-1.21 – Minecraft 1.21+ (Java 21, default)

Code Quality & Stability

• Improved error handling and recovery
• Better resource cleanup and memory management
• More precise exception messages

[HR][/HR]

✅ Compatibility

• Minecraft 1.8 – Full support (some features disabled)
• Minecraft 1.9–1.11 – Full support (advancements disabled)
• Minecraft 1.12–1.16 – Full support
• Minecraft 1.17 – Full support
• Minecraft 1.18–1.20 – Full support
• Minecraft 1.21–1.21.11 – Full support