AntiMaceKill – Documentation
1. Overview
AntiMaceKill is a lightweight and high-performance anti-cheat plugin designed specifically for Minecraft 1.21.x servers.
It prevents exploit hacks related to the new mace weapon, including:

• Illegal reach hacks
  
  
• Fake fall smashes
  
  
• Rapid attack exploits (e.g., Meteor or Wurst clients)

The plugin is fully automated, requires no dependencies, and ensures fair combat by handling detections, issuing warnings, alerting admins, and applying punishments — all with minimal performance impact.

Key Highlights:

• MODERN • LIGHTWEIGHT • COMPATIBLE WITH PAPER, SPIGOT
• Supports Minecraft 1.21.x
  
  
• Need help? Contact via Discord: YoFlixxz
  
  
• Join our community: Discord Server

2. Features
2.1 Exploit Prevention

• MaceKill Exploit Blocker – Detects and blocks unfair reach attacks, fake fall smashes, and ultra-fast mace hits.
  
  
• Rapid Attack Filter – Cancels attacks performed faster than 200ms, which is impossible for legitimate players.
  
  
• Reach & Fall Checks – Blocks attacks beyond 4.5 blocks or fake smashes exceeding 10-block height.

2.2 Gameplay Integrity

• Teleport Correction – Returns exploiters to their last grounded position and resets velocity.
  
  
• Vanilla Combat Friendly – Fully compatible with legit smashes and wind charge mechanics.

2.3 Administration & Logging

• Warnings & Admin Alerts – Sends players warning messages and displays real-time alerts for admins.
  
  
• Full Logging Support – Logs all detections, punishments, and events to logs.yml.
  
  
• Permission Bypass – Use antimace.bypass to exempt trusted staff or testers from checks.

2.4 Performance

• Lag-Free Design – Built with async optimizations, capable of handling hundreds of players simultaneously.

3. Installation Guide

1. Download the latest AntiMaceKill.jar.
   
   
2. Place it in your server’s /plugins directory.
   
   
3. Start or restart your server — the plugin will auto-generate the configuration files.
   
   
4. Open and customize config.yml as needed.
   
   
5. Reload or restart your server to apply changes.
   
   
6. Done — your server is now protected!

4. Configuration
The plugin generates a config.yml file with customizable settings, such as:

• Detection thresholds (reach, fall height, attack speed)
  
  
• Alert messages and formats

(For full configuration details, refer to the auto-generated config.yml.)

5. Permissions

Permission Description
antimace.bypass Excludes a player from all AntiMaceKill checks.
6. Compatibility

• Minecraft Versions: Paper, Spigot, and Folia 1.21.1 – 1.21.5
  
  
• Dependencies: None
  
  
• Hacked Clients Tested: Meteor, LiquidBounce, Wurst, Aristois, Custom Clients

7. Demo Video
Watch on YouTube

8. Support

• For direct help: DM YoFlixxz on Discord
  
  
• Community help: https://discord.gg/tdaTn2xDrq