🏷️ AdvancedTags v1.2 — Release Notes

A comprehensive update bringing multi-platform engine compatibility, thread-safe asynchronous operations, critical GUI security fixes, and performance optimizations.

---

🚀 New Platform Support & Architecture

• Spigot & CraftBukkit Support: Shaded and relocated adventure-platform-bukkit to ensure full MiniMessage, RGB, Hex, and Gradient support across native Spigot and CraftBukkit servers without external dependencies.
• Folia & Paper Fork Stability: Implemented an internal universal scheduler abstraction (SchedulerUtils) utilizing reflection and entity-based schedulers to prevent runtime thread-pool exceptions on Folia and multi-threaded environments.
• Soft Dependency Decoupling: Changed PlaceholderAPI dependency from hard to soft (softdepend). The plugin now boots and functions 100% standalone if PAPI is not present.

---

🛡️ GUI & Security Fixes

• Shift-Click Inventory Leak (Dupe Fix): Resolved a critical inventory desync where synchronous closeInventory() calls allowed items to glitch into the player's inventory on shift-click. Inventory actions and closures are now deferred by 1 tick using platform-safe schedulers.
• Drag-Drop Item Loss Prevention: Added an InventoryDragEvent handler to block players from dragging items into the virtual menu, preventing permanent item loss.
• Enforced Event Denial & Resync: Implemented dual event cancellation (setCancelled(true) and setResult(Result.DENY)) accompanied by forced player.updateInventory() calls to prevent visual ghost items.
• Flexible Layouts: Reduced the minimum GUI size constraint (size: 9), fully supporting single-row custom layouts.

---

⚙️ Core Engine & Performance

• Thread-Safe Storage I/O: Added ReentrantLock synchronization to StorageManager.saveSync() to eliminate race conditions and prevent JSON file corruption (0-byte payload) during concurrent tag changes.
• Memory Leak Elimination: Refactored TagManager to implement Listener, pruning expired cooldowns dynamically and automatically clearing cached UUID records on PlayerQuitEvent.
• Wildcard Permission Resolution: Added direct programmatic support for advancedtags.tag.* and advancedtags.admin wildcard evaluations across all inventory interactions.
• Clean Resource Teardown: Added strict lifecycle disposal on onDisable() for Adventure audiences, background thread pools, and update checkers to prevent memory leaks during server reloads.
• Removed Namespace Command Stripping: Removed the global PlayerCommandSendEvent filter to prevent unintended side effects on third-party plugin namespace commands (plugin:command).

---

📦 Developer & Build Details

• Target Version: Compatible with Minecraft 1.20+ (Paper, Purpur, Folia, Spigot, Bukkit).
• Dependencies Shaded: adventure-platform-bukkit, adventure-text-minimessage, adventure-text-serializer-legacy, bstats-bukkit.
• Build System: Apache Maven (Java 17+ bytecode target).