Changelog (Italiano) — VirgolaAntiCheat
✅ Panoramica aggiornamento
Questa release è un
refactor strutturale +
rework di alcuni check con l’obiettivo di:
- ridurre falsi positivi (FP),
- rendere i check più consistenti tra loro,
- centralizzare integrazione (messaggi, log, warning, notify, config),
- rendere il tuning più semplice tramite checks.yml commentato e completo.
Sistema globale (messaggi, config, gestione eventi)
Nuovo standard di gestione alert / log / notify
Tutti i check interessati sono stati riallineati ad un formato unico e coerente:
- Messaggi via MessageManager con placeholders (player, check, details, valori tecnici ecc.)
- Alert staff centralizzati via AlertUtils (async dove possibile)
- ActionBar via ActionBarUtils
- Log coerente via LogManager usando generic.log-format
- Warning tramite InfractionManager (valore configurabile per check)
- Notifica al player tramite OffenderNotifyUtils.notifyDetect(...) (dove previsto)
- Cooldown anti-spam per alert staff configurabile per check
Nota: in diversi check la logica non cambia, ma cambia
tutto ciò che sta “intorno” (messaggi, log, warning, notify, scheduling), così da avere comportamento uniforme e facile da debuggare.
⚙️ checks.yml potenziato (versatilità + commenti)
- Aggiornato checks.yml con commenti in inglese per ogni singolo parametro
- Rimossi parametri obsoleti e aggiunti quelli mancanti per allineare i nuovi check
- Migliorata la granularità del tuning (grace, buffer/VL, decay, cap, finestre temporali, soglie, cooldown)
Check aggiornati (logica cambiata / rework)
Scaffold — Rework completo (nuovo approccio FP-safe)
- Eliminato l’approccio “singola prova forte” (es. raytrace come unico criterio)
- Nuova logica orientata a scaffold reale:
- sequenze di piazzamenti coerenti sotto il player,
- analisi in finestra temporale,
- pattern detection con buffer/VL e decadimento,
- filtri anti-FP (costruzione normale, piazzamenti non consecutivi, contesti legittimi)
- Parametri Scaffold aggiornati in checks.yml (nuova filosofia tuning)
InventoryWalk — Rework completo (nuovo sistema buffer/VL)
- Rimosso l’approccio basato su singoli eventi “movimento con GUI” troppo sensibile
- Nuovo sistema FP-safe:
- riconoscimento GUI attiva reale (inclusa la GUI inventario player quando possibile)
- finestra “GUI open grace” per pacchetti in volo
- buffer incrementale solo su movimento confermato
- decay intelligente (no GUI / grace / gap / contesti rischiosi)
- grace dopo knockback/velocity e dopo damage
- opzione per chiudere inventario su detect (di default OFF)
KillAura + Reach — Rework / integrazione Reach dentro KillAura
- KillAura rivisitata con un approccio più FP-safe:
- matching pacchetto↔evento con finestre tick/ms
- tolleranze su hitbox/ray/AABB per desync
- gestione ping/TPS (skip check in condizioni rischiose)
- VL con cap/decay/post-alert reduce
- Reach: rimosso come check standalone, ma mantenuti i riferimenti necessari per integrarlo dentro KillAura (incluse eccezioni legittime come tridente)
Check aggiornati (logica simile, ma integrazione nuova)
Questi check
non cambiano nel cuore della logica, ma sono stati aggiornati per essere coerenti con il nuovo sistema (messaggi/log/warning/notify/config/cooldown).
Fly — Integrazione standardizzata
- Alert e dettagli via MessageManager
- Warning e log uniformati
- Tuning completo in checks.yml con parametri VL/decay/soglie/cooldown
NoFall — Integrazione standardizzata
- Sistema alert/log/warning/notify reso coerente con gli altri check
- Tutti i parametri rilevanti esposti in checks.yml e documentati
Jesus — Integrazione standardizzata
- Alert/actionbar/log/warning uniformati e configurabili
- Parametri in checks.yml con commenti
Speed — Integrazione standardizzata
- Stesso formato alert/log/warning/notify degli altri check
- Config tuning coerente (tolerance, post landing buffer, cooldown, warning)
⛏ FastBreak — Integrazione e configurazione coerente
- Parametri di precisione e sicurezza FP esposti in checks.yml
- Sistema VL/cooldown/post-alert reduce documentato
FastPlace — configurazione espansa (preparazione al rework)
- checks.yml aggiornato per includere tuning più completo
- Obiettivo: ridurre FP e gestire “burst” e spam legit/lag in modo controllato
(il rework di logica viene fatto nello step successivo)
Pulizia progetto / rimozioni
- Rimossi check inutili:
- ClickPattern eliminato
- Reach eliminato come check separato (resta integrato nella KillAura)
- Verificati e ripuliti riferimenti residui alle parti eliminate, mantenendo solo quelli necessari per la Reach dentro KillAura.
⚠️ Nota importante (feedback richiesto)
Questa release introduce cambiamenti profondi. Anche se l’obiettivo è FP-safe, alcuni server possono avere edge case a causa di:
- TPS fluttuante,
- ping alto,
- plugin di movimento/combat/build,
- meccaniche particolari di bridging/building.
Se riscontrate problemi, lasciate un commento su Spigot includendo:
- versione server (Paper/Spigot) + versione MC,
- TPS medio,
- ping medio,
- contesto (pvp/build/bridging),
- log del detect (se possibile).
Changelog (English) — VirgolaAntiCheat
✅ Update overview
This release is a
structural refactor +
several check rewrites, focused on:
- reducing false positives,
- making every check consistent and easier to tune,
- centralizing integration (messages, logs, warnings, notify, config),
- improving checks.yml versatility with full English documentation.
Global system (messages, config, event handling)
Unified alert / log / notify system
All updated checks now follow the same integration standard:
- Messages handled by MessageManager with placeholders (player, check, details, etc.)
- Staff alerts through AlertUtils (async when possible)
- ActionBar via ActionBarUtils
- Logs standardized using LogManager + generic.log-format
- Warnings through InfractionManager (per-check configurable)
- Player notification via OffenderNotifyUtils.notifyDetect(...) (where applicable)
- Per-check cooldown to prevent alert spam
⚙️ Improved checks.yml (more versatile + fully commented)
- Updated checks.yml with English comments for every parameter
- Removed obsolete keys and added missing ones
- Much better tuning control (grace windows, buffer/VL, decay, caps, time windows, thresholds, cooldowns)
Checks updated (logic reworked)
Scaffold — Full rewrite (FP-safe but strong)
- Moved away from “single strong proof” logic (raytrace-only style)
- New scaffold-oriented detection:
- consistent “under-feet” placement sequences,
- time-window evaluation,
- buffer/VL accumulation + decay,
- FP filters for legit building and inconsistent patterns
- Updated Scaffold config keys in checks.yml
InventoryWalk — Full rewrite (buffer/VL system)
- Removed overly sensitive “GUI movement = instant flag” behavior
- New FP-safe system:
- real GUI detection (including player inventory when possible),
- GUI open grace window to handle in-flight packets,
- buffer gain only on confirmed movement,
- smart decay (no GUI / grace / timing gaps / risky contexts),
- velocity/damage grace windows,
- optional inventory-close on detect (default OFF)
KillAura + Reach — Rewrite / Reach integrated into KillAura
- Safer KillAura approach:
- packet↔event matching windows (ticks/ms),
- AABB/ray tolerances for desync,
- ping/TPS safety skipping,
- VL with cap/decay/post-alert reduction
- Reach removed as standalone, but kept as a module integrated inside KillAura (including legit bonuses like trident)
Checks updated (logic mostly same, integration upgraded)
Fly — Integration standardized
- MessageManager alerts + details
- Standard logs/warnings
- Full tuning via checks.yml (VL/decay/thresholds/cooldown)
NoFall — Integration standardized
- Unified alert/log/warning/notify flow
- All tuning exposed and documented in checks.yml
Jesus — Integration standardized
- Unified alerts/actionbar/log/warning
- Tunable parameters in checks.yml
Speed — Integration standardized
- Same alert/log/warning/notify flow as other checks
- Config tuning aligned (tolerance, post landing buffer, cooldown, warning)
⛏ FastBreak — Integration + config consistency
- Precision + FP-safety parameters exposed in checks.yml
- VL/cooldown/post-alert reduction fully documented
FastPlace — Expanded config (rework-ready)
- checks.yml expanded to support a safer/stronger FastPlace logic
- Next step is code rework (config already ready)
Cleanup / removals
- Removed unused checks:
- ClickPattern removed
- Reach removed as standalone (kept only as KillAura sub-module)
- Cleaned leftover references (keeping only Reach-related parts used by KillAura).
⚠️ Important note (feedback requested)
This update introduces deep changes. While everything is designed to be FP-safe, some server setups can still hit edge cases due to:
- unstable TPS,
- high ping,
- movement/combat/build plugins,
- unusual bridging/build patterns.
Please comment on the Spigot page if you find issues, including:
- server software + MC version,
- average TPS,
- average ping,
- context (pvp/build/bridging),
- detect logs if possible.