UltBanHammer

🔨 BanHammer – The Ultimate Judgement Weapon

A devastatingly powerful Paper/Spigot admin super-weapon for Minecraft 1.21.x

---

📋 Overview

BanHammer is a premium administrative plugin that transforms Minecraft's Mace into a legendary weapon of judgement. Kill a player with the BanHammer, and they're instantly IP-banned from your server.

Only one can exist at a time. Only admins can wield it. Only one swing is needed.

---

✨ Features

• 🔨 The Weapon: A custom Mace with Density X that instantly kills and IP-bans targets
• 📍 One-Only Rule: Only 1 BanHammer can exist on the server (configurable)
• 🎨 Epic Visuals: Soul fire particles while held, sonic boom on kill
• 🛡️ Admin Dashboard: GUI to track, manage, and log executions
• ⚙️ Fully Configurable: Recipes, enchantments, cooldowns, world blacklists
• 🔐 Grindstone Protection: Prevents removal of Density X enchantment
• 📦 Container Restrictions: Optional prevention of storage in chests/hoppers
• 🌍 World Filtering: Disable the hammer in specific worlds
• 📊 Execution Logs: Complete audit trail of all bans issued

---

🎯 Commands

| Command | Permission | Description |
|---------|-----------|-------------|
| `/bh give` | `banhammer.give` | Give the BanHammer to yourself |
| `/bh admin` | `banhammer.admin` | Open the admin dashboard GUI |
| `/bh unban <player/IP>` | `banhammer.unban` | Unban a player/IP banned by the hammer |
| `/bh reload` | `banhammer.reload` | Reload all configuration files |

---

🔐 Permissions

Root Permission

• `banhammer.*` – Grants all BanHammer permissions (default: OP)

Individual Permissions
| Permission | Description | Default |
|-----------|-------------|---------|
| `banhammer.use` | Access to /bh base command | OP |
| `banhammer.give` | Use /bh give | OP |
| `banhammer.admin` | Open admin dashboard | OP |
| `banhammer.unban` | Unban players/IPs | OP |
| `banhammer.reload` | Reload configs | OP |
| `banhammer.craft` | Craft the hammer | OP |
| `banhammer.wield` | Hold/use the hammer | OP |

---

📦 Requirements

• Minecraft: 1.21.x
• Server: Paper or Spigot
• Java: 17+

---

🚀 Installation

1. Download the plugin JAR
2. Place in your `plugins/` folder
3. Restart your server
4. Configure `plugins/BanHammer/config.yml` as needed
5. Reload or restart the server

---

🎨 Admin Dashboard (`/bh admin`)

The dashboard GUI includes:

• Recipe Editor – View and modify crafting ingredients
• Hammer Tracker – See who has the hammer and their coordinates
• Execution Logs – Complete history of all bans issued
• Global Settings – Toggle features like container restrictions

---

🔧 Technical Details

• Uses PersistentDataContainer (PDC) to identify the true BanHammer
• Asynchronous scanning on startup to enforce the one-only rule
• Captures IP addresses for permanent IP-bans
• Grindstone protection prevents Density X removal
• Full MiniMessage support for all messages

---

📝 Data Storage

• config.yml – All settings and customizations
• messages.yml – MiniMessage-formatted strings
• data.yml – Banned players/IPs and hammer location/owner

---

⚠️ Warning

This is a super-weapon designed for administrators only. Use responsibly. IP-bans are permanent and require manual unbanning.

---

📞 Support

• Discord: Join Here
• Author: geturplugins
• Version: 1.0.0

---

⚖ One weapon. One judgement. One swing.