AAC-CFG

#### AAC Config (Generated by AAC 3.3.9)
#
# 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 trips 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 tripping checks in AAC. A player has a seperate VL for each check.
#
# How commands 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:
#  - Reducing teleports or setbacks:
#     -> Fly and Speed are the main checks which set back for movement.
#        -> Change fly.min_vl to a high value so players need to have a higher VL (see above) before being teleported.
#        -> Do the same for speed.min_vl.
#  - Improving hit detection:
#     -> Hitbox sometimes cancels hits if a player is laggy.
#        -> You can increase hitbox.move_compensation and/or max_reach to reduce reach violations for laggy players.
#        -> You can increase hitbox.lenience to relax how directly the attacker needs to look at their target.
#        -> You can increase hitbox.min_vl so players need to have a higher VL (see above) before having hits cancelled.
#     -> For hardcore PVP servers, the killaura check could affect PVP because it very slightly changes entity hitboxes.
#        -> You may need to set killaura.enabled -> false if this is a problem for your players.
#  - Changing kicks:
#     -> Kicks are caused by a threshold action tied to an /aackick command.
#        -> You can remove the threshold action with an /aackick 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 tripped.
#     -> 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 configurable commands will replace {player}, {ping}, {tps} and {world} 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"
#
# Be sure to check language.yml for configuration regarding messages, staff chat, etc.

# Hitbox forces players to look at entities they want to attack.
hitbox:
   # Do you want to enable the hitbox check?
   enabled: true

   # How much should AAC expand hitboxes by?
   lenience: 0.6

   # Should AAC cancel illegal hits?
   cancel: true

   # How far should a player be able to reach?
   # This value is added to the target entity hitbox size before being checked.
   max_reach: 3.7

   # How much should AAC compensate for the movement of the target?
   # This only affects reach, not hitbox lenience.
   move_compensation: 6.0

   # How many violations before AAC starts cancelling hits?
   min_vl: 4

   # Number of ticks before AAC starts reducing violations
   reduce_delay: 60

   # Map of violation levels to commands
   thresholds:
      20: "aacstaffnotify {player} in {world} is attacking suspiciously (Hitbox) (ping = {ping}, tps = {tps})"
      50: "aackick {player} Attacking suspiciously"

# BadPackets prevents players from using packets to exploit the server.
badpackets:
   # Do you want to enable the badpackets check?
   enabled: true

   # After how many moves should packets be cancelled?
   # A lower value reduces the possibility of blinking and exploits and improves performance.
   # A higher value will reduce the number of false positives. This should always be above 3.
   cancel_threshold: 30

   # How many moves should a player be able to send in 3 ticks?
   # An unmodified client should send 3 moves in 3 ticks. Be sure to think about lag
   # The violation value will be increased by (how many packets the player sends - max_moves) / 2
   max_moves: 30

   # Map of violation levels to commands
   thresholds:
      1000: "aacstaffnotify {player} in {world} might be trying to speed up time (ping = {ping}, tps = {tps})"
      3500: "aackick {player} Suspicious activity (or extreme lag)"

# Criticals prevents players from getting critical hits when it's not possible.
criticals:
   # Do you want to enable the criticals check?
   enabled: true

   # Should a hit be cancelled if it is a critical and the player is on the ground?
   cancel_false_hit: true

   # How many ticks should AAC enforce between jumps?
   jump_delay: 5

   # Map of violation levels to commands
   thresholds:
      8: "aackick {player} Illegal movement"

# Fastbow prevents players from shooting their bow too quickly.
fastbow:
   # Do you want to enable the fastbow check?
   enabled: true

   # How much lag compensation should AAC perform when checking for fastbow?
   lenience_ms: 130

   # How long should AAC block bow usage after a player is detected for fastbow? (set to 0 to disable)
   block_ticks: 100

   # How much VL does a player need before AAC starts blocking shots?
   min_vl: 8

   # Map of violation levels to commands
   thresholds:
      5: "aacstaffnotify {player} in {world} seems to be shooting arrows too quickly (ping = {ping}, tps = {tps})"
      25: "aackick {player} Shooting arrows too quickly"

# FightSpeed prevents players from attacking too quickly.
fightspeed:
   # Do you want to enable the fightspeed check?
   enabled: true

   # How many times should a player be able to attack per second?
   max_hit: 15

   # How many times should a player be allowed to swing their arm per second?
   max_swing: 35

   # Should fightspeed check for consistent click speed?
   consistent_check: true

   # How close together do hit speed measurements need to be for a violation?
   consistent_threshold: 25

   # Map of violation levels to commands
   thresholds:
      10: "aacstaffnotify {player} in {world} might be using an autoclicker (ping = {ping}, tps = {tps})"
      30: "aackick {player} Suspicious click speed"

# Fly prevents players in survival mode from flying.
fly:
   # Do you want to enable the fly check?
   enabled: true

   # How strongly should AAC enforce fall speeds? (smaller values are more accurate)
   tolerance: 0.015
   e_tolerance: 0.015

   # How quickly should AAC increase the violation level for larger movements?
   vl_multiplier: 3.0

   # How many violations before AAC starts teleporting a player down? (needs teleport: true)
   min_vl: 28

   # How long should a player have to respond to velocity given by the server?
   vel_ticks: 30

   # Teleport the player down if detected?
   teleport: true

   # Check for invalid abilities packets?
   abilities: true

   # How many ticks should AAC wait before reducing a player's violation level?
   reduce_delay: 20

   # Should AAC reset a player's pitch to 0 after a detection?
   reset_pitch: false

   # Map of violation levels to commands
   thresholds:
      150: "aacstaffnotify {player} in {world} might be trying to fly (ping = {ping}, tps = {tps})"
      300: "aacstaffnotify {player} in {world} is probably trying to fly (ping = {ping}, tps = {tps}"
      300: "aackick {player} Flying"

# Speed prevents players in survival mode from moving too quickly.
speed:
   # Do you want to enable the speed check?
   enabled: true

   # How much leniency should the speed check have?
   threshold: 0.005

   # How long should a player have to respond to velocity given by the server?
   vel_ticks: 30

   # How quickly should AAC increase the violation level for larger movements?
   vl_multiplier: 6.0

   # How many times should a player be allowed to toggle sneak in a second?
   max_sneak_toggles: 15

   # How many times should a player be allowed to toggle use-item in a second?
   max_use_toggles: 35

   # How many violations before a player will start being teleported?
   min_vl: 36

   # How many ticks should AAC wait before reducing a player's violation level?
   reduce_delay: 20

   # Specific configuration options. Don't touch these unless you know what you're doing.
   #item_scalar: 0.5
   #sneak_scalar: 0.63

   # Map of violation levels to commands
   thresholds:
      100: "aacmessage {player} It looks like you might be glitching, please tap sneak and block with your sword"
      250: "aacstaffnotify {player} in {world} seems to be moving too quickly (ping = {ping}, tps = {tps})"
      500: "aackick {player} Unexpected movement"

# Derp stops some forms of derp cheats.
derp:
   # Do you want to enable the derp check?
   enabled: true

   # Map of violation levels to commands
   thresholds:
      1: "aackick {player} Illegal position"

# Old check for anti-velocity and anti-knockback, see velocity check for current check.
knockback:
   # Do you want to enable the knockback check
   enabled: false

   # legacy configuration
   tick_delay: 9
   add_ping: true
   max_ping: 500
   min_knockback_dist: 0.01
   min_knockback_time: 2
   thresholds: {}

# NoSwing ensures that players swing their arm when attacking or mining.
noswing:
   # Do you want to enable the noswing check?
   enabled: true

   # Map of violation levels to commands
   thresholds:
      20: "aacstaffnotify {player} in {world} is not swinging their arm (ping = {ping}, tps = {tps})"
      40: "aackick {player} Not swinging arm"

# Regen directly stops players from healing too quickly.
regen:
   # Do you want to enable the regen check?
   enabled: true

   # Should AAC cancel regeneration if it happens too quickly?
   cancel_regen: true

   # What delay should AAC force between regeneration?
   min_regen_delay: 3600

   # What delay should AAC force if the player is fully satiated?
   min_satiated_delay: 450

   # Map of violation levels to commands
   thresholds:
      10: "aacstaffnotify {player} in {world} is trying to regain health too quickly (ping = {ping}, tps = {tps})"
      20: "aackick {player} Regenerating health too quickly"

# Killaura detects combat cheats which give an unfair advantage.
killaura:
   # Do you want to enable the killaura check?
   enabled: true

   # What % of the time should AAC do a check?
   check_chance: 100

   # Lag compensation paramters - shouldn't need changes
   check_delay: 3
   listen_delay: 6

   # How far away must 2 players be to be checked?
   min_dist: 1.2

   # How long should the check last?
   duration: 20

   # How much should the check be weighted?
   weight: 4

   # How far off should a player be able to look to allow the hit?
   max_diff: 0.12

   # How far should the player be allowed to reach during the check?
   max_reach: 4.6

   # Map of violation levels to commands
   thresholds:
      30: "aacstaffnotify {player} in {world} might be using killaura (ping = {ping}, tps = {tps})"
      75: "aackick {player} Killaura"

# Heuristics are used by AAC to detect advanced killaura cheats that bypass normal checks.
heuristics:
   # Do you want to enable AAC's heuristic detection?
   enabled: true

   # Heuristic confidence required for a violation. This is calculated as a percentage from 0.0% to 100.0%.
   # Represents how likely a player is to be using killaura, based on heuristic analysis.
   # Must be: 50 <= min_confidence < 100
   # For reference: min_confidence of 85 has been tested to have practically zero false detections.
   min_confidence: 75

   # List of patterns which should not incur a violation
   # Should be a 4 character string, usually "P/" followed by two digits
   # The suffixes of ? and ! must be included to fully exempt all cases of a pattern
   exempt:
    - "P/XX?" # This is an example entry.

   # Map of violation levels to commands.
   # The heuristics check is different to other checks: higher violation level does not mean a higher confidence.
   # All violation levels are equal. The default threshold of 10 creates the effect of a delayed ban.
   thresholds:
      1: "aacstaffnotify {player} in {world} is fighting suspiciously (AAC heuristic analysis) (ping = {ping}, tps = {tps})"
      10: "aackick {player} Suspicious combat"

# NoFall ensures players take fall damage.
nofall:
   # Do you want to enable the NoFall check?
   enabled: true

   # What downward velocity is needed to check for nofall?
   required_velocity: -0.2

   # Should AAC deal fall damage to players?
   deal_damage: true

   # Map of violation levels to commands
   thresholds:
      10: "aacstaffnotify {player} in {world} might be trying to avoid fall damage (ping = {ping}, tps = {tps})"
      30: "aackick {player} Suspicious activity midair"

# Jesus stops people from walking on water.
jesus:
   # Do you want to enable the Jesus check?
   enabled: true

   # Should Jesus teleport players?
   teleport: true

   # Map of violation levels to commands
   thresholds:
      15: "aacstaffnotify {player} in {world} is trying to walk on water (ping = {ping}, tps = {tps})"
      30: "aackick {player} Walking on water?"

# Phase stops people glitching through blocks.
phase:
   # Do you want to enable the Phase check?
   enabled: false

   # Which blocks should be exempt from phase checking?
   # Items are included in this list due to potential ViaVersion/cross version compatibility problems with 1.8
   # Should be entered exactly as seen on the Spigot Material enum.
   exclude:
   # Incorrect hitboxes on 1.8 servers
    - "ANVIL"
    - "CHEST"
    - "ENDER_CHEST"
    - "TRAPPED_CHEST"
    - "SOIL"
   # Entity hitboxes
    - "AIR"
    - "STATIONARY_WATER"
    - "WATER"
    - "STATIONARY_LAVA"
    - "LAVA"
   # Protocol hack hitboxes
    - "WATER_LILY"
   # Moving pistons
    - "PISTON_MOVING_PIECE"

   # Map of violation levels to commands
   thresholds:
      40: "aacstaffnotify {player} in {world} might be trying to phase into blocks (ping = {ping}, tps = {tps})"
      80: "aacmessage {player} Please disconnect and log back in if you are stuck inside a block"

# FastUse stops players using items too quickly.
fastuse:
   # Do you want to enable the FastUse check?
   enabled: true

   # What delay should AAC enforce for eating an item? (ms)
   ms_to_use: 1200

   # Map of violation levels to commands
   thresholds:
      2: "aacstaffnotify {player} in {world} is trying to consume items too quickly (ping = {ping}, tps = {tps})"
      5: "aackick {player} Using items too quickly"

# FastBreak stops players from breaking blocks too quickly.
fastbreak:
   # Do you want to enable the fastbreak check?
   enabled: false

   # How many ticks should fastbreak count as lag, and ignore?
   let_ticks: 2

   # Should AAC cancel an illegal block break?
   cancel_break: true

   # Should AAC check for a break delay? (i.e. between block breaks)
   check_delay: true

   # How many violations before AAC starts cancelling block breaks?
   cancel_vl: 1

   # Map of violation levels to commands
   thresholds:
      10: "aacstaffnotify {player} in {world} seems to be breaking blocks too quickly (ping = {ping}, tps = {tps})"
      15: "aackick {player} Mining too quickly"

# FastPlace stops players from placing blocks too quickly.
fastplace:
   # Do you want to enable the fastplace check?
   enabled: false

   # How many blocks should a player be allowed to place in one second?
   max_place_per_second: 10

   # Should AAC cancel an illegal block place?
   cancel_place: true

   # How many violations before AAC starts cancelling block placements?
   cancel_vl: 4

   # Map of violation levels to commands
   thresholds:
      15: "aacstaffnotify {player} in {world} is placing blocks too quickly (ping = {ping}, tps = {tps})"
      30: "aackick {player} Placing blocks too fast"

# Nuker stops players in creative mode from breaking too many blocks at once.
nuker:
   # Do you want to enable the nuker check?
   enabled: false

   # How many blocks should a player be able to break in 1 second: vl if greater than this value
   max_breaks_per_second: 40

   # The violation will only be recorded if it divides by this number (reduces spam)
   vl_divisor: 41

   # Map of violation levels to commands
   thresholds:
      5: "aacstaffnotify {player} in {world} is using creative-mode nuker (ping = {ping}, tps = {tps})"
      10: "aackick {player} Nuker"

# Interact stops players interacting in impossible situations, like when they're dead or behind a wall.
interact:
   # Do you want to enable the impossibleinteract check?
   enabled: true

   # Detect interacting with liquids?
   cancel_liquids: true

   # Detect ghosthand to interact with blocks?
   cancel_ghost_block: true

   # Detect interacting whilst dead?
   cancel_dead: true

   # Detect hitting whilst using an item?
   cancel_item_attack: true

   # Detect hitting through walls?
   cancel_ghost_attack: true

   # Violation before AAC starts cancelling interact when detecting ghosthand
   cancel_vl_interact: 5
   cancel_vl_place: 5
   cancel_vl_break: 0

   # Map of violation levels to commands
   thresholds:
      20: "aacstaffnotify {player} in {world} is interacting suspiciously (ping = {ping}, tps = {tps})"
      40: "aackick {player} Interacting suspiciously"

# Velocity makes sure that players take proper knockback.
velocity:
   # Do you want to enable the velocity check
   enabled: true

   # How many ticks should AAC check a player for? Higher values compensate for higher ping.
   check_length: 15

   # What is the maximum distance AAC should teleport a detected player?
   # If this is zero, the detected player will not be teleported at all
   max_tp_dist: 3.0

   # How many violations before AAC starts teleporting players who ignore velocity?
   min_vl: 8

   # How much should AAC increase a player's violation level by on detection?
   vl_normal: 2

   # If a player seems frozen (e.g. changing resource packs/lagging), how much should AAC increase their violation level?
   # 0 by default to prevent false positives with changing resource packs
   vl_no_packet: 0

   # Map of violation levels to commands
   thresholds:
      10: "aacstaffnotify {player} in {world} seems to be ignoring velocity"
      20: "aackick {player} Not taking knockback"

# Spam prevents players from spamming the server chat.
spam:
   # Do you want to enable the spam check?
   enabled: false

   # What words should not be covered by the anti-spam check?
   # messages less than 3 letters are already ignored
   whitelist:
     - "lol"
     - "hello"
     - "okay"

   # How many messages should a player be able to send in 10 seconds
   message_limit: 4

   # How fast can a player send messages (ticks)
   chat_speed: 10

   # Map of violation levels to commands
   thresholds:
      10: "aacstaffnotify {player} in {world} is spamming the chat"
      15: "aackick {player} Stop spamming, you sad person"

# Parameters for AAC's packet level movement check system. It is required for nearly all checks.
# Monitors movement rate and illegal movement positions.
move:
   # This must be enabled to use any movement check in AAC, and is also required for some world and combat checks.
   # Do not disable, or most of AAC will stop working and errors will spew out into the console.
   enabled: true

   # How much lag should AAC compensate for? (ticks)
   min_balance: -60

   # How many extra packets should a player be allowed to send?
   cancel_threshold: 5

   # What balance should AAC set the player to when the connection seems normal?
   reset_level: -1

   # How high should the internal packet balance be allowed to get?
   balance_cap: 10

   # At what tick interval should AAC reduce 1 VL from the player?
   decay: 25

   # What teleport offset should AAC accept from players?
   tp_accept_threshold: 0.001

   # Map of violation levels to commands
   thresholds:
      200: "aacstaffnotify {player} in {world} is sending unusual movement information (ping = {ping}, tps = {tps})"
      1000: "aackick {player} Sending unusual movement packets"

### General things

# How many times must a player be kicked before he is banned (-1 for no autoban)
# The kick command used must be /aackick for this to work.
# Disabled by default.
ban_threshold: -1

# What command should be executed when a player is banned (only applies for /aackick)
ban_command: "aackick {player}"

# How long after a player is kicked should he be allowed to log in (ticks)
kick_ticks: 120

# Should AAC log events to a file?
log_file: true

# Should /aackick broadcast a message?
aackick_broadcast: false

# Should AAC disable/enable checks dynamically? IF YOU HAVE PWP DISABLE
usetps: true

# Enable verbose logging? This splits log output and pipes some to administrators. Not recommended for normal use.
#verbose: false
#log_console: false