MaceBlocker Documentation
️ Configuration & Setup
This plugin is completely
plug-and-play.
- There are no complex configuration files (config.yml) to manage or mess up.
- Simply drop the compiled .jar file into your server's /plugins/ directory and restart/reload the server to initialize the protection.
Commands & Permissions
To keep things lightweight and high-performance, this version of the plugin runs purely in the background via event listening.
- Commands: None (No setup required!)
- Permissions: None (Applies globally to all players on the server automatically)
How it Works (Technical Details)
The plugin listens for the Spigot/Paper EntityDamageByEntityEvent. When triggered:
- It verifies if the attacker is a player.
- It checks the player's main hand for Material.MACE.
- If a Mace is detected, the damage event is entirely cancelled (event.setCancelled(true)), preventing health reduction, knockback, or custom smash mechanics from processing.
- The player receives a direct action/chat warning message.