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.