DuckyAC

# 🦆 DuckyAC **DuckyAC** is a lightweight, modular, and fully configurable anti-cheat plugin for Spigot/Paper Minecraft servers. It detects unnatural player behavior in block placing, movement, and other interactions to effectively prevent cheating. > ✅ **Recommended**: Use **DuckyAC** in combination with **(https://www.spigotmc.org/resources/vulcan-anti-cheat-advanced-cheat-detection-1-8-1-21-5.83626/)** and **(https://modrinth.com/plugin/lightning-grim-anticheat)** for maximum cheat detection coverage. --- ## ⚙️ Features - 🔍 **Checks List**: - `AirJumpA`: Detects Jumping in air - `AirPlaceA`: Detects when player are building midair - `AutoTotemA`: Detects suspicious totem planting (beta check) - `AutoTrapA`: Detects suspicious trap placing - `BadPacketsA`: Detects abnormal yaw/pitch ratio (aim step / packet manipulation) - `ElytraAimA`: Player was detected to be hitting too fast while flying an elytra - `ElytraCriticalsA`: Detects when a player deals too much critical damage while flying an elytra in too short a time - `GroundSpoofA`: Detects when player is sending false information about his position - `FastClimbA-B`: Detects to fast player climbing on ladder, vines etc. - `FastPlaceA`: Detects when a player places too many blocks at a time - `FlyA`: Detects when player is flying *basic fly* - `InvalidPlaceA`: Detects when a player has placed a block at the wrong angle - `NoSlowDownA-G`: Many features of the player walking too fast during certain activities - `NoWebA`: Detects player movement that is too fast while in a web - `ReachA-B`: Detects when player is interacting with entities/blocks to far away his distance - `ThruBlocksA-B`: Detects when a player hits another player through a wall - `TimerA-D`: Detects when a player sends too many packets - 📉 Violation Level (VL) system for tracking repeated offenses - 🔧 Fully configurable thresholds, punishments, and enabled checks - 🛡 Permission-based bypass support (e.g., for admins) - 🔔 Alerts in chat and console to authorized staff (`duckyac.alerts`) - 📩 Discord webhook support for sending logs and punishments - 🧠 Config setting caching for performance optimization - 🔄 Optional command to reload config (`/duckyac reload`) --- ## 🧪 Sample Configuration (`config.yml`) ```yaml # === DUCKY ANTICHEAT CONFIGURATION === # All checks are listed alphabetically. Each check has a short English description above it. # Time after which a player's violations reset (in seconds). # Example: if a player gets 2 reports for a check, after this timeout their counter resets to 0. alert-timeout: 300 # === VIOLATION ALERT MESSAGE TEMPLATE === # Message format used when broadcasting alerts to staff / console. alert-message: "&d&lDuckyAC &8» &fPlayer &7»&f %player% &7»&6 %check% &7(&c%vl%VL&7)" # === CHECKS (alphabetically ordered) === # AIR JUMP A # Detects jumping in the air air-jump-a: enabled: true # Function to enable/disable check cancel-event: false # Enabling this feature will take you back to the position before reporting ignore-external-velocity: true min-upward-velocity-y: 0.25 detect-pressure-plates: true jumppad-plate-grace-ms: 450 min-horizontal: 0.02 external-velocity-grace-ms: 700 vertical-threshold: 0.3 damage-ignore-millis: 500 detect-wind-charge: true wind-charge-grace-ms: 900 ignore-potion-boost: false # Keep it false; it's a disabling player checking when player has Jump Boost effect max-alerts: 5 # Number of reports after which the command is executed command: "kick %player% Unnatural air jump detected (AirJumpA)" # The command that will be executed when the maximum number of reports is reached debug: false # Enable verbose debugging (may cause log spam / lag) # AIR PLACE A # Detects block placements in midair (no supporting blocks nearby). air-place-a: enabled: true # Function to enable/disable check cancel-event: true # Enabling this feature will take you back to the position before reporting max-alerts: 3 # Number of reports after which the command is executed command: "kick %player% Invalid block placement (AirPlaceA)" # The command that will be executed when the maximum number of reports is reached debug: false # Enable verbose debugging (may cause log spam / lag) # AUTO TOTEM A # Detects extremely fast totem swaps (auto totem macros). auto-totem-a: enabled: true # Function to enable/disable check min-delay: 150 # Minimum allowed swap interval in ms tick-interval: 3 max-ping: -1 max-alerts: 5 # Number of reports after which the command is executed command: "kick %player% Too fast totem swap (AutoTotemA)" # The command that will be executed when the maximum number of reports is reached debug: false # Enable verbose debugging (may cause log spam / lag) # AUTO TRAP A # Detects quick enclosing of a player with wood blocks and cobwebs (auto trap macros). auto-trap-a: enabled: true # Function to enable/disable check cancel-