BalloonEnvoy | Pop balloons for loot v0.0.7-STABLEVERSION

# Changelog

## 0.0.7 - 2026-06-12

### Compatibility

• Added Spigot/Paper compatibility from Minecraft 1.8.8 through 1.21.6+.
• Added cross-version handling for particles, sounds, titles, action bars and materials.
• Added legacy action bar packet support for Minecraft 1.8.
• Added modern main-hand and off-hand interaction support.
• Compiled against the oldest supported Spigot API and validated against Spigot 1.21.6.

### Fixed

• Fixed startup failures caused by missing Particle and EquipmentSlot classes on old servers.
• Fixed removed legacy material constants causing errors on modern servers.
• Fixed legacy sound compatibility.
• Fixed start items consuming the wrong hand item on modern servers.
• Removed duplicate and inconsistent start-item event handling.
• Unified start-item permission, cooldown and region validation behavior.
• Fixed missing SQLite and MySQL drivers in the release JAR.

### Build

• Added Maven Shade packaging for database drivers.
• Added service resource merging for JDBC driver discovery.
• Updated MySQL Connector/J Maven coordinates.

Temporarily disabled due to license key server updates and database updates.

BalloonEnvoy — Update & Bugfix Changelog

Version: 0.0.5
Compatibility: Spigot / Paper 1.12 – 1.21.11

🛠 Bug Fixes​

• Fixed leash / rope detaching issue on 1.20+ / 1.21
  Resolved a critical problem where balloon ropes (leashes) randomly detached, respawned, or “bounced off” when balloons were too high or far from the fence.
• Stable rope system reworked
  Replaced unstable leash-hitch behavior with a dedicated, invisible leashable entity anchored to the fence and leashed directly to the balloon. This prevents all random leash drops.
• Fence alignment fix
  The rope is now placed exactly on the fence block center instead of spawning next to it or offset.
• Chunk safety improvements
  Ensured both balloon and fence chunks are force-loaded before spawning rope entities, preventing despawn/desync issues on distant locations.
• High-altitude stability fix
  Ropes now remain attached even when balloons spawn very high or when max-search-down is set to large values (e.g. 100+).
• Removed legacy leash-hitch dependency
  LeashHitch entities are no longer required, avoiding Paper-specific leash bugs.

Improvements​

• New /balloonenvoy remove <region> command
  Allows admins to permanently delete an envoy region from the database.
• Improved rope maintenance logic
  Rope entities are no longer teleported aggressively, reducing visual glitches and physics conflicts.
• Better cross-version support
  All leash, AI, collision, and persistence handling is now fully reflection-safe from 1.12 up to 1.21.11.
• Cleaner entity lifecycle
  Rope entities and fences are properly cleaned up when balloons despawn or events end.
• More reliable region-based spawning
  Improved fence search and ground detection logic for large vertical distances.

Notes​

• This update focuses heavily on modern-version stability (1.20–1.21) while remaining fully compatible with legacy servers.
• No configuration changes are required, but higher max-search-down values are now fully supported and safe to use.

BalloonEnvoy – Update Changelog (Paper 1.21.8 Hotfix)​

This update focuses on stability, hit detection, and full Paper compatibility, addressing multiple issues reported by users on modern Paper servers.

Fixed​

• Balloon hit detection
  • Fixed arrows bouncing off balloons without dealing damage.
  • Added ProjectileHitEvent fallback for Paper cases where EntityDamageEvent is not fired.
  • Rope-intercepted arrows are now correctly counted as balloon hits if close enough.
• Rope / Leash stability
  • Fixed leashes randomly detaching or “falling off” the balloon.
  • Reworked rope system to prefer LeashHitch (knot) on modern Paper versions.
  • Added automatic rope re-attachment task to prevent Paper from dropping invalid leash holders.
• ArmorStand & Bat edge cases
  • Rope entities are now fully protected from damage.
  • Balloons and rope entities survive chunk reloads using metadata + scoreboard tag fallback.
  • Fixed cases where ArmorStand interaction could bypass hit logic.

Improved​

• Paper 1.21.8 compatibility
  • Fully tested and hardened for Paper 1.21.8 behavior changes.
  • Safe reflection-based fallbacks for older Spigot/Paper versions (1.12–1.21).
• Hit accuracy
  • Improved distance-based detection when rope entities intercept projectiles.
  • Reduced false negatives when shooting balloons at high speed or angles.
• Performance & safety
  • All entity checks are null-safe and version-safe.
  • Rope maintenance runs efficiently at configurable intervals.

Technical changes​

• Added scoreboard tags:
  • ballon_envoy_balloon
  • ballon_envoy_rope
• Added automatic rope maintenance task.
• Refactored BalloonListener and EnvoyManager for cleaner, safer logic.
• Improved compatibility with reloads, chunk unloads, and Paper-specific behavior.

Result​

BalloonEnvoy is now:

• Fully functional on Paper 1.21.8
• Reliable across versions (1.12 – 1.21+)
• Accurate and responsive when shooting balloons
• Stable with no random leash or rope desync

This update resolves all known reported issues related to balloon hits and rope behavior.

Plugins supports 1.21.11.

I fix color code problemes. &

Merry Christmas!