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