ModMC AntiCheat

Defending Server Integrity Through Lightweight, Precise Packet Analysis.

ModMC AntiCheat is a high-performance, version-compatible security solution built to safeguard your community without compromising server performance. Engineered natively on top of the PacketEvents API, the plugin analyzes network data at the packet level to intercept modern hack clients instantly. By prioritizing optimization and mathematical accuracy, ModMC AntiCheat ensures that malicious actions are mitigated immediately while legitimate players enjoy a completely seamless experience.

The plugin functions out of the box with zero dependencies required, supporting Spigot, Paper, and Purpur servers from versions 1.8 through 1.21.3.

Why use this?

• Zero setup nightmare: No dependencies required. PacketEvents is shaded directly into the plugin. Just drag, drop, and restart.
• Discord Integration built-in: It sends live cheat alerts and punishment logs straight to your Discord webhook.
• In-game Live Monitoring: Staff can type /modac monitor <player> and watch a live feed of that specific player's violation flags stream directly into their chat.
• Database support: Uses SQLite to log everything asynchronously, allowing you to look up a player's history days later without lagging the main server thread.
• Highly Configurable: Want to ban instead of kick? Need to adjust thresholds? Just change a line in the config.

What does it actually catch?

Right now, the anti-cheat runs 16 highly tuned checks covering the most common modern client bypasses:

Movement

• Speed: Checks horizontal movement math. Tries to catch bunny-hopping, speed pots, ice-sprinting, etc.
• Fly: Tracks airtime and unnatural vertical hovering. Instantly catches packet-based flight and high jumps.
• NoFall: Stops people from spoofing their ground state to avoid taking fall damage.
• Jesus: Checks the bounding box against surrounding blocks to prevent water and lava walking.
• ElytraFly: Limits infinite flight and extreme firework boosting.
• NoSlow: Catches players moving at full sprint speed while eating, blocking, or drawing a bow.

Combat

• Reach: Strict 3D raytracing to stop players from hitting targets from impossible distances.
• KillAura: Looks at attack angles and inhuman consistency.
• AutoClicker: Uses standard deviation to find robotic clicking patterns.
• Velocity: Anti-KB check. Forces players to actually take the knockback the server gives them.
• Criticals: Catches sneaky micro-jumps used to force critical hits on every strike.

Player & World

• Timer: Stops clients from speeding up their game loop to send packets faster than 20 TPS.
• BadPackets: Blocks impossible packet orders and crash exploits.
• Inventory: Prevents moving items around while sprinting or doing things you shouldn't be able to do with an open GUI.
• Scaffold: Analyzes block placement angles and speeds to catch modern bridging hacks.
• FastBreak: Mathematical check based on block hardness, tool, and enchantments to stop SpeedMine and Nuker hacks.

Commands & Permissions

If you are a server admin, you will mainly be using these:

Command	Perm Node	What it does
/modac alerts	modac.alerts	Turns your live violation notifications on or off.
/modac verbose	modac.verbose	Turns on dev-level raw data spam (good for debugging false flags).
/modac notify <player>	modac.alerts	Pulls up a quick stat sheet: ping, health, gamemode, and active violations.
/modac monitor <player>	modac.alerts	Tap into a player. Their specific flags will show up in your chat with a prefix.
/modac history <player>	modac.info	View a player's past hacking logs from the database.
/modac top	modac.alerts	See the top 10 most suspicious online players right now.
/modac status	modac.alerts	Check if the plugin, database, and webhook are running healthy.
/modac kick <player>	modac.punish	Kicks the player and alerts Discord and staff.
/modac ban <player>	modac.punish	Bans the player and alerts Discord and staff.
/modac reload	modac.reload	Reloads the configuration file.
/modac testwebhook	modac.reload	Sends a test ping to your configured Discord channel.

Support & Bug Reports

Found a false positive or a bug? Have a suggestion for a new check? Please report it on our issue tracker: https://github.com/hello97-gg/modac/issues

Source Code & License

This project is completely open-source and licensed under the GNU General Public License v3.0. You can view the source code and contribute on our GitHub page at https://github.com/hello97-gg/modac.