BoxTop v3.0
THE MASSIVE 3D UPDATE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FEATURES & ENHANCEMENTS
- [3D CUSTOM MODELS] Full support for CustomModelData on Villagers (1.14 - 1.21.11). The Punching Bag is now 100% compatible with 3D models using the PAPER item over the villager's head, eliminating visual conflicts in modern versions.
- [DUEL INVITES CUSTOMIZATION] The hardcoded interactive text for invitations has been removed. Administrators can now use the new
Code (Text):
{accept_button}
variable in config.yml and define the exact text/color of the interactive button using the new
Code (Text):
accept-button-text
option.
- [HEX & LEGACY COLORS] Rewrote the interactive message engine to ensure that colors and formats (&) in interactive buttons work perfectly from 1.12.2 all the way to 1.21+.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
BUG FIXES
- [CRITICAL LEASH FIX (PAPER 1.21.11)] Fixed a silent internal bug in PaperMC 1.21 that prevented tying the bag to a fence. The plugin now manually generates a native "LeashHitch" to guarantee the mechanic works flawlessly.
- [INVASIVE PERMISSIONS FIX] The plugin no longer interferes with vanilla leash mechanics. Normal players can now leash cows, pigs, etc., without requiring admin permissions. BoxTop will only check for permissions when strictly interacting with a punching bag.
- [LEGACY 3D MODELS (1.12.2)] Adjusted default values and optimized internal code so the "Damage Value" engine renders 3D models smoothly.
- [VILLAGER PROFESSION ERROR] Added a Reflection system to prevent console errors when the server doesn't detect the NONE profession in older villagers, using a safe fallback to FARMER.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
UNDER THE HOOD (OPTIMIZATIONS)
- Absolute Compatibility (Triple-Fallback): Improved CustomModelData injection to prevent errors regardless of the server fork (Spigot, Paper, Purpur, Pufferfish, etc.) using a triple-attempt Reflection system.
- Event Priority (Highest): HitListeners now operate at the highest priority. This prevents heavy combat plugins like mcMMO or Aurelium Skills from applying physics or bleeding effects to the bag after BoxTop has cancelled the event.
- Durability Reflection Cleanup: Removed unstable Reflection calls to configure durability in Legacy versions, using direct Bukkit API methods instead to improve server performance.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ADMIN NOTES (IMPORTANT)
- Config.yml Update: If you are updating from an older version, make sure to add the
Code (Text):
{accept_button}
variable to the
Code (Text):
invite-format
list in your config file.
- Texture Creators (1.16.5 vs 1.21): Remember that in versions like 1.16.5, the base JSON file must use the
syntax, while 1.21.4+ uses
Code (Text):
range_dispatch
. It is recommended to check the CustomModelData documentation if 3D models appear invisible in intermediate versions.