BoxTop v3.0

The Ultimate Punching Bag Solution for your Server (1.12.2 - 1.21+)

Overview: BoxTop transforms any entity into a functional punching bag with simulated physics, RPG progression, and visual effects. Challenge friends to Arcade Duels, setup custom 3D models via Resource Packs, and manage everything effortlessly with the new In-Game Configuration UI.

Core Features

3D Custom Models

Full support for CustomModelData using Resource Packs. Makes bags look like real punching bags across all modern versions, eliminating visual conflicts.

Arcade Duels

Challenge nearby players via GUI! Includes betting, live BossBar, winner announcements, and fully customizable acceptance buttons.

In-Game Config UI

Shift + Right Click to easily configure individual bag attributes without touching console or config files.

RPG System & Stamina

Train to get stronger! Gain "Musculature" bonus damage as you accumulate hits. Manage energy to avoid exhaustion.

Real Physics & Leashing

Entities react to hits with real knockback. Suspend heavy bags using Leads (Leash) and fences flawlessly in 1.21+.

Leaderboards

Reward your players! Integrate with PlaceholderAPI to show global rankings via holograms and offer custom milestone rewards.

Showcase & Mechanics

01. Train & Physics

Setup is instant. Run /boxtop setentity <name> and start punching! Watch the bags react with realistic knockback and particle effects.

Train and Physics

02. In-Game Config UI

Sneak and Right-Click to open the settings menu and customize your bag in real-time. Change knockback, and visual settings without typing commands!

In-Game Config UI

03. Arcade Duels (1vs1)

Right-click a bag to open the Challenge Menu. Fight for the highest damage in 30 seconds! Perfect for lobby entertainment.

Arcade Duels

04. Creative Setup (Hanging Bags)

Use a Lead (Leash) and attach it to a fence to create realistic suspended heavy bags. Our native LeashHitch system handles the physics perfectly.

Hanging Bags

05. Global Leaderboards

Display the top fighters using Holograms. Fully supports PlaceholderAPI for dynamic top DPS rankings.

Global Leaderboards

Resource Packs (3D Models)

To use the new 3D Custom Models feature, you must install the appropriate resource pack for your server version.

1.12
[Download Link]
1.13
[Download Link]
1.16.5 - 1.20
[Download Link]
1.21.11
[Download Link]

Commands & Permissions

Player Commands

Requires general access to hit the bags or duel.

Command Description
/boxtop stats Check your personal damage and muscle level.
/boxtop accept <player> Accept a pending duel challenge.

Admin Commands

Permission: boxtop.admin

Command Description
/boxtop setentity <name> Turn the target entity into a functional punching bag.
/boxtop unsetentity <name> Revert the punching bag to a normal entity.
/boxtop list Show a multi-arena management GUI with all active bags and locations.
/boxtop reload Reload configuration files seamlessly.

Configuration Snippets

Below are some highlight configurations from config.yml showcasing the new v3.0 mechanics.

# --- DUELS & CUSTOM MESSAGES ---
duels:
  enabled: true
  duration: 30
  glow-color: "LIGHT_PURPLE"
  # Use {accept_button} placeholder inside messages
  # to render the interactive chat button!
  invite-format:
    - "&e&m-----------------------"
    - "&6%player% &echallenged you!"
    - "{accept_button}"
    - "&e&m-----------------------"
  
  # The actual button formatting (Supports Hex!)
  accept-button-text: "&a[CLICK TO ACCEPT]"

# --- RPG SYSTEMS ---
stamina:
  enabled: true
  max-hits: 20
  message-tired: "&cYou are exhausted!"

musculature:
  enabled: true
  bonus-damage: 0.5
  max-bonus: 20.0
CustomModelData Notice (v3.0): If you are a texture pack creator, remember that versions like 1.16.5 require the overrides syntax for CustomModelData, whereas 1.21.4+ uses range_dispatch. BoxTop fully supports both!

Under the Hood (v3.0 Optimizations)

BoxTop v3.0 was refactored from the ground up for maximum compatibility and performance: