BanHitbox

🎯 BanHitbox – Quick Punishment System

BanHitbox is a Minecraft mod for administrators that allows instant player punishment through a convenient interface. Simply aim your crosshair at a rule-breaker and select the appropriate punishment!

• Telegram – https://t.me/muliccki_baza
• MAX – https://max.ru/join/7bu36faPu2GLgAmxl3rLK_N5IwKFop-j54MHll53NeU

• 🪙 Cryptocurrency (USDT):

• 9tkTft2E8XqYZVwyQTvgxdph9nkUmK1F5fmGVHXLNyNY

⚡ Mod Features

• Quick Punishment: Aim at player and press middle mouse button
• Multiple Selection: Choose multiple violations simultaneously
• Automatic Calculation: Ban days are summed, reasons are combined
• Custom Commands: Configure your own commands (kick, mute, warn)
• Flexible Configuration: Easily configurable through JSON config
• Plugin Compatibility: Works with LiteBans, EssentialsX, AdvancedBan and other plugins

🎮 How to Use

1. Aim crosshair at the rule-breaking player
2. Press middle mouse button (scroll wheel click)
3. Select violations from the list (multiple allowed)
4. Click “PUNISH”

The mod automatically sends the command to chat. For example:

ban Player123 45d Admin Disrespect + Griefing + Cheating

⚙️ Config Setup

File Location

After first launch, config is created at:

.minecraft/config/punishments.json

Basic Structure

{
  "banCommandTemplate": "ban {player} {time} {reason}",
  "punishments": [
    {
      "name": "Cheating",
      "days": 30,
      "command": null
    },
    {
      "name": "Kick",
      "days": 0,
      "command": "kick {player} {reason}"
    }
  ]
}

Punishment Types

Regular punishments (with days):

{
  "name": "Cheating",
  "days": 30,
  "command": null
}

Custom commands:

{
  "name": "Mute 1 hour",
  "days": 0,
  "command": "mute {player} 1h {reason}"
}

Placeholders (Variables)

• {player} – player nickname
• {time} – ban duration (e.g. “30d”)
• {reason} – punishment reason

📋 Config Examples

For LiteBans

{
  "banCommandTemplate": "ban {player} {time} {reason}",
  "punishments": [
    {
      "name": "Cheating",
      "days": 30,
      "command": null
    },
    {
      "name": "Mute 1d",
      "days": 0,
      "command": "mute {player} 1d {reason}"
    },
    {
      "name": "Tempban 7d",
      "days": 0,
      "command": "tempban {player} 7d {reason}"
    },
    {
      "name": "Warning",
      "days": 0,
      "command": "warn {player} {reason}"
    }
  ]
}

For EssentialsX

{
  "banCommandTemplate": "ban {player} {reason}",
  "punishments": [
    {
      "name": "Permanent Ban",
      "days": 0,
      "command": "ban {player} {reason}"
    },
    {
      "name": "Tempban 1h",
      "days": 0,
      "command": "tempban {player} 1h {reason}"
    },
    {
      "name": "Kick",
      "days": 0,
      "command": "kick {player} {reason}"
    }
  ]
}

🔧 Config Creation Guide

Step 1: Open Config File

Find .minecraft/config/punishments.json and open it in any text editor.

Step 2: Configure Command Template

"banCommandTemplate": "ban {player} {time} {reason}"

Change to your ban plugin’s command format.

Step 3: Add Punishments

For each punishment, create a block:

{
  "name": "Violation Name",
  "days": number_of_days,
  "command": "custom_command or null"
}

Step 4: Save and Restart

Save the file and restart Minecraft.

⚠️ Important Rules

• Put comma after each { } block, except the last one
• All text values in double quotes "text"
• null is written without quotes
• Numbers are written without quotes

🎯 Usage Examples

Selected: “Admin Disrespect” + “Griefing”
Result: ban Player123 15d Admin Disrespect + Griefing

Selected: “Kick” (custom command)
Result: kick Player123 Rule violation

🔄 How to Update Config

1. Stop server/exit game
2. Edit punishments.json
3. Save file
4. Launch game again

The mod will automatically load new settings!

🚀 Key Benefits

• Lightning Fast: Punish players in seconds
• Accurate Targeting: Precise crosshair-based selection
• Highly Customizable: Adapt to any server setup
• Performance Optimized: Lightweight and lag-free
• Universal Compatibility: Works with all popular ban plugins