⚠️ Important Notice:
This plugin has a
soft dependency on
ProtocolLib.
If ProtocolLib is installed, several checks (e.g., Reach, KillAura, AutoClicker, etc.) will work with greater accuracy and advanced packet analysis.
However, the plugin remains fully functional even without ProtocolLib, using standard Bukkit event listeners as a fallback.
Changelog
General / Infrastructure
- Soft ProtocolLib Integration:
All relevant checks can use ProtocolLib for precise packet-level detection. If ProtocolLib is missing, Bukkit events are used instead.
- Thread Safety & Async Refactoring:
Time-consuming and database-related actions run asynchronously to prevent lag; all Bukkit API calls are scheduled on the main thread.
ReachCheck
- Standalone Reach Check:
The reach check was separated from KillAura and is now a dedicated class.
- ProtocolLib Support:
Intercepts USE_ENTITY packets for precise reach detection and validation.
- Cooldown System:
Per-player cooldowns prevent alert spamming.
- Message Variable Consistency:
Alerts, logs, and action bar messages now use unified variables.
- Bukkit Fallback:
If ProtocolLib isn’t present, falls back to Bukkit’s EntityDamageByEntityEvent.
- Permission & GameMode Bypass:
Added to avoid false positives and unwanted alerts.
KillAuraCheck
- Reach Detection Removed:
All logic related to reach distance moved to the new ReachCheck.
- Packet-based Orientation Checks:
Now focuses only on orientation, dot product, angle, and yaw difference checks for legit aim detection.
- Cooldown System:
Alert spam protection implemented.
- Optimized Async Handling:
All heavy processing moved async, with alerts and player actions on the main thread.
- Unified Message System:
All alerts and logs use standardized placeholders.
AutoClickerCheck
- ProtocolLib Support Improved:
Added/Fixed packet-based detection for higher reliability with ProtocolLib.
- Bugfix:
Fixed an issue where the check would not trigger or would produce false negatives.
- Cooldowns & Thread Safety:
All detection logic now thread-safe and rate-limited per player.
- Clean Alert & Logging:
Unified with other checks for format and clarity.
SpeedCheck
- Detection Logic Improved:
- Fixed major bug where speed wasn’t being calculated correctly (false positives/negatives).
- Now properly considers potion effects, enchantments, slippery surfaces (e.g. ice), and special jump cases.
- ProtocolLib Support:
Now uses movement packet analysis where possible.
- Cooldown & Alert Refactoring:
Cooldown, alert, and action bar systems now match other checks for consistency.
FastPlaceCheck
- Detection Logic Refined:
- Improved detection window and false positive handling.
- Now accurately counts block placements and checks timing.
- ProtocolLib Support:
Now can use packet-level placement events.
- Async & Cooldown:
All detection runs async where possible, cooldown per player.
- Message Consistency:
Alerts and logs follow standard format.
FastBreakCheck
- Detection Logic Completely Overhauled:
- Mining speed checks now factor in tool, enchantments, potion effects, and block type.
- Avoids hardcoded lists by using Minecraft’s own checks wherever possible.
- Bugfix:
Previously detected block breaking was too strict or too lax; fixed for much more accurate, real-world behaviour.
- ProtocolLib Support:
Packet-based mining tracking now available when ProtocolLib is present.
- Async Processing:
Expensive operations are performed async, with warnings/alerts dispatched safely.
- Cooldown & Thread Safety:
Improved for reliability under high activity.
Miscellaneous / Shared
- Unified Variable & Logging System:
All checks now use a consistent approach to variables and logging for easier staff review and debugging.
- Bypass Permission & Creative/Spectator Skip:
All checks ignore users in creative/spectator or with admin bypass permission.
- Message Manager Usage:
All player-facing messages and logs now use the plugin’s MessageManager for consistent prefixes, translations, and placeholder expansion.
Summary:
- ProtocolLib is supported for high-precision packet checks but not required.
- All major checks (Reach, KillAura, AutoClicker, Speed, FastPlace, FastBreak) have been reworked, improved, or fixed.
- Major bugs affecting AutoClicker, Speed, FastPlace, and FastBreak were resolved.
- Code is now fully async/thread safe, all alerts/logs use consistent messages, and the plugin is more stable than ever.