🔨 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
- Download the plugin JAR
- Place in your `plugins/` folder
- Restart your server
- Configure `plugins/BanHammer/config.yml` as needed
- 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.
