Orion DoubleClick Prevent (ODCP)
Version: V 2.0.4
Minecraft Version: 1.20.2
Author: DarkStray | CharismaNW

Plugin Overview
Orion DoubleClick Prevent (ODCP) is a more advanced anti-cheat plugin designed to detect and punish cheating through auto-clickers, double-clicking, and most click-based macros on your server. It is primarily intended for PvP, though it also calculates for PvE and "air" clicks.

ODCP analyzes left and right-click events separately, providing more accurate detection. It also features a Certainty System that accounts for server tick stability and player ping variations* to reduce the risk of false positives.

With fully configurable kick and ban thresholds, as well as detailed kick/ban messages, ODCP offers an effective and flexible solution for server admins to moderate click-based behavior in a fair and clear way.

Key Features

• Click Detection
  Detects automated clicking tools and macros that provide players with an unfair advantage in Player vs Player gameplay, ensuring that players using these cheats are kicked or banned from the server. Additionally, it detects double clicks from mouse inputs that give an unfair advantage, identifying suspicious behavior not by Clicks Per Second, but by the timing and relationship of the clicks to each other.
  
  
• Left/Right Click Separation
  Tracks and processes left and right-clicks separately, allowing the plugin to identify and handle cheaters who might exploit only one of these click types (e.g., right-clicks) while ignoring the other (left-clicks).
  
  
• Advanced Click Detection System
  Tracks click timings, speeds, and frequencies to accurately differentiate between normal and suspicious clicking patterns, ensuring cheaters are flagged with precision.
  
  
• Server-Based Certainty (Tick Stability)
  The certainty system accounts for server tick stability, reducing the likelihood of false positives that might occur due to server lag or desynchronization between the client and server. This ensures a player is not falsely banned due to server lag causing an increase of delayed packets.
  
  
• Player-Based Certainty (Ping)
  While this does not affect ban/kick decisions, the plugin tracks ping and network performance to provide certainty data to moderators. This helps them understand if network issues contributed to a player’s behavior, offering context to their decision-making process. (e.g. a player experiences packet loss/delay through their ISP causing all clicks to happen at once)
  
  
• Customizable Kick/Ban Thresholds
  Admins can configure custom thresholds for both kicks and bans, based on double-click percentages. The thresholds are adjustable in the plugin's configuration file, giving admins full control over when to kick and/or ban players.
  
  
• Detailed Ban/Kick Messages
  When a player is kicked or banned, ODCP sends an informative message, including details about the player's click percentages, certainty ratings, and the specific reason for their ban or kick including Left or Right.
  
  
• Easy YML Configuration
  The plugin is fully customizable through a simple YML configuration file. Admins can adjust click thresholds, messages, and debugging options easily to fit their server's needs.
  
  
• PvP and PvE Compatibility
  While intended for PvP servers, ODCP is also suitable for PvE servers, ensuring that the plugin doesn't interfere with other types of gameplay (e.g., building or Player v Entity).
  
  
• Undiscriminatory
  The plugin ensures a completely fair environment by not allowing any exceptions, there are no back-end options for whitelisting players or staff members. This means all players are subject to the same click detection rules, ensuring that no player, regardless of status, is able to bypass the system. The goal is to create a fair playing field where automated clicking tools, macros, and unfair advantages are prevented without discrimination.
  
  

Commands - None

• /odcp (Status) # Debug Mode
  Toggles debug mode for the player executing the command. When enabled, debug messages will appear in the player's chat, which is useful for real-time troubleshooting and testing the plugin's detection accuracy.
  Usage: /odcp
  WHEN ENABLED ALL PLAYERS CAN RUN COMMAND
  

Configuration (config.yml)
The configuration file allows full customization of the plugin's behavior, including thresholds for kicks and bans, the debug mode, and much more:

• DoubleClickCPS: Sets the threshold for detecting double-clicks (in CPS). e.g "20" the amount of CPS that is seen as the absolute limit
  
  
• ClickCheck: Configures how many clicks the plugin should track per player. e.g "100" will track 100 clicks before the plugin decides to ban a player

• Plugin Handles Bans: Defines whether the plugin should handle bans automatically or leave it to server admins.
  
  
• DoubleClickKick/DoubleClickBan: Set the percentage of disallowed clicks that trigger kicks or bans. e.g Kick = 50 - Ban = 80 if disallowed clicks are between 50-79% of all clicks the player gets kicked and 80-100 they receive a ban
  
  
• Debug Mode: Enables detailed debug messages for testing purposes.
  
  
• Certainty Allowed: Minimum Server Certainty for clicks to count towards a player. e.g "80"% the server must have a certainty of 80% stability to count clicks towards a player

Bugs & Fixes
(1.0.0) FIXED - False flags during server lag due to the server certainty system.
(2.0.2) FIXED - Right-clicks triggering left-click detection due to animation checks.
(2.0.3) FIXED - Bug where attacking an entity sometimes caused two clicks to be detected.
(2.0.4) FIXED - Ban percentage requirement was not properly enforced.

Changelog

• Update 2.0.1
  • Fixed issues related to click delays after adding certainty systems.
  • Resolved bug where right-click inputs were mistakenly counted as left-clicks.
  
  
• Update 2.0.2
  • Minor tweaks to messages for clarity.
  • Minor bug fixes

• Update 2.0.3
  • Fixed bug that caused double clicks when interacting with entities.
  
  
• Update 2.0.4
  • Fixed issues with kick/ban logic and added more context to debug messages.
  • Updated configuration file for improved clarity and usability.
  • Corrected minor spelling errors.