Closure

Closure

Closure is a hybrid anti-cheat plugin currently in early Alpha. It attempts to solve a common problem in Minecraft server administration: the balance between blocking cheaters and not punishing legitimate players causing false positives due to lag.

Most anti-cheats rely solely on static thresholds (e.g., "if player moves > X speed, pull them back"). Closure adds a statistical layer to this process. It tracks player behavior over time—aim consistency, packet order, and movement patterns—to build a "confidence score."

This score doesn't ban players on its own. Instead, it adjusts the strictness of the core physics checks. If a player has a history of legitimate movement, the system grants them a small buffer to account for lag spikes. If a player shows robotic consistency or impossible reaction times, that buffer is removed, and enforcement becomes instant.

Current Features (Alpha)

* 1.21+ Support: Uses ProtocolLib to handle modern packet structures (including the new Velocity/Shorts format). * Shadow Player: A specialized verification check for KillAura. It spawns a fake player entity (visible in the tab list, wearing armor) that lunges at the suspect to trigger "self-defense" modules in clients that usually filter out static bots. * NoFall Logic: Calculates expected fall distance server-side rather than trusting the client's ground state, fixing false flags on stairs and ledges. * Ping Scaling: Checks automatically adjust thresholds based on the player's connection stability and server TPS.

Requirements

* Java 21 or newer. * ProtocolLib (Required for packet interception).

Roadmap to 1.0

This project is in active development. Features listed below are planned milestones before the first Stable release.

Alpha (Current State) * Core combat and movement checks are functional. * The "Shadow Player" verification entity is implemented. * Basic statistical profiling is active.

Beta (v0.5) * False Positive Freeze: A testing phase focused entirely on tuning thresholds with high player counts. * World Checks: Improved detection for Nuker and Scaffolding.

Release Candidate (v0.9) * API: Allowing other plugins to query a player's trust score. * Optimization: Threading improvements for high-population servers.

Stable (v1.0) * Full production release. * Codebase freeze and long-term support.

Disclaimer: As this is an Alpha release, it is intended for testing environments. While we have tested significantly against false positives, edge cases may still exist. Please report issues on the tracker.