#### AAC Config (Generated by AAC 4.1.4) # # Hey there, # Welcome to AAC's configuration file. # I've commented the entire thing heavily so every option is easy to understand. # If you want a simple place to start, feel free to check out the "Common changes" section below. # Feel free to read through the descriptions of checks and options and change them to suit your server. # I hope that AAC will perform well and live up to your expectations. # ~ konsolas # # How violations work: # - When a player fails a check in AAC, it generates a "violation" which describes what went wrong, and what was # expected. # - Details about this violation, along with player data, server tps, etc. are saved to a log file in plugins/AAC/logs, # with a millisecond-precision timestamp. # - The check then generates a number based on options in this config and the details of what happened. If the # violation was more severe, the check will generate a bigger number. # - This number is added onto a player's "violation level", or "VL". A player's VL also decays over time when they # play without failing checks in AAC. A player has a separate VL for each check. # # How mitigation works: # - Many checks in AAC can not only detect a cheater, but also mitigate their actions. # - For example, AAC can teleport a flying player down, restore blocks broken too quickly, block attacks which are # suspicious, and temporarily block bow use, to name a few. # - Mitigation can be disabled by setting "mitigation.enabled" to false. AAC will continue checking, and will also # continue performing threshold actions, but the check will stop influencing the player's gameplay. # - Mitigation can be configured to only start after a certain VL is reached. This is set by the "min_vl" option, and # is useful to prevent random lag from significantly affecting gameplay. # # How decay works: # - The decay option in every check allows you to decide how fast violations should go down for each check. # - The "interval" option is the time in ticks between VL reductions. # - The "delay" option is the time in ticks that AAC waits after a violation before starting to reduce the VL. # - The "amount" option is the amount that AAC reduces the VL after each interval passes. # # How thresholds work: # - Each check has a section labelled "thresholds". This consists of a list of "threshold actions", each of which is a # number paired with a command or list of commands. # - When a player's VL (see above) for a check goes above the number, or "threshold" for a threshold action, the # threshold action is triggered and the command is executed. # - The command won't be executed again until the player's VL decays below that number, and then rises above it again. # - If there are multiple commands in the same threshold action, they are all executed in the order they appear. # # Common changes: # - Changing messages: # -> All messages sent by AAC are part of a threshold action (see above) tied to an "aac notify" command. # -> You can localise these messages by changing the relevant command. # - Reducing teleports or setbacks: # -> Move and Timer are the main checks which set back for movement. # -> Change move.mitigation.min_vl or timer.mitigation.min_vl to a higher value, or increase the decay. # -> By default, Move employs "strict" and "direction" checking. # -> "strict" checking permits AAC to check if players move too slowly. # -> "direction" checking permits AAC to compare a movement with the direction the player is facing. # -> These can be disabled for specific scenarios, e.g. only on elytras, or only in water. # -> Timer can be affected by severe network lag. # -> You can increase timer.max_extra, but cheaters will be able to fake lag (e.g. with Blink) for longer. # - Improving hit detection: # -> Hitbox sometimes cancels hits if a player is laggy. # -> You can increase hitbox.max_reach to reduce reach violations for laggy players. # -> You can increase hitbox.mitigation.min_vl so players are less likely to have their hits cancelled. # -> You can also disable mitigation for Killaura and Hitbox to stop AAC from blocking hits entirely. # - Changing kicks: # -> Kicks are caused by a threshold action tied to a /kick command. # -> You can remove the threshold action with a /kick command for a check to disable kicking. # -> You can increase the threshold for the threshold action to make kicking more lenient. # -> You can reduce the threshold for the threshold action to make kicking more strict. # - Other: # -> Look in the logs for a timestamp that matches a problem that you've experienced. # -> Find out which check was failed. # -> Locate that check in this config file. # -> Look for a relevant option, and change it as described by the comment. # -> If you can't solve the issue, please check out the issue tracker or discord server for support. # # The "Move" check: # - As of AAC 4, Fly, Speed, Elytra and Vehicles have all been merged together into Move. # - Detection is performed by comparing a player's movement with simulations of a legitimate client's movement: # -> Move is able to detect some cheats which don't appear movement related at first: # -> Many killauras will fail Move if "direction" and "strict" are turned on, as a result of silent aim. # -> Velocity reduction cheats may fail move. (the Velocity check will still detect 0 velocity) # -> Move uses a robust setback system which aims to correct movement rather than block it entirely. # # The configurable commands will replace {player}, {ping}, {tps}, {world} and {server} with their in-game values. # You can run multiple commands on a single threshold by creating 2 (or more) entries with the same key: # thresholds: # 10: # - "broadcast {player} was kicked for cheating" # - "kick {player} cheating" # # The configuration file follows: # Criticals stops players from performing critical hits whilst on the ground criticals: enabled: false # Should AAC detect clients that perform minijumps to get critical hits? check_minijump: true # Control how the violation level decays over time decay: interval: 70 delay: 70 amount: 1 # Control how AAC mitigates a cheater's actions mitigation: enabled: true min_vl: 1 # Control actions taken upon reaching certain violation levels thresholds: 1: "aac notify {player} na mapie {world} prawdopodobnie uzywa wspomagaczy (Criticals) (ping {ping}, tps {tps})" 2: - "aac banvl 1 {player} zostal wyrzucony za wspomagacze (Criticals)" - "kick {player} Zostal wyrzucony za wspomagacze" # FastBow stops players from shooting arrows too quickly fastbow: enabled: false # How lenient should AAC be when measuring bow drawback times? (milliseconds) lenience: 200 # Control how the violation level decays over time decay: interval: 100 delay: 100 amount: 1 # Control how AAC mitigates a cheater's actions mitigation: enabled: true min_vl: 5 # Control actions taken upon reaching certain violation levels thresholds: 3: "aac notify {player} shooting arrows too quickly (ping {ping}, tps {tps})" 10: - "aac banvl 1 {player} Kicked for FastBow" - "kick {player} Illegal client modifications" # FastUse stops players from consuming items too quickly fastuse: enabled: true # How long should AAC require item consumption to take? (milliseconds) min_consumption_time: 120 # Control how the violation level decays over time decay: interval: 100 delay: 100 amount: 1 # Control how AAC mitigates a cheater's actions mitigation: enabled: true min_vl: 5 # Control actions taken upon reaching certain violation levels thresholds: 3: "aac notify {player} na mapie {world} prawdopodobnie uzywa wspomagaczy (FastUse) (ping {ping}, tps {tps})" 10: - "aac banvl 1 {player} Zostal wyrzucony za wspomagacze (FastUse)" - "kick {player} Zostales wyrzucony za wspomagacze" # FightSpeed stops players from attacking too quickly fightspeed: enabled: false # How many hits per second should AAC limit players to? max_hit: 16 # How many swings per second should AAC limit players to? max_swing: 26 # Control how the violation level decays over time decay: interval: 25 delay: 50 amount: 1 # FightSpeed does not support mitigation # Control actions taken upon reaching certain violation levels thresholds: 15: "aac notify {player} na mapie {world} prawdopodobnie uzywa wspomagaczy (FightSpeed) (ping = {ping}, tps = {tps})" 30: - "aac banvl 1 {player} Zostal wyrzucony za wspomagacze (FightSpeed)" - "kick {player} Zostales wyrzucony za wspomagacze" # Hitbox forces players to look at entities that they want to attack hitbox: enabled: true # How much more lenient should AAC be when a player is attacking a mob? (blocks) mob_lenience: 0.35 # How lenient should AAC be when checking players lenience: 0.001 # What should AAC limit a player's attack reach to? (blocks) max_reach: 3.1 # Control how the violation level decays over time decay: interval: 50 delay: 20 amount: 1 # Control how AAC mitigates a cheater's actions mitigation: enabled: true min_vl: 30 # Control actions taken upon reaching certain violation levels thresholds: 20: "aac notify {player} na mapie {world} prawdopodobnie uzywa wspomagaczy (Hitbox) (ping = {ping}, tps = {tps})" 50: - "aac banvl 1 {player} zostal wyrzucony za wspomagacze (Hitbox)" - "kick {player} Zostales wyrzucony za wspomagacze" # Killaura detects modifications that create an unfair advantage in combat killaura: enabled: true # AAC has a few different methods of detecting Killaura. # How much should the violation level be increased for each of these methods? # The module which caused the detection can be seen in verbose and also in logs. # Ax modules detect aimbot/aimassist, Bx modules detect killaura, Cx modules detect autoclickers. modules: A1: 10 A2: 10 A3: 10 A4: 15 A5: 16 A6: 45 B1: 10 B2: 9 B3: 10 B4: 10 B5: 10 B6: 7 B7: 10 B8: 10 B9: 8 B10: 16 B11: 16 B12: 15 B13: 15 B14: 15 B15: 6 B16: 6 B17: 6 B18: 5 B19: 5 B20: 5 B21: 4 B22: 4 B23: 4 C1: 16 C2: 16 C3: 16 C4: 16 C5: 20 C6: 20 C7: 20 C8: 20 C9: 20 C10: 10 C11: 10 C12: 10 C13: 10 C14: 11 C15: 11 C16: 11 C17: 11 C18: 12 C19: 12 C20: 12 C21: 12 C22: 14 C23: 14 C24: 14 C25: 14 C26: 13 C27: 13 C28: 13 C29: 13 C30: 9 C31: 9 C32: 9 C33: 9 C34: 8 C35: 8 C36: 8 C37: 5 C38: 5 C39: 5 # Control how the violation level decays over time decay: interval: 5 delay: 10 amount: 1 # Control how AAC mitigates a cheater's actions mitigation: enabled: true min_vl: 100 # Control actions taken upon reaching certain violation levels thresholds: 50: "aac notify {player} na mapie {world} prawdopodobnie uzywa wspomagaczy (I) (Killaura - Normal) (ping = {ping}, tps = {tps})" 100: "aac notify {player} na mapie {world} prawdopodobnie uzywa wspomagaczy (II) (Killaura - Normal) (ping = {ping}, tps = {tps})" 150: - "aac banvl 1 {player} zostal wyrzucony za wspomagacze (Killaura - Normal)" - "kick {player} Zostales wyrzucony za wspomagacze" # Regen stops players from regenerating health too quickly regen: enabled: true # What delay should AAC enforce between regeneration attempts? (milliseconds) min_regen_delay: 2600 # Players can regenerate faster on MC 1.9+ if they are fully satiated. # What delay should AAC enforce if this is the case? (milliseconds) min_satiated_delay: 450 # Control how the violation level decays over time decay: interval: 20 delay: 100 amount: 1 # Control how AAC mitigates a cheater's actions mitigation: enabled: true min_vl: 1 # Control actions taken upon reaching certain violation levels thresholds: 2: "aac notify {player} na mapie {world} prawdopodobnie uzywa wspomagaczy (Regen) (ping {ping}, tps {tps})" # Derp detects illegal rotations sent by players derp: enabled: true # Control how the violation level decays over time decay: interval: 20 delay: 20 amount: 1 # Derp does not support mitigation # Control actions taken upon reaching certain violation levels thresholds: 1: - "aac banvl 1 {player} Zostal wyrzucony za wspomagacze (Derp)" - "kick {player} Zostales wyrzucony za wspomagacze" # Move controls player movement move: enabled: true # Should AAC check players asynchronously? This option reduces load on the main server thread by around 40% async: false # What's the maximum amount that a single violation should be able to add to a player's VL? # VL added is proportional to the (distance between the expected and actual movement)^2 # This value must be greater than min_vl, or you will allow 10-block teleports max_vl_increment: 510 # How many simulations should AAC carry forward from the previous movement? (maximum) # This limit exists to limit the performance impact of the move check. simulation_limit: 100 # Control how AAC checks movements in general. normal: # How lenient should AAC be when checking? tolerance: 0.001 # How much should a move violation of this type contribute to a player's overall VL? weight: 0.1 # Control how AAC checks movements in water. water: # How lenient should AAC be when checking? tolerance: 0.001 # How fast should players be able to move with riptide? riptide_speed: 0.1 # How much should AAC allow flowing water to accelerate a player? flowing: 0.2 # How much should AAC allow bubble columns to accelerate a player? bubble_column: 1.0 # How much should a move violation of this type contribute to a player's overall VL? weight: 1.0 # Control how AAC checks movements while using the elytra. elytra: # How lenient should AAC be when checking? tolerance: 0.003 # How quickly should players be able to travel when rocket boosting with an elytra? rocket_speed: 2.0 # How much should a move violation of this type contribute to a player's overall VL? weight: 0.8 # Control how AAC checks movements when on a vehicle vehicle: # How lenient should AAC be when checking? tolerance: 0.002 # How much should a move violation of this type contribute to a player's overall VL? weight: 0.8 # Control how AAC checks small movements. # AAC disables both strict and direction checking briefly if a player slows down significantly or comes to a stop. small: # How much faster should a player be able to move after an initial small movement? multiplier: 0.5 # How lenient should AAC be when checking? tolerance: 0.001 # How much should a move violation of this type contribute to a player's overall VL? # This stacks on top of the weights of normal, water, elytra and vehicles when it is applied. weight: 0.9 # Control how AAC checks movement when velocity is applied velocity: # Should AAC check for anti-velocity (Move will still check for velocity reduction with this turned off) # Players which don't move at all will not be checked, as this is indistinguishable from lag enabled: true # How long should AAC wait for a player to send the correct velocity? (milliseconds) wait_time: 100 # How far should AAC send a player back if mitigation is enabled? (ticks) setback_ticks: 1.0 # How much should AAC add to a player's VL if they ignore velocity? vl_increment: 1 # Control how the violation level decays over time decay: interval: 1 delay: 1 amount: 1 # Control how AAC mitigates a cheater's actions mitigation: enabled: true min_vl: 500 # Control actions taken upon reaching certain violation levels thresholds: 500: "aac notify {player} na mapie {world} prawdopodobnie uzywa wspomagaczy (Move) (ping {ping}, tps {tps})" 20000: - "aac banvl 0 {player} Zostal wyrzucony za wspomagacze" # Default config does not increase banVL if a player is kicked for Move. - "kick {player} Zostales wyrzucony za wspomagacze" # NoFall stops players from avoiding fall damage nofall: enabled: true # Control how the violation level decays over time decay: interval: 25 delay: 50 amount: 1 # Control how AAC mitigates a cheater's actions mitigation: enabled: true min_vl: 1 # Control actions taken upon reaching certain violation levels thresholds: 10: "aac notify {player} na mapie {world} prawdopodobnie uzywa wspomagaczy (NoFall) (ping {ping}, tps {tps})" 50: - "aac banvl 1 {player} Zostal wyrzucony za wspoamgacze" - "kick {player} Zostales wyrzucony za wspomagacze" # Phase stops players from moving through solid walls phase: enabled: true # Which blocks should AAC treat as air? This can be used to allow cross-version compatibility. exclude: # Incorrect hitboxes on 1.8 servers - "ANVIL" - "CHEST" - "ENDER_CHEST" - "TRAPPED_CHEST" - "SOIL" - "HUGE_MUSHROOM_1" - "STAINED_CLAY" # Entity hitboxes - "AIR" - "STATIONARY_WATER" - "WATER" - "STATIONARY_LAVA" - "LAVA" # Protocol hack hitboxes - "IRON_FENCE" - "WATER_LILY" - "LILY_PAD" - "GRASS_PATH" # Moving pistons - "PISTON_MOVING_PIECE" - "CARPET" - "SNOW" # Control how the violation level decays over time decay: interval: 10 delay: 20 amount: 1 # Control how AAC mitigates a cheater's actions mitigation: enabled: true min_vl: 0 # Control actions taken upon reaching certain violation levels thresholds: 50: "aac notify {player} na mapie {world} prawdopodobnie uzywa wspomagaczy (Phase)(ping {ping}, tps {tps})" # Timer stops players from performing actions too quickly by speeding up time timer: enabled: true # How much lag should AAC compensate for when checking? (ticks) min_balance: -20 # How many extra packets should AAC limit a player to? max_extra: 30 # Control how the violation level decays over time decay: interval: 2 delay: 2 amount: 1 # Control how AAC mitigates a cheater's actions mitigation: enabled: true min_vl: 1 # Control actions taken upon reaching certain violation levels thresholds: 100: "aac notify {player} na mapie {world} prawdopodobnie uzywa wspomagaczy (Timer) (ping {ping}, tps {tps})" # BadPackets checks for invalid packets badpackets: enabled: false # Should AAC check for player ability packets check_abilities: true # How many times should a player be allowed to toggle use item in one second? max_use_toggle: 40 # How many times should a player be allowed to toggle sneak in one second? max_sneak_toggle: 10 # Control how the violation level decays over time decay: interval: 20 delay: 20 amount: 1 # BadPackets does not support mitigation # Control actions taken upon reaching certain violation levels thresholds: 50: "aac notify {player} na mapie {world} prawdopodobnie ma zle pakiety (ping {ping}, tps {tps})" 100: - "aac banvl 1 {player} Zostal wyrzucony za zle pakiety" - "kick {player} Zostales wyrzucony za duzy PING" # FastBreak stops players from breaking blocks too quickly fastbreak: enabled: false # Should AAC check for a delay between successive block break attempts? check_delay: true # How lenient should AAC be when checking? (ticks) tolerance: 2 # Control how the violation level decays over time decay: interval: 20 delay: 20 amount: 1 # Control how AAC mitigates a cheater's actions mitigation: enabled: true min_vl: 5 # Control actions taken upon reaching certain violation levels thresholds: 5: "aac notify {player} is breaking blocks too quickly (ping {ping}, tps {tps})" 20: - "aac banvl 1 {player} Kicked for FastBreak" - "kick {player} Illegal client modifications" # FastPlace stops players from placing blocks too quickly fastplace: enabled: false # What should AAC limit block placement to? max_place_per_second: 15 # Control how the violation level decays over time decay: interval: 20 delay: 20 amount: 1 # Control how AAC mitigates a cheater's actions mitigation: enabled: true min_vl: 5 # Control actions taken upon reaching certain violation levels thresholds: 5: "aac notify {player} is placing blocks too quickly (ping {ping}, tps {tps})" 20: - "aac banvl 1 {player} Kicked for FastPlace" - "kick {player} Illegal client modifications" # Interact detects a number of impossible actions that a hacked client could perform. interact: enabled: true # Should AAC detect suspicious block placements? check_suspicious_block: true # Should AAC check if a player interacts with a block out of their line of sight? check_interact: true # Should AAC check if a player interacts whilst dead? check_dead: true # Should AAC check if a player breaks a block out of their line of sight? check_break: true # Should AAC check if a player incorrectly interacts with a liquid? check_liquids: true # Should AAC check if a player places a block out of their line of sight? check_place: true # Should AAC check if a player opens an inventory out of their line of sight? check_inventory: true # Should AAC check if a player attacks an entity behind a wall? check_attack: true # Should AAC check if a player attacks while using an item? check_item_attack: true # Control how the violation level decays over time decay: interval: 20 delay: 20 amount: 1 # Control how AAC mitigates a cheater's actions mitigation: enabled: true min_vl: 10 # Control actions taken upon reaching certain violation levels thresholds: 10: "aac notify {player} na mapie {world} prawdopodobnie uzywa wspoamgaczy (Interact)" # How much should AAC slow players down after they are detected? # Values closer to 0 slow down movement cheats more but also reduce the effectiveness of the velocity check. # Negative values will send movement cheats in the opposite direction, but will render the velocity check unusable. move_vl_slowdown: 0.8 # Should AAC use a log file? log_file: false # Should AAC log events to the console? log_console: false # AAC can enforce a minimum delay for players before they are allowed rejoin your server after leaving (ms) relog_protection: 0 relog_message: "Poczekaj chwile przed nastepnym polaczeniem z serwerem" # AAC implements a basic form of staff chat. You can enable it by setting a prefix, such as "@", here. staff_chat_prefix: "&8&l[&6&lKIT&E&LPVP&7-&6&lAAC&8&l]" staff_chat_format: "&8&l[&6&lKIT&E&LPVP&7-&6&lAAC&8&l] &7" # & used for colour codes