How Grace works,
and why it works that way.

The vision

Most anticheats today fall into one of two camps. Either they are heavy, intrusive, and punish players before a human ever looks at the evidence, or they are lightweight but blind to anything more subtle than fly hacks.

GraceAC was built to sit between those two extremes. The goal is high detection accuracy with near-zero TPS impact, running at the proxy level so it sees every player on every backend server from a single point. No agents. No per-server installs. One plugin, full network visibility.

The ML sidecar handles what rules cannot. Ghost configs, humanised movement, bypass timing that sits just under every threshold. That layer is trained on real packet logs from real servers, not synthetic data.

Technical architecture

Detection philosophy

Grace does not auto-ban. That is a deliberate choice, not a limitation.

Every detection fires an alert, graded by confidence. High-confidence alerts are flagged prominently. Lower-confidence detections are logged quietly for review. Your moderators and administrators see everything in real time and make the call themselves, with full context.

When action is needed, the tools are there. A configurable kick and ban system lets you set your own thresholds. A rubberband system can silently correct suspicious movement without alerting the player. All of it is tunable per server, because a 20-player SMP and a 500-player network do not need the same settings.

The philosophy is simple. Grace flags. Humans decide. No innocent player gets banned because a check misfired at 3am with nobody watching.

Compatibility and extensibility

Grace targets Minecraft 1.19 and above on Velocity proxy networks. The Companion Plugin handles backend communication and is open source for review and custom integration.

The API is open for extension. You can build custom alert handlers, pipe detections into your own Discord bot, integrate with your ban database, or add your own checks on top of the rules layer. The closed part is the Engine. Everything built around it is yours to use.