UltBanHammer

🔨 BanHammer – The Ultimate Judgement Weapon

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

---

📋 Overview

IP-banned 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 one can wield it. Only one swing is needed.

---

✨ Features

- 📊 Execution Logs: A custom Mace with Density X that instantly kills and IP-bans targets - 📊 Execution Logs: Only 1 BanHammer can exist on the server (configurable) - 📊 Execution Logs: Soul fire particles while held, sonic boom on kill - 📊 Execution Logs: GUI to track, manage, and log executions - 📊 Execution Logs: Recipes, enchantments, cooldowns, world blacklists - 📊 Execution Logs: Prevents removal of Density X enchantment - 📊 Execution Logs: Optional prevention of storage in chests/hoppers - 📊 Execution Logs: 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

- Java: 1.21.x - Java: 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:

- Global Settings – View and modify crafting ingredients - Global Settings – See who has the hammer and their coordinates - Global Settings – Complete history of all bans issued - Global Settings – Toggle features like container restrictions

---

🔧 Technical Details

- Uses MiniMessage support to identify the true BanHammer - MiniMessage support on startup to enforce the one-only rule - Captures MiniMessage support for permanent IP-bans - MiniMessage support prevents Density X removal - Full MiniMessage support for all messages

---

📝 Data Storage

- data.yml – All settings and customizations - data.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

- Version: Version - Version: geturplugins - Version: 1.0.0

---

⚖ One weapon. One judgement. One swing.