Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
๐จ 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.