FairPlay
Combat AntiCheat for PvP, Survival, SMP, Practice, Factions, and competitive Minecraft networks
100+ checks. GrimAC hook. PacketEvents-powered packet tracking. Aimbot, AutoClicker, Scaffold, Hitbox, Reach, Occlusion, FastBreak, Inventory, KillAura, AutoTotem, Timer, mitigation, machine-learning models, and full admin control.
Bukkit • Spigot • Paper • Purpur • Folia • PacketEvents • GrimAC Hook • Vulcan Hook
What is FairPlay?
FairPlay is a revolutionary combat-focused Minecraft anticheat built for servers that care about PvP integrity, clean alerts, configurable punishments, and real mitigation instead of only passive flagging.
It combines many detection layers: rotation analysis, click-pattern analysis, scaffold placement checks, hitbox cone/reach/occlusion validation, fast-break timing, inventory movement checks, KillAura heuristics, AutoTotem detection, and PacketEvents-based packet handling.
FairPlay is designed to work alongside GrimAC / Vulcan. Grim remains for movement/prediction checks, while FairPlay adds combat, aim, scaffold, autoclicker, mitigation, and admin workflow layers around it.
Result: keep Grim / Vulcan for movement checks, add FairPlay for combat checks, scaffold prevention, click analysis, hitbox validation, and configurable enforcement.
Dependency Stack
- PacketEvents required: FairPlay uses PacketEvents for packet-level player actions, swings, block interactions, movements, digging, inventory events, and protocol-aware processing.
- GrimAC optional hook: FairPlay can listen to Grim flags and apply FairPlay compensation or punishment rules based on Grim check patterns.
- PlaceholderAPI optional: menu and text placeholders can be resolved when PlaceholderAPI is installed.
- Folia-aware scheduling: internal task scheduling uses Folia-safe bridge logic where region/entity/global ownership matters.
Install PacketEvents before FairPlay. Install GrimAC when you want the Grim hook and movement-side synergy.
Main Feature Set
- 108+ FairCheck-backed detection: organized into aimbot, autoclicker, scaffold, hitbox, fastbreak, inventory, killaura, autototem, timer, and invalid-place categories.
- Aimbot detection: rotation grids, divisor flaws, step ratios, smoothness, entropy, duplicate rotation signatures, target-offset patterns, ML model confidence, and hit-rotation checks.
- AutoClicker detection: CPS caps, interval stability, phase locks, delay skewness, rounded CPS, spike detection, distinct delay counts, hit/miss consistency, and ML click models.
- Scaffold detection: block-place timing, right-click patterns, rotation consistency, safewalk/eagle behavior, sneak acceleration, impossible place, face-value patterns, and fast placement.
- Hitbox checks: cone validation, reach distance validation, and block occlusion checks using server-side geometry and cached world/block information.
- FastBreak checks: expected break-time validation, sequence tracking, and nuker burst detection.
- Inventory checks: inventory movement while moving, inventory action timing, open-inventory movement, and chest-stealer style interactions.
- Mitigation system: reduce damage, cancel hits, increase reach for victims, disable block placement, notify staff, execute commands, and centralize punishments.
- Global punishments: punishments.yml can define shared punishment tiers used by all checks unless a specific check overrides them.
- Machine-learning workflow: model registry, training commands, window recording, model enable/disable/reload, and separate aim/click model pipelines.
Checks Included
- AimbotAxisMagnitude: checks abnormal yaw/pitch axis magnitude relationships.
- AimbotCope: catches unnatural rotation correction behavior across movement samples.
- AimbotConsistency: detects suspiciously consistent aim movement over repeated rotations.
- AimbotDivisor: checks divisor/grid artifacts created by artificial mouse rotation systems.
- AimbotDrip: detects rotation patterns that remain too clean across changing aim conditions.
- AimbotDuplication: catches repeated or duplicated rotation deltas that do not look human.
- AimbotEntropySignature: evaluates rotation entropy signatures for low-randomness aim behavior.
- AimbotFactorCheck: checks mathematical factor patterns in aim movement.
- AimbotGeneric: general-purpose aim heuristic combining movement and hit context.
- AimbotHeadSpazz: detects extreme or unstable head movement spikes.
- AimbotHitRotation: validates rotation state around attack moments.
- AimbotIdentical: flags identical or near-identical rotation outputs across repeated samples.
- AimbotInputModelInstability: detects unstable rotation behavior inconsistent with normal input movement.
- AimbotIntegerSteps: catches integer-step / grid-step rotation behavior.
- AimbotInvalidCheck: detects invalid rotation sequences from impossible or non-human aim updates.
- AimbotInvalidSmooth: flags smoothness patterns that are mathematically too artificial.
- AimbotKitten: rotation heuristic targeting small unnatural correction patterns.
- AimbotLiquid: checks aim behavior under liquid/movement-influenced conditions.
- AimbotLook: verifies player look behavior around target interaction and combat context.
- AimbotMachineLearning: evaluates aim windows against compiled machine-learning models.
- AimbotMouseDeltaEnclosedInvalid: detects enclosed mouse-delta values that should not appear in normal rotation flow.
- AimbotMouseDeltaOffGrid: catches mouse-delta values that do not fit expected input grids.
- AimbotNonLinearRotation: flags non-linear rotation curves that match automation more than hand movement.
- AimbotOmniRatioIqr: checks ratio/IQR statistics across multiple rotation dimensions.
- AimbotPitchStepRatio: detects abnormal pitch step relationships.
- AimbotPreciseNaNWindow: guards against invalid or impossible precision windows.
- AimbotRandomization: detects fake randomization patterns in aim changes.
- AimbotRandomizerFlawCheck: catches randomizer flaws that repeat or distribute unnaturally.
- AimbotRateJolt: detects sudden rate jolts in rotation movement.
- AimbotRatio: checks yaw/pitch ratio patterns against expected human input.
- AimbotRotationSnap: catches snap-like rotations toward targets.
- AimbotSmallPitchLattice: detects small pitch lattice/grid artifacts.
- AimbotSmoothAccelerationStats: analyzes acceleration smoothness statistics.
- AimbotSmoothCheck: catches suspicious smooth aim paths.
- AimbotSnapLock: detects snap-and-lock target behavior.
- AimbotStableAcceleration: flags acceleration that is too stable for normal mouse input.
- AimbotStatsImprobable: statistical improbable-rotation detector.
- AimbotStepModulo: detects modulo artifacts in aim stepping.
- AimbotStepQuotient: detects quotient/step relationships common in generated rotations.
- AimbotSymmetricSmooth: catches symmetrical smoothing that looks algorithmic.
- AimbotTargetOffset: checks suspicious target offset and aim placement patterns.
- AimbotWater: validates aim behavior while water or movement environment affects the player.
- AimbotYawDiffSet: checks repeated yaw-difference sets.
- AimbotYawStepRatio: detects abnormal yaw step ratios.
- AimbotZScorePair: uses paired z-score analysis on aim data.
- AutoClickerCpsLimits: flags CPS above configured human limits.
- AutoClickerCpsSpikes: detects unnatural CPS bursts and short-window spikes.
- AutoClickerDelaySkewness: checks click-delay skewness for synthetic timing.
- AutoClickerDistinctDelays: detects too few distinct delays in click intervals.
- AutoClickerHitMissConsistency: compares hit/miss patterns against expected human click behavior.
- AutoClickerIntervalStability: flags overly stable click intervals.
- AutoClickerMachineLearning: evaluates click windows through compiled ML models.
- AutoClickerOutliers: catches click-window outlier behavior.
- AutoClickerPatternStats: analyzes click timing statistics and pattern regularity.
- AutoClickerPhaseLock: detects click timing that locks to a repeating phase.
- AutoClickerRoundedCps: catches suspicious rounded CPS values.
- AutoClickerTickSequence: detects repeated tick-aligned click sequences.
- ScaffoldAcceleration: checks acceleration behavior during scaffold placement.
- ScaffoldAngle: validates placement angle behavior.
- ScaffoldAutoSneak: detects repeated auto-sneak/safewalk edge activation at near-identical block-relative positions.
- ScaffoldAverage: analyzes average rotation/placement behavior during bridging.
- ScaffoldBridgeBalance: checks bridge movement balance and placement rhythm.
- ScaffoldCardinalDistance: detects suspicious cardinal block-distance placement patterns.
- ScaffoldClickPattern: analyzes click timing and movement around placements.
- ScaffoldCoreFilter: central scaffold pre-filter for placement context quality.
- ScaffoldDelayVariance: detects low variance between block placement delays.
- ScaffoldEagle: detects repeated perfect eagle/safewalk-like horizontal below-feet placements within configurable time windows.
- ScaffoldFace: checks invalid or suspicious block-face placement behavior.
- ScaffoldFaceValue: validates face-value patterns on block placement.
- ScaffoldFastPlace: flags block placements that happen too quickly.
- ScaffoldFastToolSwitch: detects fast tool/item switching around scaffold placement.
- ScaffoldImpossiblePlace: catches placements that should not be possible from current context.
- ScaffoldInsidePlace: detects block placements intersecting invalid/inside-player contexts.
- ScaffoldInteractBelow: checks suspicious below-player interaction patterns.
- ScaffoldInvalidPlace: validates impossible or illegal placed/clicked block combinations.
- ScaffoldJumping: detects suspicious jumping behavior while scaffold placing.
- ScaffoldNoDecel: catches no-deceleration behavior during placement.
- ScaffoldPlaceBurst: detects burst placement sequences.
- ScaffoldPosition: validates player position relative to placed block.
- ScaffoldPostSwing: checks arm-swing timing around scaffold placement.
- ScaffoldRapidRotations: detects rapid rotation changes near placements.
- ScaffoldRepeatedPitch: flags repeated pitch values used by scaffold modules.
- ScaffoldRightClickPattern: analyzes repeated right-click patterns while bridging.
- ScaffoldRotation: rotation-focused scaffold check; designed as a sensitive configurable check.
- ScaffoldRotationCombo: combines rotation indicators around block placement.
- ScaffoldRotationGcd: checks GCD/grid artifacts in scaffold rotations.
- ScaffoldSafewalkEdge: detects edge-walk behavior consistent with safewalk/eagle automation.
- ScaffoldSafewalkTiming: checks timing of safewalk-like placement patterns.
- ScaffoldSneakAcceleration: detects acceleration changes while sneaking during scaffold placement.
- ScaffoldSneakSpeed: validates speed while sneaking and placing.
- ScaffoldSprinting: detects suspicious sprinting behavior during scaffold placement.
- ScaffoldStraightWalk: checks unusually straight bridge movement.
- ScaffoldZeroYawHighPitch: flags suspicious high-pitch/zero-yaw style placements.
- HitboxCone: verifies the attacker is approximately looking toward the target before deeper hitbox analysis.
- HitboxReach: checks nearest eye-to-target-hitbox distance instead of relying only on raw yaw/pitch.
- HitboxOcclusion: detects attacks through blocks using server-side cached block geometry and target visibility sampling.
- FastBreakExpectedTime: compares break time against expected block/tool/enchantment timing.
- FastBreakNukerBurst: detects burst-like multi-block break behavior.
- FastBreakSequence: tracks digging sequence consistency and invalid break ordering.
- InventoryManager: manages inventory-related movement/click detection state.
- InventoryMoveAction: detects suspicious actions while moving with inventory interactions.
- InventoryMoveOpen: checks movement while inventory is open.
- InventoryStealer: detects chest-stealer style fast inventory interactions.
- FPKillAuraA: KillAura heuristic using movement and arm-swing context.
- AutoTotemA: detects suspicious totem swap/resurrection inventory behavior.
- InvalidPlace: detects invalid block placement behavior outside scaffold-specific checks.
- SwingTimer: timer-style swing rhythm detector using damage and arm-swing timing.
Configuration Files
FairPlay is configuration-first. Global options live in root config files; every check gets its own YAML file under the check folder.
- config.yml: global notifications, actionbar toggle, combat compensation, client tick sync, block-registry debug, scaffold debug, Grim hook rules, whitelist, and storage.
- punishments.yml: global punishment tiers used by all checks unless a check-specific punishment override is enabled.
- snapshot.yml: virtual world snapshot / subchunk capture configuration.
- lang/commands.yml: command messages.
- lang/menus.yml: menu text and menu formatting.
- storage/players: YAML player storage when YAML storage mode is selected.
- models/: compiled model files copied from the jar.
- training/: training data and model datasets for aim/click pipelines.
- check/aimbot/fp/*.yml: FairPlay aimbot checks, including machine learning, look, hit rotation, axis magnitude, snap lock, duplication, and consistency.
- check/aimbot/ar/*.yml: advanced rotation/statistical aimbot checks.
- check/aimbot/ff/*.yml: fast/factor rotation checks such as snap, integer steps, acceleration, and target offset.
- check/aimbot/mp/*.yml: multi-pattern aimbot checks using entropy, ratio, IQR, z-score, and heuristic subfamilies.
- check/aimbot/so/*.yml: step/order aimbot checks such as yaw/pitch ratios, modulo, quotient, lattice, and nonlinear motion.
- check/autoclicker/fp/*.yml: CPS limits, interval stability, phase lock, pattern stats, and click ML.
- check/autoclicker/kh/*.yml: tick-sequence click checks.
- check/autoclicker/kr/*.yml: hit/miss click consistency.
- check/autoclicker/vc/*.yml: delay skewness, outliers, distinct delays, CPS spikes, and rounded CPS.
- check/hitbox/fp/*.yml: HitboxCone, HitboxReach, and HitboxOcclusion.
- check/scaffold/fp/*.yml: ScaffoldAutoSneak, ScaffoldDelayVariance, and ScaffoldEagle.
- check/scaffold/aa/*.yml: angle, face, position, rotation, safewalk, average, core filter, jumping, and sprinting scaffold checks.
- check/scaffold/kh/*.yml: block-place, click-pattern, invalid-place, no-deceleration, post-swing, and rotation-combo scaffold checks.
- check/scaffold/vc/*.yml: cardinal distance, interact-below, place burst, rapid rotations, rotation GCD, and sneak speed.
- check/scaffold/ho/*.yml: acceleration and sneak-acceleration scaffold checks.
- check/scaffold/ncp/*.yml: fast tool-switch scaffold checks.
- check/scaffold/ta/*.yml: straight-walk scaffold checks.
- check/fastbreak/fp/*.yml: expected break time, nuker burst, and dig sequence checks.
- check/inventory/*.yml: inventory manager, move action, move open, and chest stealer checks.
- check/killaura/FPKillAuraA.yml: KillAura check configuration.
- check/autototem/FPAutoTotemA.yml: AutoTotem configuration.
- check/place/fp/InvalidPlace.yml: invalid place configuration.
- check/timer/fp/SwingTimer.yml: swing timer configuration.
- Global punishment tiers: configure VL thresholds once in punishments.yml.
- Local override support: each check can override global punishments when its local punishment section is enabled.
- Damage reduction: reduce damage from suspected cheaters temporarily.
- Hit cancellation: cancel attacks during active mitigation windows.
- Reach compensation: allow victims to counter-hit suspected cheaters during configured mitigation windows.
- Block-place prevention: temporarily prevent block placement after scaffold/block-place flags.
- Staff notifications: notify players with fairplay.notify.
- Commands: execute configured commands at chosen VL thresholds.
- Hover/debug variables: violation alerts can include detailed variables for tuning and false-positive diagnosis.
GrimAC Integration
FairPlay includes a Grim hook designed to turn Grim flags into FairPlay-side mitigation and alert behavior.
- Configurable Grim trigger rules: match Grim checks by name, stable key, include patterns, and exclude patterns.
- VL floor logic: prevent repeated duplicate actions unless Grim VL meaningfully increases.
- Combat compensation: Grim aim/reach/killaura-style flags can activate FairPlay reach increase, hit cancellation, damage reduction, or notifications.
- Hook priority control: configure the Bukkit event priority used for Grim FlagEvent reflection.
- Safe optional dependency: FairPlay still loads when GrimAC is absent; the hook starts only when Grim is installed and enabled.
Machine Learning Tools
FairPlay includes machine-learning workflows for aim and click detection.
- AimbotMachineLearning: aim model confidence and model ensemble evaluation.
- AutoClickerMachineLearning: click model confidence and click-window evaluation.
- Training data storage: training datasets for aim and click samples.
- Model registry: compiled models can be enabled, disabled, toggled, deleted, listed, and reloaded.
- Window recording: record legit or cheat windows for later model compilation.
- Admin commands: /fp ml gives staff access to model status, confidence, window management, and compile tools.
Commands and Permissions
- /fairplay: main command.
- /fp: short alias.
- /anticheat: alternate alias.
- /fp reload: reload configuration.
- /fp checks: inspect registered checks.
- /fp toggle: toggle checks.
- /fp alerts: manage personal alert state.
- /fp ml: manage ML datasets, models, confidence, windows, and compilation.
- /fp menu: open FairPlay menu tools.
- /fp punishments: inspect punishment behavior.
- /fp kick: kick action command branch.
- /fp damagecancel: toggle damage-cancel compensation.
- /fp blockcancel: toggle block-place prevention compensation.
- fairplay.admin: full admin access.
- fairplay.command: base command access.
- fairplay.train: training session and pending-data access.
- fairplay.check: inspect player violation status.
- fairplay.notify: receive alerts.
- fairplay.command.ml: ML command access.
- fairplay.command.damagecancel: damage-cancel toggle access.
- fairplay.command.blockcancel: block-cancel toggle access.
- fairplay.exempt: bypass all anticheat checks.
Combat Protection Philosophy
FairPlay is not only an alert spammer. It is designed to react to combat abuse while keeping server owners in control.
- Detect: analyze packets, rotations, clicks, hits, places, and movement context.
- Notify: alert staff with configurable debug data.
- Mitigate: reduce damage, cancel hits, block follow-up block placements, and compensate victims.
- Tune: adjust every check file, global punishments, Grim trigger rules, and debug output.
- Observe: use actionbar, hover debug, console debug, and check variables to tune thresholds.
Why Choose FairPlay?
- Combat-first anti-cheat layer: focuses on PvP abuse: aim, autoclicking, hitbox abuse, reach, scaffold, and combat mitigation.
- Pairs with GrimAC: use Grim for movement prediction and FairPlay for combat/scaffold/click pressure.
- PacketEvents-powered: reads important player actions from protocol-level packet data.
- Massive check coverage: 100+ checks across major PvP cheat categories.
- Global punishment system: reduce duplicated config and keep enforcement consistent.
- Per-check control: every check still has its own YAML for thresholds, debug, and local overrides.
- Machine-learning support: aim and click ML model workflows for advanced detection.
- Folia-aware internals: designed with threaded server constraints in mind.
- Debuggable by design: hover details and tuning variables help server owners understand flags.
FAQ
Does FairPlay require PacketEvents?
Yes. PacketEvents is required.
Does FairPlay require GrimAC?
No. GrimAC is optional, but recommended when you want the Grim hook and movement checks.
Is this only a combat anticheat?
FairPlay is combat-focused, but it also includes scaffold, fastbreak, inventory, invalid-place, timer, autototem, and Grim hook systems.
How many checks are included?
The analyzed source contains 107 FairCheck-backed checks. The product can safely be described as 100+ checks.
Can I configure every check?
Yes. Each check has its own YAML configuration under the check folder, and global punishments can be reused by all checks.
Can I disable a single check?
Yes. Checks are individually configurable and can be managed through command/config workflows.
Can FairPlay punish automatically?
Yes. Punishments can notify, reduce damage, cancel hits, disable blocks, increase victim reach compensation, run commands, or kick based on configured VL thresholds.
Does it support ML?
Yes. FairPlay includes aim and click machine-learning model registries, training data, confidence commands, and model management tools.
Does it support PlaceholderAPI?
PlaceholderAPI is optional and used where placeholder-formatted text is supported.
Is it Folia-ready?
The source includes Folia-aware scheduling paths and Folia-safe task handling. Always test your exact server stack before production rollout.
Stop combat abuse before it controls your server.
Install PacketEvents, add GrimAC if desired, configure FairPlay, and give staff a deep combat anticheat with real mitigation, alerts, and tuning tools.
Install PacketEvents, add GrimAC if desired, configure FairPlay, and give staff a deep combat anticheat with real mitigation, alerts, and tuning tools.
SEO keywords: FairPlay anticheat, Minecraft combat anticheat, Minecraft PvP anticheat, PacketEvents anticheat, GrimAC hook, Grim anticheat addon, Minecraft aimbot check, Minecraft autoclicker check, Minecraft scaffold check, Minecraft hitbox check, Minecraft reach check, Minecraft occlusion check, Minecraft fastbreak check, Minecraft inventory check, Folia anticheat, Paper anticheat, Spigot anticheat, Bukkit anticheat, Purpur anticheat, Minecraft ML anticheat, combat anti cheat, PvP cheat prevention, scaffold prevention, kill aura detection, AutoTotem detection.
Latest reviews
- waseric
- Version: v3.0.7a
This license was given for free.
What's this?
LinsaFTW creates amazing plugins. He is very responsive and provide fast and friendly support.
When the opportunity came up to buy this in pre-release, it was an obvious choice.
This plugin is excellent, and has already gone through many iterations based on player feedback.
When the opportunity came up to buy this in pre-release, it was an obvious choice.
This plugin is excellent, and has already gone through many iterations based on player feedback.
LinsaFTW
Thank you so much friend! This is one of my most beloved projects, thank you for being a good helper during the development pre-release phase!!!
- DanSeb2000
- Version: v3.0.4
This license was given for free.
What's this?
Got it since day 1, it was interesting seeing it evolve until today's release, very good plugin with great support and constant updates.
LinsaFTW
Thank you so much !
- FurkanVural
- Version: v3.0.4
This license was given for free.
What's this?
its the best anticheat I have used so far. It remains stable even with a high number of players.
LinsaFTW
Thank you so much ! I greatly appreciate it!
- Johan Fischer
- Version: v3.0.4
This license was given for free.
What's this?
The Support is very good!
The Plugin does a VERY good job! I recommend it for everyone!
Best anticheat ever!
The Plugin does a VERY good job! I recommend it for everyone!
Best anticheat ever!
LinsaFTW
Thank you so much man and thank you for being along the hard road of making FairPlay anti-cheat, it has been a lot of down and highs and hard work, and I really appreciate all the early feedback I got from you and early adopters. It has been a beautiful road. Thank you so much !!!
