VirgolaAntiCheat

️ VirgolaAntiCheat
Modern AntiCheat • Buffer-based • Lag Compensation • Staff Tools + GUI

️ Detects suspicious behavior and reports it to staff with a solid, lag-friendly approach to reduce false positives.
Every check is configurable and can be enabled/disabled via an in-game GUI (with file saving).

✨ Key Features

• Buffer + Violation Level (VL) system for gradual, consistent detections (less “random” flags).
  
  
• Lag Compensation based on ping and TPS (tunable in config.yml).
  
  
• Customizable staff alerts (messages.yml) + optional console logging.
  
  
• Management GUI to enable/disable checks live (saved in checks.yml).
  
  
• Staff tools: freeze, spectate, teleport, top violations, suspect list, staff broadcast.
  
  
• Bypass permission for trusted players or staff.
  

✅ Included Checks
(All configurable in checks.yml, with enabled toggle and dedicated tuning options)

• SPEED — detects abnormal ground movement speed (multipliers + grace).
  
  
• FLY — detects abnormal airborne movement / hovering.
  
  
• NOFALL — detects suspicious fall-damage behavior.
  
  
• JESUS — detects unnatural movement/walking on water.
  
  
• SCAFFOLD — detects suspicious block placement patterns while moving.
  
  
• KILLAURA — detects suspicious combat patterns.
  
  
• BADPACKETS — detects invalid/inconsistent packets (via PacketEvents).
  

Commands
Main command: /ac

• /ac help [command] — Shows all commands or details about a specific one.
  
  
• /ac alerts — Toggle receiving alerts (staff).
  
  
• /ac info <player> — Shows a player’s violations.
  
  
• /ac list — Lists online players with violations.
  
  
• /ac top — Top 10 players by violations.
  
  
• /ac freeze <player> — Freezes a suspicious player.
  
  
• /ac unfreeze <player> — Unfreezes a player.
  
  
• /ac spectate <player> — Enters spectator mode following the target.
  
  
• /ac unspectate — Exits spectator mode.
  
  
• /ac tp <player> — Teleports to a player.
  
  
• /ac broadcast <message> — Sends a message to online staff.
  
  
• /ac panel — Opens the checks management GUI.
  
  
• /ac reset <player|all> — Resets violations.
  
  
• /ac verbose — Toggles debug mode.
  
  
• /ac kick <player> [reason] — Kicks a player from the server.
  
  
• /ac ban <player> [reason] — Permanently bans a player.
  
  
• /ac reload — Reloads configuration files.
  

Permissions

• virgolaac.* — All plugin permissions (includes admin/staff/alerts/bypass).
  
  
• virgolaac.admin — Admin permissions (reload, reset, kick, ban, verbose, panel).
  
  
• virgolaac.staff — Staff tools (info, freeze, spectate, tp, top, list, broadcast).
  
  
• virgolaac.alerts — Receive in-game alerts.
  
  
• virgolaac.bypass — Bypass all checks.
  

Dependencies & Requirements

• REQUIRED dependency: PacketEvents (hard-depend).
  
  
• Server: recommended Paper 1.21.x (api-version 1.21).
  
  
• Java: 21+.
  

️ Installation

1. Install PacketEvents into your plugins folder.
   
   
2. Put VirgolaAntiCheat.jar into plugins.
   
   
3. Restart the server.
   
   
4. Configure the generated files:
   
   • config.yml (prefix, alerts, lag-compensation)
     
     
   • checks.yml (enabled + per-check parameters)
     
     
   • messages.yml (all messages and help text)
     
5. Use /ac reload to reload configs after edits.
   

Notes
This plugin was rebuilt from scratch with the goal of being clean, configurable, and more lag-friendly.
If you notice odd behavior or want to suggest improvements, please leave feedback in the comments/Discussion — reports help a lot to keep improving detection quality.