\ud83d\udd28 BanHammer \u2013 The Ultimate Judgement Weapon<\/p>\n
> **A devastatingly powerful Paper\/Spigot admin super-weapon for Minecraft 1.21.x**<\/p>\n
—<\/p>\n
\ud83d\udccb Overview<\/p>\n
**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.<\/p>\n
Only **one** can exist at a time. Only **admins** can wield it. Only **one** swing is needed.<\/p>\n
—<\/p>\n
\u2728 Features<\/p>\n
– **\ud83d\udd28 The Weapon**: A custom Mace with Density X that instantly kills and IP-bans targets
\n– **\ud83d\udccd One-Only Rule**: Only 1 BanHammer can exist on the server (configurable)
\n– **\ud83c\udfa8 Epic Visuals**: Soul fire particles while held, sonic boom on kill
\n– **\ud83d\udee1\ufe0f Admin Dashboard**: GUI to track, manage, and log executions
\n– **\u2699\ufe0f Fully Configurable**: Recipes, enchantments, cooldowns, world blacklists
\n– **\ud83d\udd10 Grindstone Protection**: Prevents removal of Density X enchantment
\n– **\ud83d\udce6 Container Restrictions**: Optional prevention of storage in chests\/hoppers
\n– **\ud83c\udf0d World Filtering**: Disable the hammer in specific worlds
\n– **\ud83d\udcca Execution Logs**: Complete audit trail of all bans issued<\/p>\n
—<\/p>\n
\ud83c\udfaf Commands<\/p>\n
| Command | Permission | Description | —<\/p>\n \ud83d\udd10 Permissions<\/p>\n Root Permission Individual Permissions —<\/p>\n \ud83d\udce6 Requirements<\/p>\n – **Minecraft**: 1.21.x —<\/p>\n \ud83d\ude80 Installation<\/p>\n 1. Download the plugin JAR —<\/p>\n \ud83c\udfa8 Admin Dashboard (`\/bh admin`)<\/p>\n The dashboard GUI includes:<\/p>\n – **Recipe Editor** \u2013 View and modify crafting ingredients —<\/p>\n \ud83d\udd27 Technical Details<\/p>\n – Uses **PersistentDataContainer (PDC)** to identify the true BanHammer —<\/p>\n \ud83d\udcdd Data Storage<\/p>\n – **config.yml** \u2013 All settings and customizations —<\/p>\n \u26a0\ufe0f Warning<\/p>\n This is a **super-weapon** designed for administrators only. Use responsibly. IP-bans are permanent and require manual unbanning.<\/p>\n —<\/p>\n \ud83d\udcde Support<\/p>\n – **Discord**: Join Here —<\/p>\n **\u2696 One weapon. One judgement. One swing.**<\/p>\n
\n|———|———–|————-|
\n| `\/bh give` | `banhammer.give` | Give the BanHammer to yourself |
\n| `\/bh admin` | `banhammer.admin` | Open the admin dashboard GUI |
\n| `\/bh unban
\n| `\/bh reload` | `banhammer.reload` | Reload all configuration files |<\/p>\n
\n– **`banhammer.*`** \u2013 Grants all BanHammer permissions (default: OP)<\/p>\n
\n| Permission | Description | Default |
\n|———–|————-|———|
\n| `banhammer.use` | Access to \/bh base command | OP |
\n| `banhammer.give` | Use \/bh give | OP |
\n| `banhammer.admin` | Open admin dashboard | OP |
\n| `banhammer.unban` | Unban players\/IPs | OP |
\n| `banhammer.reload` | Reload configs | OP |
\n| `banhammer.craft` | Craft the hammer | OP |
\n| `banhammer.wield` | Hold\/use the hammer | OP |<\/p>\n
\n– **Server**: Paper or Spigot
\n– **Java**: 17+<\/p>\n
\n2. Place in your `plugins\/` folder
\n3. Restart your server
\n4. Configure `plugins\/BanHammer\/config.yml` as needed
\n5. Reload or restart the server<\/p>\n
\n– **Hammer Tracker** \u2013 See who has the hammer and their coordinates
\n– **Execution Logs** \u2013 Complete history of all bans issued
\n– **Global Settings** \u2013 Toggle features like container restrictions<\/p>\n
\n– **Asynchronous scanning** on startup to enforce the one-only rule
\n– Captures **IP addresses** for permanent IP-bans
\n– **Grindstone protection** prevents Density X removal
\n– Full **MiniMessage support** for all messages<\/p>\n
\n– **messages.yml** \u2013 MiniMessage-formatted strings
\n– **data.yml** \u2013 Banned players\/IPs and hammer location\/owner<\/p>\n
\n– **Author**: geturplugins
\n– **Version**: 1.0.0<\/p>\n