False-Positive Guide
Cheat detection is probabilistic. No anticheat can guarantee zero false positives; the goal is to catch real cheaters quickly while protecting legitimate players. This guide explains how to diagnose and reduce wrong detections.
1. Find the source
Look at the per-check table on the Analytics page:
- Checks with a high FP rate (above 10%) should be addressed first.
- If the violations by ping chart is concentrated at high ping, the cause is latency.
- If the violations by TPS chart clusters below 18 TPS, the cause is server lag.
2. Inspect the event
Click the suspicious row in the Live Feed. In the detail drawer:
- Is the deviation chart a single spike or consistently high? Single spikes are usually lag.
- Long gaps in the last 20 packets list (such as
+300ms) indicate packet loss. - If the VL progression rises slowly and sporadically, increasing the buffer may be enough.
3. Tune
| Symptom | Fix |
|---|---|
| One-off triggers | Increase buffer |
| VL accumulating over a long time | Increase decay |
| Triggers on a specific map or game mode | Add that world to exempt.worlds |
| Conflict with another plugin (e.g. jetpack, elytra boost) | Add the permission granting that ability to exempt.permissions |
| Generally too sensitive | Apply the Lenient profile or the one matching your game mode |
Make the changes on the Checks & Config page; use Review & Apply to see the diff and send it to the plugin instantly. If something goes wrong, roll back in one click from Version history.
4. Flag wrong punishments
On the Punishments page, click the flag icon next to a wrong punishment (Mark false positive). This:
- Revokes the punishment if it is active (the ban is lifted),
- Counts as a false positive in check statistics and shows up in analytics,
- Is recorded in the audit log.
5. Watch suspicious players
Instead of punishing players you are unsure about, mark them with Watch on their profile and follow their risk score. The risk score is computed from the highest VLs of the last 7 days, trigger frequency and anticheat punishments of the last 30 days.