AvAAntiCheat: Simple & Effective Minecraft Anti-Cheat

AvAAntiCheat is a lightweight, easy-to-use anti-cheat plugin designed for Minecraft Java servers running on the Bukkit/Spigot API. It helps maintain a fair and clean environment for players.

It is confirmed to work with Minecraft version 1.21.11.

Core Features / Detections

The anti-cheat actively monitors and logs several common unfair advantages:

Movement Hacks: Flying, Speed hacks, spider hacks (wall climbing), phasing detection
Combat Evasion: Combat Logging
Unfair Automation: Auto Clicking
Chat Abuse: Chat Spamming
Exploits: Select types of Packet Manipulation

Note on Logging: The system employs a violation counter. Detections are logged (e.g., first violation for minor flying) even if no immediate action is taken, allowing staff to track repeat offenders.

Installation

Installing the plugin is straightforward:

1. Download the Plugin File

Choose your preferred method to obtain the .jar file:

GitHub: Download the latest compiled version from the GitHub Releases page.
Plugin Sites: Get the .jar file from CurseForge (or other supported sites).
Manual Compilation (For Developers):
- Clone the repository: git clone https://github.com/nsharp-collab/AvAAntiCheat.git
- Run the Maven command: mvn clean package
- The compiled file will be in your local /target directory.

2. Server Setup

Place the AvAAntiCheat.jar file into your server's /plugins folder.
Restart your server.
Verify installation using the command /ac status.

Usage & Commands

For a full list of commands, permissions, and configuration options, please refer to the project Wiki.

[https://github.com/nsharp-collab/AvAAntiCheat/wiki/Commands]

Troubleshooting / Known Issues

Incorrect Version Display

If the /ac status command or startup messages report an incorrect Minecraft version (e.g., "1.8.8" when the file name says "1.9"):

Reason: This is typically a display error where the developer forgot to update the version string in the plugin's internal configuration.
Action: Please create a GitHub Issue detailing the version mismatch. The functionality of the anti-cheat itself should remain correct for the listed supported version.

Support, Issues, and Contribution

Reporting Issues: If you find a bug, a crash, or a bypass, please open a detailed Issue Ticket on GitHub.
Contributing: Guidelines for submitting feature suggestions and pull requests can be found in the separate CONTRIBUTING.md file.

AvA Anti-Cheat