# LCD's optimized checks file - v1.4.3
# For Matrix 4.8.3
#
# This project aims to keep a balance between
# preventing false positives and having a
# strict anticheat that detects hacks quickly.
#
# Donations? Nope. Buy Matrix Premium instead.
#
# Tested and meant for survival and minigame
# servers. Tweak the config for your own server!
#
# ------------------------------------------------------
# Issues?
# Report them here:
# https://github.com/PhoenixDiscord/MatrixConfig/issues
# ------------------------------------------------------
## KillAura
# Prevents the player from using the KillAura/AimBot hack
killaura:
# Enable KillAura check?
enable: true
# List of the various KillAura check modules of Matrix
modules:
# "OneHit" check can detect some blatant KillAura cheats in short time
onehit:
# Should this module be enabled?
enable: true
# How much VL should the player get after being flagged by this module?
vl_weight: 4
# Do you want to disable the Packet Order check as it may cause false positives when players have high latency
disable_packet_order_check: false
# Do you want to disable the "dead entity hit" check?
# This may cause false positives for some players who click fast
disable_dead_hit_check: false
# AutoClicker check setting, prevent player use AutoClicker cheat
autoclicker:
# Player can click 24 times (default config) per second if they jitter clicking
# Most people click at 6 CPS, and only a very small amount of people get to 16 CPS.
# This should make the AutoClicker detection more strict without causing much issues.
# Why 18? Because it's sometimes possible to get higher for people who click at 16cps.
max_cps: 18
# If you enable this option, the auto clicker check will not work when you attack mobs.
not_check_attacking_mobs: false
# How much VL should the player get after being flagged by this module?
vl_weights:
cps: 8
delay: 4 # This module might cause some false flags when player jitter clicking, disable it if you want (-1)
cps_long: 6
v19plus: 6
# click accuracy check
click:
# Enable this module?
enable: true
# How much VL should the player get after being flagged by this module?
vl_weight: 30
# You can customize the sensitivity of click Check, which is divided into three levels (0, 1, 2)
# 0: It can detect many types of KillAura, but there are many false alarms. It is generally not recommended to use it
# 1: Medium sensitivity, with a small number of false positives, it can detect most types of killaura
# 2: The most lenient mode can detect most types of killaura, but it is slow
sensitivity: 2
# KillAura NPC check, it will generate a fake player behind the player to detect
# if the player is using KillAura, and don't worry, the player can only see his own NPC
npc:
# Enable this check?
enable: true
# How much VL should the player get after being flagged by this module?
# I assume the VL is added when the player hits the NPC.
# This can be bigger than the default because only dumb people would attack NPC's, right?
vl_weight: 12
# Should the position calculation of the NPC run asynchronously, as this may consume some resources
async: true
# Should NPCs use real entity IDs instead of randomly generating them?
# Some cheating clients can bypass random entity ID
real_entity_id: true
# Has the NPC been generated by command only? If set to false, the NPC will be automatically
# generated when the player fights. If set to true, you can only generate an NPC for a player
# via the "matrix npc" command. (default: true)
only_command_trigger: true
# Should the player see this NPC? (true = visible)
# I would say the NPC's visibility is important as it blocks killaura hacks that mostly everyone uses.
# Most hacked/cheat clients don't attack invisible entities.
# TLDR; Don't disable unless you really need to!
visible: true
# NPC existence time setting (ticks)
check_ticks:
base: 100
attack_add: 30
hit_bot_add: 55
# NPC motion settings
movement:
distance_base: 3.2
distance_random_size: 0.75
distance_attack_base: 3.0
move_up_after_attack: false
# KillAura / AimBot check based on machine learning clustering
# Matrix provides a trained model by default. Of course, you can also train a model yourself.
# Head to the wiki page to learn how to train:
# -> https://github.com/jiangdashao/Matrix-Issues/wiki/Machine-Learning-KillAura-check-Training-Tutorial
# It is worth noting that this check is more useful for version 1.8. If you are a 1.9+ server, you can choose to disable this check
# note: the check still works in 1.9+ servers
machine_learning:
# Enable this check?
enable: true
# How much VL should the player get after being flagged by this module?
vl_weight: 8
# Which ML samples you need to disable?
# Format: - '#*'. For example: - '#66'
disable_patterns: {}
# The duration of data collection, the longer the time, the slower the detection, but the more accurate (unit: milliseconds, default: 7000)
collect_data_duration: 7000
# Data set availability threshold, if the collected data set is below
# the threshold, discard the data set without analysis
availability_threshold:
hits: 3 # In the dataset, the player must attack the entity 3 times.
clicks: 30 # In the dataset, the player must click the mouse 30 times
rotations: 90 # In the dataset, the player must rotate the head 90 times
# NoSwing check
noswing:
# Enable this module?
enable: true
# How much VL should the player get after being flagged by this module?
vl_weight: 4
# Critical Hit check prevents players from making abnormal crit attacks
critical:
# Enable this module?
enable: true
# How much VL should the player get after being flagged by this module?
vl_weight: 5
# Snap check, it check players for abnormal fast aiming actions
snap:
# Enable this module?
enable: true
# How much VL should the player get after being flagged by this module?
vl_weight: 5
# click aim bot check, it can detect ClickAimBot of some clients
clickaimbot:
# Enable this module?
enable: true
# How much VL should the player get after being flagged by this module?
vl_weight: 5
# The AimAssist check detects simple Aim hacks.
aimassist:
# Enable this module?
enable: true
# How much VL should the player get after being flagged by this module?
vl_weight: 10
# Aim check, check if player aiming is normal based on math check
aim:
# Enable this module?
enable: true
# How much VL should the player get after being flagged by this module?
vl_weight: 15
# Direction check, detect if aiming in player battle is normal based on motion prediction
direction:
# Enable this module?
enable: true
# How much VL should the player get after being flagged by this module?
vl_weight: 3
# Violation Thresholds
# number_of_violations: '<command>'
commands:
8: 'matrix npc %player% 125'
20: 'matrix notify %player% might be using combat hacks &8| &7KillAura &8| &61/3'
35: 'matrix notify %player% might be using combat hacks &8| &7KillAura &8| &c2/3'
42: 'matrix kick %player% KillAura'
## HitBox
# Description: This check prevents players from using HitBox, Angle, Reach hacks.
# Note: This check is strict ONLY when you attack other PLAYERS, but it's very loose
# when you attack non-player creatures. So, if you find that you can use HixBox
# hack on non-player creatures, it's very normal, don't report it.
hitbox:
# Enable HitBox check?
enable: true
# Maximum reach distance (default config: 3.1)
# The standard/max Minecraft reach is 3.5 blocks, however it's still calculated in a mysterious way so most people won't even get near that.
# So, based on all of this info, anything bigger then 3.4 blocks is considered hacks.
# A lot of people requested to make this more strict. There you go.
# I won't make it 3.1, but other options are more strict which should make things work fine.
max_reach: 3.2
# How many moves should the Matrix trace back to the player? (default: 5)
# You can set this higher to reduce false positives, but this will weaken HitBox detection
# My suggestion is 3 to 10, please don't make it more than 10, because it is useless
# With the max reach this should be more stable, so the detection can be more strict.
trace_back_length: 3
# How much should Matrix ignore players with greater network latency?
# When the player's network latency is greater than this value, some
# HitBox checks will stop working to prevent false positives. You can
# set this value to -1 to disable this feature. (default: 250)
max_ping: 250
# Violation weights
vl_weights:
miss_player_hitbox: 2
reach_target_standing: 10
reach_target_moving: 3
reach_simple: 3
# Should dynamic VL weight be enabled?
# If enabled, the VL weight will be calculated based on the player's reach
# For example, players get 1vl when using 3.5 reach, and 19vl when players use 5.0 reach
# If this function is enabled, then "reach_target_standing" and "reach_target_moving" will no longer take effect
# Note: dynamic VL = (current_reach - max_reach) * expander
dynamic_vl:
enable: true
expander: 10
min_vl: 5 # experimental, should work fine with the max reach?
max_vl: 19
# Violation Thresholds
# number_of_violations: '<command>'
commands:
10: 'matrix notify %player% tried to reach entity outside max reach distance &8| &7HitBox &8| &a1/3'
13: 'coc %player% if -tps->18.5&-ping-<185 do matrix npc %player% 125' # Spawns an anti-killaura NPC if the ping doesn't exceed 185ms and the server isn't lagging.
15: 'matrix notify %player% tried to reach entity outside max reach distance &8| &7HitBox &8| &c2/3'
22: 'matrix kick %player% Reach/HitBox Hacks'
## Movement Speed Check
# This checks how fast a player moves, and prevents the player from moving too fast.
speed:
# Enable this check?
# Warning: Will also disable
# flight detection.
enable: true
# Should Matrix ignore the unloaded chunks when checking? (default config: true)
ignore_unloaded_chunks: true
# Speed prediction tolerance
tolerance: 0.01
# Setting this allows Matrix not to check the blocks and collision boxes around the
# player on every tick, but to use cached results (0 = not skip, default value = 2)
# Please do not set this value too large, it will cause too many skips and cause false positives.
skip_rate: 2
# Violations needed to cancel illegal movements (-1 = never cancel)
cancel_vl: 48
# Enable sprint direction check?
sprint_direction: true
# Enable strafe check?
strafe: true
# Enable FastClimb/FastLadder check?
fastclimb: true
# Should Matrix check NoSlowDown cheat?
check_noslow: true
# Violation Thresholds
# number_of_violations: '<command>'
commands:
55: 'matrix notify %player% tried to move faster than usual &8| &7Speed &8| &a1/3'
85: 'matrix notify %player% tried to move faster than usual &8| &7Speed &8| &c2/3'
175: 'matrix kick %player% Speed Hacks'
## Fly
# Prevents the player from using both vanilla and non-vanilla fly hacks.
fly:
# Enable this check?
# Warning: Speed check must also be enabled.
enable: true
# Violations needed to cancel illegal movements (-1 = never cancel)
cancel_vl: 50
# Fly ability check
# It might be not compatible with some plugins, test it yourself
ability:
enable: true
vl_weight: 20
# If the player is very close to the void, should Matrix teleport
# it to the void after detecting that player is cheating? (default: true)
# If you disable this, it might cause some NoFall / BugUp bypass, but
# it's a nice option for skyblock server if you don't want your players
# get teleported into the void
# Good for minigame servers (BedWars, SkyWars and others)
# Usually pointless for survival servers.
setback_to_void: true
# NoFall check
nofall:
# Force deal damage after setback?
# Recommended to disable this for minigame servers that don't have fall damage enabled.
damage: true
# Trident Boost violation level weight
trident_boost_vl_weight: 20
# 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
# Violation Thresholds
# number_of_violations: '<command>'
commands:
50: 'matrix notify %player% tried to fly &8| &7Fly &8| &a1/3'
100: 'matrix notify %player% tried to fly &8| &7Fly &8| &c2/3'
180: 'matrix kick %player% Fly Related Hacks'
## BadPackets
# Prevents player from sending too many movement packets or sending illegal packets
badpackets:
# Enable this check?
enable: true
# Buffer Size (ticks)
# The larger the value, the slower the detection, but the more stable
# Don't set it lower than 10
buffer_size: 32
# Freeze time (millisecond, 1second=1000 millisecond)
# The time to freeze player if they try to send too
# many moving packets at the same time
freeze_time: 500
# How many extra packets can the player send?
max_extra_packets: 15
# Violation weight
vl_weights:
limit: 10
timer: 10
# Violation Thresholds
# number_of_violations: '<command>'
commands:
100: 'matrix notify %player% is sending unusual packets to the server &8| &7BadPackets &8| &a1/3'
150: 'matrix notify %player% is sending unusual packets to the server &8| &7BadPackets &8| &c2/3'
240: 'matrix kick %player% Sending Unusual Packets'
## FastUse
# Check prevents player from eating or using an item too quickly.
# *** CAUSES FALSE POSITIVES! ***
fastuse:
# Enable this check?
enable: true
# Violations needed to cancel illegal item use (-1 = never cancel)
cancel_vl: 14
# Violation weight
vl_weight: 1
# Violation Thresholds
# number_of_violations: '<command>'
commands:
5: 'matrix notify %player% tried to use an item faster than usual &8| &7FastUse &8| &a1/2'
32: 'matrix kick %player% FastUse Hacks' # Decrease if it takes a long time to detect, or increase if causes false positives.
## FastBow
# Check prevents player from shooting a bow too quickly.
fastbow:
# Enable this check?
enable: true
# Violations needed to cancel illegal bow use (-1 = never cancel)
cancel_vl: 7
# Violation Weight
vl_weight: 1
# Violation Thresholds
# number_of_violations: '<command>'
commands:
5: 'matrix notify %player% is trying to shoot a bow too quickly &8| &7FastBow &8| &a1/2'
15: 'matrix kick %player% FastBow Hacks'
## FastHeal
# Check prevents player from regaining health too quickly.
# May cause false positives, but RE says the check has been improved.
# Disable this if it causes false positives.
# Also blocked by BadPackets
fastheal:
# Enable this check?
enable: true
# Violation Weight
vl_weight: 2
# Violation Thresholds
# number_of_violations: '<command>'
commands:
10: 'matrix notify %player% tried to regain health too quickly &8| &7FastHeal &8| &a1/2'
48: 'matrix kick %player% FastHeal Hacks'
## Block
# Check prevents the player from breaking, placing block quickly
block:
# Enable this check?
enable: true
# Violations needed to cancel illegal breaking/placing of blocks (-1 = never cancel)
# Set to 8 to prevent falling to void in case of things like SkyWars matches and others.
cancel_vl: 8
# Modules List
# You can turn off some modules here
modules:
# It can detect player breaking block faster
fastbreak:
enable: true
vl_weight: 6
# It can detect player placing block faster
fastplace:
enable: true
vl_weight: 1
max_place_per_second: 5
# It can detect player placing block without swing hand
noswing:
enable: true
vl_weight: 1
# detect player not send abort breaking packet
abort:
enable: true
vl_weight: 0
# Violation Thresholds
# number_of_violations: '<command>'
commands:
7: 'matrix notify %player% tried to place/break a block too quickly &8| &7Block &8| &a1/2'
15: 'matrix kick %player% FastPlace/FastBreak Hacks'
## Scaffold check
# Check prevents player bridging blocks or towering up faster than normal speed
scaffold:
# Enable this check
enable: true
# Cancel VL
cancel_vl: 15
# Modules
modules:
# It can detect player bridging faster
scaffold:
enable: true
vl_weights:
safewalk: 4
expand: 3
limit: 2
head: 5
direction: 4
# It can detect player towering up faster
tower:
enable: true
vl_weight: 2
# Violation Thresholds
# number_of_violations: '<command>'
commands:
7: 'matrix notify %player% tried to bridge blocks quickly &8| &7Scaffold &8| &a1/3'
15: 'matrix notify %player% tried to bridge blocks quickly &8| &7Scaffold &8| &c2/3'
25: 'matrix kick %player% Scaffold/Tower'
## Jesus
# Check prevents the player from moving too too quickly in liquids, or walking on liquid.
# Causes false positives in 1.13+ when player is quickly swimming/sprinting in water in a 1x1 water thing (my english sucks!)
# ^^ I wouldn't disable the check anyway - that false positive is rare in most cases.
jesus:
# Enable this check?
enable: true
# Violations needed to cancel illegal movements (-1 = never cancel)
cancel_vl: 15
# Violation Thresholds
# number_of_violations: '<command>'
commands:
20: 'matrix notify %player% tried to move illegally in liquid &8| &7Jesus &8| &a1/3'
40: 'matrix notify %player% tried to move illegally in liquid &8| &7Jesus &8| &c2/3'
60: 'matrix kick %player% Jesus/WaterSpeed/WaterFly Hacks'
## Inventory
# Check prevents the player from using illegal inventory modifications such as Steal.
# Also prevents quick inventory movement hacks.
inventory:
# Enable this check?
enable: true
# Violations needed to cancel illegal movements of items (-1 = never cancel)
# Strict for SkyWars matches
cancel_vl: 8
# Enable ChestStealer check?
# It can detect player taking items out of chest faster
chest_stealer: true
# Ignore items/inventory which has colorful name
# This feature can prevent false positive when you
# click some GUI such as the Bedwars Shop
ignore_color: false
# 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
# Check AutoTotem cheat?
auto_totem: true
# Violation Thresholds
# number_of_violations: '<command>'
commands:
10: 'matrix notify %player% moved items in inventory too quickly &8| &7Inventory/ChestSteal &8| &a1/2'
24: 'matrix kick %player% ChestSteal/Inventory Hacks'
## Velocity
# Check prevents the player from using any type of anti-knockback hacks.
velocity:
# Enable this check?
enable: true
# The time to wait for players to respond to velocity (ticks)
# If the player does not respond to velocity after that
# time, the player will be detected.
# Set to 40 to not cause false positives for laggy players.
wait_time: 40
# Ignore lag player, this feature can ignore the player who
# is lagging or changing resource pack.
ignore_lag: true
# Violation Weights
# -1 = disable that module
vl_weights:
P1: 10
P2: 5
P3: 7
P4: 4
P5: 4
P6: 2
P7: 3
P8: 2
# Violation Thresholds
# number_of_violations: '<command>'
commands:
10: 'matrix notify %player% tried to not take knockback &8| &7Velocity &8| &a1/3'
15: 'matrix notify %player% tried to not take knockback &8| &7Velocity &8| &c2/3'
22: 'matrix kick %player% Velocity/Anti-Knockback'
## Spam
# 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: 2
# Violations needed to cancel sent messages (-1 = never cancel)
cancel_vl: 4
# Violation Thresholds
# number_of_violations: '<command>'
commands:
4: 'matrix notify %player% is spamming the chat &8| &7ChatSpam &8| &a1/2'
10: 'matrix kick %player% Spammer/ChatBot'
## Interact
# Check prevents the player from illegally interacting with entities and blocks.
interact:
# Enable this check?
enable: true
# Modules List
modules:
# It can detect player breaking blocks through walls
break_block:
enable: true
vl_weight: 5
# It can detect player attacking other entities through walls
attack:
enable: true
vl_weight: 1
# It can detect player interacting blocks too far away
block_reach:
enable: true
vl_weight: 1
# Violation Thresholds
# number_of_violations: '<command>'
commands:
10: 'matrix notify %player% tried to illegally interact with an entity or block &8| &7Interact &8| &a1/2'
24: 'matrix kick %player% Illegally Interacting with Block/Entity'
## AutoFish
# Check prevents the player from using an Auto-Fishing mod or hack.
autofish:
# Enable this check?
enable: true
# Violations needed to cancel auto fishing (-1 = never cancel)
cancel_vl: 5
# Violation Thresholds
# number_of_violations: '<command>'
commands:
6: 'matrix notify %player% is using auto fish mods &8| &7AutoFish &8| &a1/2'
14: 'matrix kick %player% AutoFish'
## Phase
# Check prevents the player people glitching through blocks.
phase:
# Enable this check?
enable: true
# How much time should Matrix prevent the player from moving if
# the player frequently tries to move the block? (milliseconds)
freeze_time: 400
# Violations needed to cancel illegal movements
cancel_vl: 5
# Violation Thresholds
# number_of_violations: '<command>'
commands:
7: 'matrix notify %player% is glitching through blocks &8| &7Phase &8| &a1/2'
15: 'matrix notify %player% is glitching through blocks &8| &7Phase &8| &c2/2'
# No kick action; the check is not stable yet.
## AutoBot
# Check prevents player use some Bot mods like Baritone
# NOTE: THIS CHECK IS ONLY WORK FOR PREMIUM USERS
# Doesn't work for 1.8 (maybe?)
autobot:
# Enable this check?
enable: true
# Violation Thresholds
# number_of_violations: '<command>'
commands:
5: 'matrix notify %player% suspected use of automatic robots &8| &7AutoBot &8| &a1/3'
10: 'matrix notify %player% suspected use of automatic robots &8| &7AutoBot &8| &c2/3'
15: 'matrix kick %player% Auto-Bot'
## Elytra
# Checks prevents player using Elytra+, ElytraFlight, etc
# Only works for 1.9+
elytra:
# Enable this check?
enable: true
# Should Matrix be forced to pull back players who are particularly
# cheating? Even if they do not reach cancel_vl (default: true)
force_setback: true
# Setback violation level (-1 = never setback)
setback_vl: 8
# unequip elytra VL
# If player reached this VL, Matrix will make it out of the gliding state (-1 = disable this feature)
unequip_vl: 20
# Violation Thresholds
# number_of_violations: '<command>'
commands:
10: 'matrix notify %player% suspected using elytra-related cheats &8| &7Elytra &8| &a1/3'
20: 'matrix notify %player% suspected using elytra-related cheats &8| &7Elytra &8| &c2/3'
48: 'matrix kick %player% Elytra Flight'
## Vehicle
# Checks prevents player using VehicleFlight, VehicleSpeed, EntitySpeed..
# Only works for 1.9+
vehicle:
# Enable this check?
enable: true
# Prevent players from using certain creatures as vehicles
# All entity types: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
deny_entity_types_as_vehicle:
# Vehicle Speed/ Entity Speed
speed:
# Enable this modules?
enable: true
# setback VL (-1 = disable setback)
setback_vl: 2
# Vehicle Flight / Boat Flight
flight:
# Enable this modules?
enable: true
# setback vl (-1 = never setback)
setback_vl: 4
# leave vehicle vl (-1 = never leave vehicle)
leave_vehicle: 8
# Violation Thresholds
# number_of_violations: '<command>'
commands:
5: 'matrix notify %player% suspected using vehicle-related cheats &8| &7Vehicle &8| &a1/3'
10: 'matrix notify %player% suspected using vehicle-related cheats &8| &7Vehicle &8| &c2/3'
32: 'matrix kick %player% Suspicious vehicle movement'
