PunchingBag | Lobby Entertainment | Physics, Duels & Rankings -----
The lobby punching bag your players will actually use. Physics · Duels · Progression
UPDATE v3.2 - Piñata Mode & Invisibility
What's new in this version?
This update brings highly requested features to make your server even more unique! We are introducing the exciting new Piñata Mode for fun and rewarding training sessions, alongside a powerful new customization tool inspired directly by our community.
► New Features & Enhancements:
- Piñata Mode Enabled: You can now activate Piñata Mode on your bags! When players hit them, they act like a real piñata, dropping items, giving rewards, or triggering specific commands.
- Fully Configurable Rewards: You have complete control over the loot. Set up custom drop chances, specific items, and economy rewards directly in your configuration files.
- Permanent Entity Invisibility: You can now toggle permanent invisibility on any punching bag entity! This allows you to create incredible visual effects (like floating armor or custom heads) without the base vanilla entity getting in the way.
► Community Spotlight:
A huge thanks to the community for helping shape the future of BoxTop! The new Invisibility feature was directly implemented based on this fantastic suggestion:
If you are enjoying BoxTop and the new features, please consider leaving a ⭐⭐⭐⭐⭐ review! It helps the project grow immensely.
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
variable in config.yml and define the exact text/color of the interactive button using the newCode (Text):{accept_button}option.Code (Text):accept-button-text
- [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
variable to theCode (Text):{accept_button}list in your config file.Code (Text):invite-format
- 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+ usesCode (Text):overrides. It is recommended to check the CustomModelData documentation if 3D models appear invisible in intermediate versions.Code (Text):range_dispatch
This update focuses on
Admin Experience (UX) and
Performance. We have polished the commands and particle engine to make managing your punching bags smoother than ever.
New Features
New Features
- Interactive Admin List:
- The /boxtop list command is now clickable!
- Added [TP] button to instantly teleport to a bag.
- Added [REMOVE] button to suggest the delete command (prevents accidents).
- The /boxtop list command is now clickable!
- Smart Targeting System (Raytracing):
- We replaced the old "nearest entity" detection with a custom Mathematical Raytracer.
- "Forgiving Aim": You can now easily select large mobs (Iron Golems, Ravagers) even if you don't aim at their exact center. Works perfectly from 1.12 to 1.21.
- We replaced the old "nearest entity" detection with a custom Mathematical Raytracer.
- New Placeholder:
- Added %boxtop_personal%: Displays the player's total accumulated damage.
- Added %boxtop_personal%: Displays the player's total accumulated damage.
- Particle Engine 2.0:
- Hot Reload: Changing particles in config.yml and using /boxtop reload now updates visuals instantly (no server restart needed).
- Smart Translation: The plugin now automatically translates particle names between versions (e.g., VILLAGER_HAPPY <-> HAPPY_VILLAGER), ensuring your config works on both 1.12 and 1.21 without errors.
- Hot Reload: Changing particles in config.yml and using /boxtop reload now updates visuals instantly (no server restart needed).
- Optimized Reloads: The reload command now injects updates directly into tasks, reducing CPU usage during runtime.
- Fixed particle names getting stuck on "Happy Villager" after a reload.
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)
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.
- Reported issue: Punching bags were dying or taking damage from lava, fire, cactus, or explosions.
- 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.
- Reported issue: Issues with the 1v1 Duel logic and invites.
- 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.
- We completely rewrote the Glowing system using a Strategy Pattern.
- 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).
- Replaced text-based detection with a Mathematical Version Calculator.
- 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.
- The Scoreboard system now registers entities by both UUID and Name.
- 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
-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 :
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
#
# 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
/boxtop setentity [name]
and you can see the list with
/boxtop list
Resource Information
Author:
----------
Total Downloads: 88
First Release: Dec 18, 2025
Last Update: Jun 15, 2026
Category: ---------------
All-Time Rating:
Find more info at myplugins.gexel.fun...1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings