matrixconfig

########################################################################################################
#
#
#                                      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

  # Max clicks per second (CPS)
  max_cps: 15

  # Number of violations in order to start to canceling hits
  cancel_vl: -1

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


############################################################
#
#                  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: -1

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    25: 'matrix notify %player% tried to reach entity outside max reach distance (HitBox)'
    30: 'matrix notify %player% tried to reach entity outside max reach distance (HitBox) #2'


############################################################
#
#                     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: -1

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    65: 'matrix notify %player% tried to move faster than usual (Speed) #1'
    100: 'matrix notify %player% tried to move faster than usual (Speed) #2'


############################################################
#
#                           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: -1

  # Ability Check
  # This check can quickly detect vanilla fly hack, but maybe not compatible with some plugins!
  ability: true

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    100: 'matrix notify %player% tried to fly (Fly) #1'
    200: 'matrix notify %player% tried to fly (Fly) #2'


############################################################
#
#                      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: -1

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    150: 'matrix notify %player% is sending unusual packets to server (BadPackets) #1'
    300: 'matrix notify %player% is sending unusual packets to server (BadPackets) #2'


############################################################
#
#                         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: -1

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


############################################################
#
#                         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: -1

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


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

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


############################################################
#
#                  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: -1

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


############################################################
#
#                  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: -1

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    30: 'matrix notify %player% tried to move illegally in liquid (Jesus)'


############################################################
#
#                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: -1

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    15: 'matrix notify %player% moved items in inventory too quickly (ChestSteal)'


############################################################
#
#                  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:
    15: 'matrix notify %player% tried to ignore server velocity (Anti-Knockback)'
    20: 'matrix notify %player% tried to ignore server velocity (Anti-Knockback) #2'


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

  # 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)'


############################################################
#
#                         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:
    15: 'matrix notify %player% tried to illegally interact with Entity/Block (Interact)'


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

  # Punish Commands
  # number_of_violations: '<command>'
  commands:
    6: 'matrix notify %player% is using auto fish (AutoFish)'