checks

########################################################################################################
#
#
#                                      Matrix Anti-Cheat
#                                          checks.yml
#
#                         This file checks and prevents the player from
#                       using most combat related hacks including but not
#                          limited to KillAura, Reach, HitBox, & More!
#
#                         Proofreading/Translation By: DJRedNightMC#6027
#             Free & Paid Plugin Proofreading for Non-Native English Speaking Developers
#
########################################################################################################


############################################################
#
#                         KillAura
#
# Description: This check prevents the player from using
# the KillAura hack
#
############################################################
killaura:
  # Enable KillAura check?
  enable: true

  # Enable Machine Learning KillAura check?
  # (If set to true, you must also set the above check to true)
  machine_learning: true

  # Module Settings
  modules:
    # AutoClicker check, it can detect player using AutoClickers
    autoclicker:
      # Max clicks per second (CPS)
      max_cps: 15
      # CPS limit check
      cps: true
      # click delay analyser
      delay: true
      # Long term CPS analyser
      cps_long: true

    # Attack Accuracy check
    accuracy:
      # Enable accuracy check?
      enable: true
      # Max attack accuracy (0-100)
      max_accuracy: 70
      # violations will be add
      vl_add: 20

    # Other Modules
    other:
      # super knock back check
      action: true
      # yaw pattern
      yaw: true
      # pitch pattern
      pitch: true
      # snap aim check
      snap: true

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    20: 'matrix notify %player% might be using combat hacks (KillAura)'
    35: 'matrix notify %player% is using combat hacks (KillAura) #2'
    45: 'say %player% KillAura'

############################################################
#
#                  HitBox/Angle/Reach
#
# Description: This check prevents players from using HitBox,
# Angle, & Reach hacks.
#
############################################################
hitbox:
  # Enable HitBox check?
  enable: true

  # Angle check settings
  angle:
    # Max angle (degrees)
    max: 90

    # Min distance check
    min_dist: 1.5

  # Reach check settings
  reach:
    # Max attack reach distance
    max_reach: 3.5

    # Enable reach distance analyser?
    # This is a math check that can detect slightly modified reach hacks
    enable_analyser: true

  # Number of violations in order to start to canceling illegal hits (-1 = never cancel)
  cancel_vl: 8

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    10: 'matrix notify %player% tried to reach entity outside max reach distance (HitBox)'
    15: 'matrix notify %player% tried to reach entity outside max reach distance (HitBox) #2'
    24: 'say %player% Reach/HitBox Hacks'

############################################################
#
#                     Movement Speed
#
# Description: This checks how fast a player moves, and
# prevents the player from moving too fast.
#
############################################################
speed:
  # Enable this check?
  # Warning: If you disable
  # speed check, fly check
  # will not work!
  enable: true

  # Setback violations (-1 = never setback)
  cancel_vl: 30

  # Entity Speed check
  # It can detect Vehicle Speed hacking in 1.9+
  entity_speed: true

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    55: 'matrix notify %player% tried to move faster than usual (Speed) #1'
    90: 'matrix notify %player% tried to move faster than usual (Speed) #2'
    220: 'say %player% Speed Hacks'

############################################################
#
#                           Fly
#
# Description: Prevents the player from using both vanilla
# and non-vanilla fly hacks.
#
############################################################
fly:
  # Enable this check?
  # Warning: If you enable
  # fly check, speed check
  # MUST be ENABLED!
  enable: true

  # Setback violations (-1 = never setback)
  cancel_vl: 50

  # Strict Glide check
  strict_glide:
    # Enable strict glide check?
    enable: true

    # Falling distance and expectation deserve maximum deviation
    # If difference lager than this value, the player will be flagged
    max_diff: 0.5

  # Setback method (back/ground)
  # back: teleport the player to the last legit location
  # ground: teleport the player to the ground under the player
  setback: back

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    50: 'matrix notify %player% tried to fly (Fly) #1'
    100: 'matrix notify %player% tried to fly (Fly) #2'
    180: 'say %player% Fly Related Hacks'

############################################################
#
#                      BadPackets
#
# Description: Prevents player from sending too many
# movement packets or sending illegal packets
#
# Warning: Don't disable this check! This check includes
# many hidden checks that are vital for Matrix to run!
############################################################
badpackets:
  # Enable this check?
  enable: true

  # Number of violations needed to start canceling illegal move packets
  cancel_vl: 30

  # Enable Slow timer check?
  # This check can detect some hacks based on slower timer
  # But it may conflict with some optimization mod, such as LabyMod.
  slow_timer: true

  # packet queue size (seconds)
  # smaller-> detect timer faster, higher -> more friendly for high latency players
  cache_size: 30

  # Useless verbose message output (+0 VL messages)
  # If you don't want to see BadPackets spam in the verbose messages
  # You can set this to false
  verbose_useless: true

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    100: 'matrix notify %player% is sending unusual packets to server (BadPackets) #1'
    150: 'matrix notify %player% is sending unusual packets to server (BadPackets) #2'
    240: 'say %player% Sending Unusual Packets'

############################################################
#
#                         FastUse
#
# Description: Check prevents player from eating or using
# an item too quickly.
#
############################################################
fastuse:
  # Enable this check?
  enable: true

  # Number of violations needed to start canceling use of item
  # (-1 = Never Cancel)
  cancel_vl: 5

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    5: 'matrix notify %player% tried to use an item faster than usual (FastUse)'
    12: 'say %player% FastUse Hacks'

############################################################
#
#                         FastBow
#
# Description: Check prevents player from shooting a bow
# too quickly.
#
############################################################
fastbow:
  # Enable this check?
  enable: true

  # Number of violations needed to start canceling use of bow
  cancel_vl: 7

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    5: 'matrix notify %player% is trying to shoot a bow too quickly (FastBow)'
    15: 'say %player% FastBow Hacks'

############################################################
#
#                         FastHeal
#
# Description: Check prevents player from regaining health
# too quickly.
#
############################################################
fastheal:
  # Enable this check?
  enable: true

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    10: 'matrix notify %player% tried to regain health too quickly (FastHeal)'
    20: 'say %player% FastHeal Hacks'

############################################################
#
#                  FastPlace/Block Interact
#
# Description: Check prevents the player from breaking,
# placing, or interacting with a block too quikcly.
#
############################################################
block:
  # Enable this check?
  enable: true

  # Number of violations to start canceling the placing/breaking of blocks
  cancel_vl: 15

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    10: 'matrix notify %player% tried to place/break a block too quickly (FastPlace)'
    20: 'say %player% FastPlace/FastBreak Hacks'

############################################################
#
#                  Jesus / Water Walking
#
# Description: Check prevents the player from moving too
# too quickly in liquids, or walking on liquid.
#
############################################################
jesus:
  # Enable this check?
  enable: true

  # Number of violations to start canceling liquid movement
  cancel_vl: 15

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    15: 'matrix notify %player% tried to move illegally in liquid (Jesus)'
    25: 'say %player% Jesus/WaterSpeed/WaterFly Hacks'

############################################################
#
#                ChestSteal / InventoryMove
#
# Description: Check prevents the player from using illegal
# inventory modifications such as Steal. Also prevents quick
# inventory movement hacks.
#
############################################################
inventory:
  # Enable this check?
  enable: true

  # Number of violations to start canceling the movement of items
  cancel_vl: 10

  # Disable InventoryMove check
  # If you don't need InventoryMove check, you can set this to 'true' to disable it
  # This option ONLY works for 1.12/1.13/+ server
  disable_invmove: false

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    10: 'matrix notify %player% moved items in inventory too quickly (ChestSteal)'
    20: 'say %player% ChestSteal/Inventory Hacks'

############################################################
#
#                  Velocity / Anti-Knockback
#
# Description: Check prevents the player from using any type
# of anti-knockback hacks.
#
############################################################
velocity:
  # Enable this check?
  enable: true

  # Modules List
  # You can turn off some velocity modules here
  # Set it to false to disable the module
  modules:
    vertical: true
    horizon: true
    air: true
    air_direction: true

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    10: 'matrix notify %player% tried to ignore server velocity (Anti-Knockback)'
    15: 'matrix notify %player% tried to ignore server velocity (Anti-Knockback) #2'
    20: 'say %player% Velocity/Anti-Knockback Hacks'

############################################################
#
#                       Chat Spam
#
# Description: Check prevents a player from spamming
# messages in the servers chat.
#
############################################################
chat:
  # Enable this check?
  enable: true

  # Minimum amount of time between messages (Seconds)
  min_time: 3

  # Number of violations to start canceling messages from being sent
  cancel_vl: 3

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    4: 'matrix notify %player% is spamming the chat (ChatSpam)'
    10: 'say %player% Stop spamming the chat!'

############################################################
#
#                         Interact
#
# Description: Check prevents the player from illegally
# interacting with entities and blocks.
#
############################################################
interact:
  # Enable this check?
  enable: true

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    10: 'matrix notify %player% tried to illegally interact with Entity/Block (Interact)'
    15: 'say %player% Illegally Interacting with Block/Entity'

############################################################
#
#                         AutoFish
#
# Description: Check prevents the player from using an
# Auto-Fishing mod or hack.
#
############################################################
autofish:
  # Enable this check?
  enable: true

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    6: 'matrix notify %player% is using auto fish (AutoFish)'
    12: 'say %player% No Auto Fishing!'

############################################################
#
#                         Phase
#
# Description: Check prevents the player people glitching
# through blocks.
#
############################################################
phase:
  # Enable this check?
  enable: true

  # Which type of block should be exempt from phase checking?
  # If you find any false positive, you can add that block type into it
  # For example:
  # exclude_types:
  #   - 'AIR'
  exclude_types: {}

  # Drag player back?
  setback: true

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    5: 'matrix notify %player% is phase into block (Phase)'
    10: 'matrix notify %player% is phase into block (Phase) #2'
    20: 'say %player% Phase into block'