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

🔐 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.