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:

• Code (Text):

  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

⚙️ Important Configurations

Hammer Limit:
Punishment Settings:
Enchantments:
Cooldown:
One-Shot Kill:
Container Restriction:
Recipe:
Crafting Shape:
World Blacklist:
Visual Effects:
[HR]

Requirements

• Minecraft: 1.21.x
• Server: Paper or Spigot
• Java: 17+

[HR]

Installation

1. Download the plugin JAR
2. Place in your
   Code (Text):

   plugins/
   folder
3. Restart your server
4. Configure
   Code (Text):

   plugins/BanHammer/config.yml
   as needed
5. Reload or restart the server

[HR]

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

[HR]

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

[HR]

Data Storage

• Code (Text):

  config.yml
  – All settings and customizations
• Code (Text):

  messages.yml
  – MiniMessage-formatted strings
• Code (Text):

  data.yml
  – Banned players/IPs and hammer location/owner

[HR]

⚠️ Warning

This is a super-weapon designed for administrators only. Use responsibly. IP-bans are permanent and require manual unbanning.

[HR]

Support

• Discord: discord.gg/xctckUQukB
• Author: geturplugins
• Version: 1.0.0

[HR]