MC Data Bridge - Release Notes (v2.1.5)

Overview

Version 2.1.5 is a stability patch focused on maintaining compatibility with the bleeding-edge Paper 26.1 API (Minecraft 1.21.4+). This release addresses a specific serialization issue with modern Adventure text objects and optimizes the plugin's internal dependency structure.

Changes & Fixes

🧩 Adventure Text Serialization Patch

• Resolved a NoClassDefFoundError and serialization failure affecting niche Adventure text components, specifically those used in modern Player Head metadata.
• Aligned internal dependencies with Adventure v4.26.1 to support the latest Minecraft 1.21.4 features.

🚀 Modern API & Build Stability

• Paper 26.1 Support: Officially verified compatibility with the latest Paper alpha builds.
• Dependency Optimization: Transitioned Adventure libraries to provided scope, maintaining a lightweight JAR (~3.0M) while ensuring native performance on Paper/Velocity.

---

For installation instructions and configuration details, please refer to the README.md and config.yml.

Refactor: Modernize for Java 25 & Fix Velocity Proxy Deadlocks (v2.1.3)

📝 Description

This PR focuses on updating the core infrastructure to align with the bleeding-edge Minecraft 26.1.2 / Java 25 ecosystem. It also contains a critical fix for a cross-server data deadlock issue that occurred when switching servers on our proxy network.

🐛 Bug Fixes

• Velocity Server Switch Deadlocks: Resolved a critical cross-server data lock issue where the proxy failed to gracefully intercept server transfers and release player SQL locks prior to routing.
• Annotation Processor Mitigation: The root cause of the proxy deadlock was traced back to our Java 25 / Maven Annotation Processors suppressing proxy integration endpoints during compilation. By explicitly passing the @Plugin Velocity API annotation directly into the compiler arguments array, we've successfully recovered the generation of the velocity-plugin.json initialization file. The proxy component now initializes and intercepts transfers cleanly.
• Structural Null Safety: Resolved BungeeCord and Velocity ByteArrayDataOutput.writeUTF structural inference problems around UUID String boundaries to ensure strict conformance to Guava expectations.

🚀 Modernization & Technical Debt

• API Standardization:
  • Updated paper-api to 26.1.2.build.7-alpha.
  • Updated velocity-api to 3.5.0-SNAPSHOT (Build #592).
  • Updated item-nbt-api to 2.15.7.
  • Updated testing dependencies (mockito) to 5.23.0.
• Legacy Refactors:
  • Migrated health sync properties to utilize Attribute.MAX_HEALTH, fully deprecating the legacy GENERIC_ prefix requirements targeting modern APIs.
  • Restructured PlayerQuitEvent logic in our flow suites to adopt modern Component adventure text system, erasing legacy string deprecations natively.
  • Upgraded internal plugin message events to correctly route their legacy event parameters, accommodating proxy-transfer flags natively.

🛡 Zero-Suppression Defensive Null Safety

• Phased out @SuppressWarnings for null validation loops across the entire bridge logic constraint map, replacing them with mechanically enforced java.util.Objects.requireNonNull validation layers cleanly.
• Safely rewired ambiguous core Bukkit states (getLocation, advancementIterator, getCommand) to aggressively trap and seal implicit analyzer NPE leakages directly inside the event pipeline.

🏗 Build Pipeline Adjustments

• Upgraded compiler compliance matrix to strictly target Java 25 (<release>25</release>).
• Bumped maven-shade-plugin natively to 3.6.2, and injected cutting-edge org.ow2.asm 9.9.1 dependencies to successfully resolve shade failures against Java 25's new major bytecode signatures.

🧪 Testing & Verification

• Verified compilation integrity on Java 25.
• Live tested on proxy environment (Velocity 3.5.0 handling two PaperMC 26.1.2 instances).
• Tested rapid server hopping back-and-forth between instances.
• Verified perfect synchronization across Health, Inventory, and complex NBT data during immediate server switches with zero proxy timeouts or deadlocks.

Release Notes - v2.1.2

MC Data Bridge v2.1.2 - Maintenance & Dependency Update

This release focuses on updating core dependencies and resolving build-time compatibility issues.

---

🔧 Maintenance

• Dependency Updates:
  • Updated MockBukkit to 3.133.2.
  • Updated paper-api to 1.21.1-R0.1-SNAPSHOT (Fixed compatibility issues with newer MockBukkit).
  • Updated mysql-connector-j to 9.6.0.
  • Updated mockito to 5.14.2.

---

Release Notes - v2.1.1

MC Data Bridge v2.1.1 - Critical Bug Fix & Stability Update

This patch release addresses a critical issue reported where players with boosted health (e.g., via Health Boost potion effects or attributes) were being kicked upon switching servers.

---

🐛 Bug Fixes

• Fixed Kick on Server Switch with High Health: Resolved an issue where players with health greater than 20.0 (Health Boost) would be kicked with an IllegalArgumentException. The plugin now safely handles this by loading potions and attributes from the database before setting the max health attribute.

Release Notes - v2.1.0

MC Data Bridge v2.1.0 - Official Minecraft 1.21.11 Support | Secure MySQL Player Data Synchronization

• Now fully compatible with Minecraft 1.21.11. Securely syncs all player data (inventory, health, XP, hunger) using robust MySQL locking across your BungeeCord or Velocity network.

---

Deploy this JAR to all your PaperMC and Spigot servers, connecting to the corresponding proxy plugin (BungeeCord or Velocity) and a centralized MySQL database.

####⭐ What's New in v2.1.0* Minecraft 1.21.11 Compatibility: Full support for the latest Minecraft 1.21.11 release. This ensures all player data structures, including any new or updated serialization components introduced in the latest version, are correctly captured and applied without errors.

####🚀 Core Features & Stability* Complete Player Data Synchronization: Securely saves and loads all essential player attributes across your network, including:

• Inventory and Armor

• Health and Max Health

• Experience Level and Progress

• Full Hunger Attributes: Food Level, Saturation, and Exhaustion.

• Potion Effects

• Ender Chest, Advancements, and Statistics (configurable).

• Robust Data Integrity (MySQL Locking): Employs a server-ID-based database locking mechanism to prevent race conditions and data corruption when players switch servers quickly or disconnect abruptly.

• Lag-Free Performance: All database operations (lock acquisition, save, and load) are performed asynchronously off the main server thread to prevent server lag.

• Admin Utility: Use the /databridge unlock <player> command to manually clear player data locks if a connection is unexpectedly terminated.