AvA Anti-Cheat

AvAAntiCheat: Simple & Effective Minecraft Anti-Cheat

AvAAntiCheat is a lightweight, easy-to-use Bukkit/Spigot API designed for Minecraft Java servers running on the Bukkit/Spigot API (aka, Bukkit, Spigot,Paper,Purpur). 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:

* Exploits: Flying, Wall Climbing, Speed Hacks * Exploits: Combat Logging * Exploits: Auto Clicking * Exploits: Chat Spamming * Exploits: Select types of Packet Manipulation

> logged 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:

* Manual Compilation (For Developers): Download the latest compiled version from the Manual Compilation (For Developers): page. * Manual Compilation (For Developers): Get the `.jar` file from Manual Compilation (For Developers): (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

1. Place the `AvAAntiCheat.jar` file into your server's `/plugins` folder. 2. Restart your server. 3. 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"):

* GitHub Issue This is typically a display error where the developer forgot to update the version string in the plugin's internal configuration. * GitHub Issue 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

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