PunchingBag | Lobby Entertainment | Physics, Duels & Ranking

UPDATE v3.1 - The User GUI Update​ What's new in this version? We are bringing a whole new level of interaction for your players! This update introduces the brand new User GUI, designed to make tracking stats and interacting with the punching bags much more engaging, visual, and user-friendly. ► New Features & Enhancements: · Interactive User Menu: Players can now open a sleek graphical interface to view their personal damage, total hits, and muscular progression instantly, without relying on boring text commands. · Better Player Engagement: Giving players a visual representation of their stats encourages them to keep training and competing with others, naturally boosting retention on your server! · Performance Tweaks: Minor under-the-hood code improvements to ensure everything runs buttery smooth. If you are enjoying BoxTop, please consider leaving a review! It helps the project grow immensely. ​

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 Code (Text): overrides 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.

BoxTop v2.6.1 - The "Cross-Version" & Stability Update This update is a major milestone for BoxTop. We have completely rewritten the core mechanics to ensure seamless compatibility from 1.12.2 up to 1.21+, along with critical bug fixes reported by the community. - Critical Bug Fixes (User Reports) · Fixed: Bags taking Environmental Damage. · Reported issue: Punching bags were dying or taking damage from lava, fire, cactus, or explosions. · Fix: Added strict protection in HitListener. Bags are now immune to all environmental damage and will automatically extinguish fire ticks if ignited. · Fixed: Duels System Stability. · Reported issue: Issues with the 1v1 Duel logic and invites. · Fix: The Duel system has been polished. Invites, GUIs, and the Arcade logic now work flawlessly across versions. -New Features & Improvements · New "Cross-Version" Glow Architecture: · We completely rewrote the Glowing system using a Strategy Pattern. · Legacy Mode (1.8 - 1.12): Uses Team Prefix logic to ensure colored glow works on older servers. · Modern Mode (1.13 - 1.21+): Uses the native setColor API for best performance. · Smart Version Detection: · Replaced text-based detection with a Mathematical Version Calculator. · Why? This fixes a bug where 1.21.x servers were incorrectly detected as "1.12 Legacy", breaking the visuals. Now the plugin calculates the version number accurately (e.g., 21 >= 13 → Modern). · Hybrid Entity Injection: · The Scoreboard system now registers entities by both UUID and Name. · Benefit: This ensures consistent glowing whether you use standard Mobs (Zombies) or NPCs (Citizens) as punching bags. -Technical Changes · Optimized GlowManager to prevent NullPointerExceptions during task execution. · The system now intelligently uses the MainScoreboard to prevent conflicts with TAB or Tag plugins that manipulate per-player scoreboards.

-support for many versions 1.9 - 1.21+ -fixed error of dupe heads - Bstats integrated

· 1vs1 Duels: New Arcade Mode! Challenge players using a GUI, bet items/money, and fight for the highest DPS with a live BossBar.

BoxTop Update 2.0 IS HERE! Stamina, RPG Progression, and Full Control. ​ What's New? · Stamina System (Fatigue): The punching bag now features a fully functional Stamina System! To make your server more interactive, players now need to manage their energy. If they hit too fast, they get tired! Everything is configurable in the config.yml. · Musculature RPG System: We implemented a training progression system! Hard work pays off: The more damage you deal, the stronger you become. Gain permanent damage bonuses by training on the bag! · Optimized & Clean: We have completely optimized the configuration reading. It is now smoother, more comfortable to edit, and 100% customizable. NEW CONFIGURATION (v2.0)​ Code (YAML): # ---------------------------------------------------- # ____ _____ __ _________ ____ ____ # ( _ \( _ )( \/ )(_ _)( _ \( _ \ # ) _ < )(_)( ) ( ) ( ) _ < ) __/ # (____/(_____)(_/\/\_) (___) (____/(__) # # BoxTop - The Ultimate Punching Bag Plugin # Author: Gexel | Version: 2.0 # ---------------------------------------------------- # --- BOXING BAGS STORAGE --- # List of bags. Automatically populated with /boxtop setentity boxing-bags : { } # --- PHYSICS SYSTEM --- physics: enabled : true # Knockback strength (0.1 to 1.0 recommended) knockback-strength : 0.4 # Upward thrust vertical-strength : 0.1 # --- VISUAL EFFECTS --- particles: enabled : true # Compatible types 1.16-1.21: VILLAGER_HAPPY, FLAME, HEART, SOUL, CLOUD type : "VILLAGER_HAPPY" amount : 3 offset-y : 2.2 speed : 0.1 # Update frequency (Ticks) interval : 20 # --- GLOWING EFFECT --- glow: enabled : true # Colors: RED, BLUE, GREEN, GOLD, WHITE, AQUA, LIGHT_PURPLE color : "GOLD" # --- SOUND SYSTEM (NEW) --- sounds: enabled : true # Sound on hit (Soft hit) hit-sound : "ENTITY_PLAYER_ATTACK_WEAK" # Sound on hit with muscle bonus (Heavy metal hit) muscle-sound : "ENTITY_ZOMBIE_ATTACK_IRON_DOOR" # Volume and Pitch volume : 1.0 pitch : 1.0 # --- STAMINA SYSTEM (Fatigue) --- stamina: enabled : true max-hits : 20 reset-burst-time : 5 cooldown-duration : 60 message-tired : "&c You are exhausted! Rest for ({time}s)." message-recovered : "&a You have caught your breath." # --- MUSCULATURE SYSTEM (RPG) --- musculature: enabled : true damage-threshold : 2000.0 bonus-damage : 0.5 max-bonus : 20.0 # Level up sound (Optional) level-up-sound : "ENTITY_PLAYER_LEVELUP" # --- REWARDS --- rewards: enabled : true interval : 1000.0 commands : - "eco give %player% 50" - "tellraw %player% [\"\ ",{\"text\ ":\" [BoxTop ] \ ",\"color\ ":\"gold\ "},{\"text\ ":\"Reward earned!\ ",\"color\ ":\"green\ "}]" # --- GLOBAL STATS --- stats : { } # --- MESSAGES --- messages: prefix : "&8[&6BoxTop&8] " no-permission : "&cYou do not have permission." only-players : "&cOnly players." reload : "&aConfiguration reloaded." usage-set : "&cUsage: /boxtop setentity <name>" usage-unset : "&cUsage: /boxtop unsetentity <name>" entity-set : "&aBag '&e{name}&a' set!" entity-unset : "&eBag '&6{name}&e' removed." entity-not-found : "&cBag not found." no-entity-nearby : "&cNo entities nearby." stats-header : "&8&m--------&r &6Statistics &8&m--------" stats-format : "&eTotal Damage: &f{damage}" stats-no-data : "&cYou haven't hit anything yet." hit-actionbar : "&c&l HIT! &fYou dealt &e{damage} &fdamage" list-header : "&8&m--------&r &6Active Arenas &8&m--------" list-format : "&e &f{name} &7(Active)" list-empty : "&cNo bags configured."

NEW FEATURE : ENTITYS WITH GLOWING

In this update you can customize the particles of the entity inside in the config : Code (Text): # BoxTop Main Configuration # # LIST OF BOXING BAGS (Name: UUID) # Automatically filled via /boxtop setentity <name> physics: enabled: true knockback-strength: 0.4 vertical-strength: 0.1 particles: # <------------ IN THIS PART enabled: true type: HEART # <------------ PARTICLE TYPE amount: 3 offset-y: 2.2 speed: 0.1 interval: 20 messages: prefix: '&8[&6BoxTop&8] ' no-permission: '&cYou do not have permission.' only-players: '&cOnly players can use this command.' reload: '&aConfiguration reloaded successfully.' usage-set: '&cUsage: /boxtop setentity <name>' usage-unset: '&cUsage: /boxtop unsetentity <name>' entity-set: '&aBag ''&e{name}&a'' successfully set!' entity-unset: '&eBag ''&6{name}&e'' removed.' entity-not-found: '&cNo bag found with the name ''&4{name}&c''.' no-entity-nearby: '&cNo entities found nearby.' stats-header: '&8&m--------&r &6Your Statistics &8&m--------' stats-format: '&eTotal Damage: &f{damage}' stats-no-data: '&cYou haven''t hit any punching bag yet.' hit-actionbar: '&c&l HIT! &fDealt &e{damage} &fdamage' list-header: '&8&m--------&r &6Active Bags &8&m--------' list-format: '&e &f{name} &7(Active)' list-empty: '&cNo punching bags configured yet.' rewards: enabled: true interval: 1000.0 commands: - eco give %player% 50 - tellraw %player% ["",{"text":"[BoxTop] ","color":"gold"},{"text":"Reward for accumulated damage!","color":"green"}] stats: 778d72f1-21bd-32eb-bcde-fa971bac7318: name: _gengis damage: 12.719999819993973 boxing-bags: '1': 75c3ec77-b1a9-40b3-b3aa-aed23b34ebce

Now you can create more boxing bags, with the command /boxtop setentity [name] and you can see the list with /boxtop list