✓ AACAdditionPro 4.6.2

Welcome to the overview of my plugin, AACAdditionPro.
This anticheat is different.
It is not a comprehensive anticheat, it does not even fit the definition as a part of a pure anticheat.
But it is one of the most sophisticated addons for an anticheat existing, one which strives to support the main anticheat AAC to a full extent, compensating weak spots of your setup, adding unique checks to protect your server and providing several utilities to make your life easier.
My plugin covers a broad range of applications which reach from easy tasks such as automatic log deletion or convenient automation features like Log-Bot to highly advanced checks such as KillauraEntity, Scaffold and Tower.

It is my hope this plugin can live up to your expectations.
~ Photon

Plugin Support

• For setup support, use the #aacadditionpro channel on the AAC Discord (follow steps in #welcome to gain access to the AACAdditionPro channel).
• Please use the official Issue-Tracker if you find issues in the plugin or want to request features.

Private messages and comments on the Discussion page may not be actively checked.

Huge servers trusting this resource:

• Twerion.net | 300 concurrent players
  
• GommeHD.net | 4000 concurrent players
• LPmitKev.de | 150 concurrent players
• mc.universocraft.com | 1200 concurrent players
• play.brover.network | 1000 concurrent players
• neruxvace.net | 700 concurrent players

If you want to see your server on this list please open an issue on the Issue-Tracker.

Donators:

• Relinquished

Please message me if you want to join the donators club.
Donations are always appreciated



AACAdditionPro currently features 14 checks.

• AutoFish: This check will prevent Auto-Fishing mods (Only available in Minecraft 1.11 and above). It consists of 2 parts which are seperately configurable:
  • Inhuman reaction: Detects robot-like reaction times after a fish bites the lure.
  • Consistency: Detects consistent reaction times over many fishing events.
• AutoPotion: This check provides a very fast and reliable detection of some AutoPotion cheats (Only available in Minecraft 1.11 and above)
• Esp: Prevents clients from seeing players through solid blocks by hiding information which cannot be obtained in a legit way. It also considers 3rd person cameras and uses exact hitbox calculations.
  • Even though this check is named "Esp" it will also block all other render modifications such as Tracers, Radar and Nametags.
    
  • Sneaking-Hider: This will completely hide sneaking players when you cannot see them directly (Available on all versions)
    
  • Equipment-Hider: This will censor the equipment of a player when you cannot see him directly, thus making it harder for cheaters to estimate the strength of a potential enemy. (Only available in Minecraft 1.11 and above)
• Fastswitch: This will detect some Autotool and Scaffold mods.
• ImpossibleChat: This check rejects a message if it was sent while the player had an open inventory, was dead or in other situations that make sending a chat message impossible. This is useful if you want to prevent players chatting with -Redacted- client modifications. The check is disabled by default due to potential incompatibilities with some gamemodes.
• Inventory: This check covers all aspects of inventory checking with its different parts.
  • Hit: This part blocks the hitting of other players if an inventory is open. Many Killaura/Triggerbot and AutoArmor clients trigger this check.
  • Move: This part detects player-caused movement while an inventory is open.
    
  • MultiInteraction: This check enforces delays between the interactions of a player, thus slowing all inventory cheats down.
    
  • Rotation: This part detects head movement while having an open inventory. This check detects lots of AutoArmor / AutoItem mods if those are silent.
    
  • Sprinting: This part detects sprinting and sneaking while having an open inventory
• InventoryHeuristics: A powerful machine learning detection for cheaters who otherwise go by unnoticed! This is a framework for the creation and training of neural networks. It applies real machine learning to your server. (This check is currently being recoded and might not be ready for production server use)
  • Checking: InventoryHeuristics has pre-built patterns that a server owner does not need to configure. More patterns will be added over time.
    
  • The full framework: Inside the config you will find an option to unlock the full framework of the InventoryHeuristics to create and train your own patterns. It is a powerful tool, but does require some initial knowledge of neural networks.
    
  • Hardcoded patterns: In addition to trained patterns, AACAdditionPro comes with several hardcoded standard patterns, which are not based on a neural network, but instead try to detect some more general behavior associated with cheats.

• KillauraEntity: This adds advanced entities that are key to catching many Aimbot/Killaura clients. (This check is currently being recoded and might not be ready for production server use) (Please note that 1.8.8 - 1.12.2 setups via ViaVersion are only supported if you deny joining with 1.9 clients. This can be easily set up with VersionControl):
  • Legit movement simulation: The entity has gravity, jumping, velocity and collision simulation. Moreover, it also uses the packet management of a normal Minecraft client.
  • Randomized gear simulation: The entity is not just some naked person floating around you. Armor, equipment, random ping, switching items and joining teams are only some of the features the entities have to trick the more intuitive hack clients.
  • Extensive API and config: The section of the check is by far the largest in my config. Even without knowing java and how to use an API you can refine the entities to a big extent, but if you can use it your possibilities are almost infinite: You can easily spawn and despawn entities, request only items to be equipped that are obtainable in your gamemode, alter the movement engine on the fly and set custom GameProfiles to make skins work.
  • Checking on demand: KillauraEntity can be used solely on demand if configured. In this case, you can use the entitycheck subcommand to invoke a manual check for a specified duration. This is helpful if you do not want a 24/7 visible entity and just want to check users who have triggered checks associated with Killaura.
• PacketAnalysis: This check examines the packets sent by a player to detect various modifications.
  • Compare: The main anti-pingspoof check in my plugin. It compares the response times of the client with certain packets to detect malicious delays.
    
  • EqualRotations: Detects invalid angles sent by the client which are equivalent to the last angle. This detects some mods that modify your server-sided view, such as Tower, Scaffold, Killaura and Aimbot.
  • KeepAlive: This is foundation of the other check and prevents -Redacted- KeepAlive packets from being sent in order to bypass other parts of PacketAnalysis. Moreover it helps to speed up the detection of various cheats.
  • PositionSpoof: A check which main goal is to prevent -Redacted- position packets that may bypass other parts of the check.
• Pingspoof: This will detect spoofed pings which can be used to partly bypass your setup. Very few anti-cheats have a comparable and reliable check like this. It also increases the detection speed of Derp cheats. This check is disabled by default as PacketAnalysis is going to absorb (and partially already absorbed) Pingspoof's detection methods.
  
• Scaffold: A check designed to detect Scaffold, a building cheat popular in games like Bedwars. It consists of multiple parts which can roughly be divided into 2 categories:
  • Average: This will slow down Scaffold-cheats to a speed that is achievable by legit players. In conjunction with reliable AAC checks this part is pretty much unbypassable, and there have not been any bypasses for several months.
  • Behaviour analysis: These checks will try to detect Scaffold by analysing the behaviour of the player detecting most Scaffolds very fast.
• Skinblinker: This check detects Skinblinker modifications.
• Teaming: This check alerts you of possible teamers. You can configure it to only flag teams above a certain amount of members (this check is currently in beta).
  
• Tower: This check will prevent towering up too fast, one of the last movements that is not completely blocked by AAC. Even pretty slow tower-mods will be detected. Important for almost every server with Bedwars/Eggwars or similar. In conjunction with reliable AAC checks this check is pretty much unbypassable, and there have not been any bypasses for several months.

Please notice that the inventory-checks can only recognize an open inventory when a plugin opens it or the player changes items. Otherwise it is hardly detectable without breaking the achievement system.

AACAdditionPro currently has 2 additions.

• BrandHider allows you to customize the server brand shown in the debug screen of Minecraft 1.13 clients. This can be helpful to create debug messages, greet the player or display the current server time as BrandHider works with all placeholders of AACAdditionPro.
  
  
  
  This is just a demonstration. In order to achieve this picture I used the following BrandHider configuration:
  Code (YAML):
  
  # BrandHider allows you to modify the brand that is shown in the debug screen of minecraft.
  # This can be useful if you want to create a custom message or just hide your actual setup.
  BrandHider:
  # Do you want to enable the BrandHider
  enabled: true
  # This is the replacement text for the brand.
  # You can use the character & for color codes and all placeholders that are available in normal checks
  brand: "&k|||&r&d&l&nCurrent time: {time}&r&k|||"
  # If you want to display attributes that update over time, e.g. TPS, Ping, Time or Date this will update the values
  # in the defined interval.
  # Set to 0 to disable the refreshing (recommended if you only use static text or placeholders that do not change)
  # Measured in ticks
  refresh_rate: 20
  
• LogBot automatically deletes log files of your server, AACAdditionPro and AAC that are older than a configurable amount of time. Each category (server, AACAdditionPro, AAC) has its own time-span that can be configured. It also verifies that the deleted files are indeed log files to ensure no accidentially dropped files are deleted.

AACAdditionPro currently has 10 supported mods in ClientControl.

ClientControl can instantly detect some cracked versions of the popular ghost client "Vape" upon login as of a leaked backdoor, a feature that is also used in Hypixel's Watchdog and Badlion's GCheat.

Moreover AACAdditionPro can spoof the health of all living entities, including players, rendering DamageIndicators, HealthTags, and similar mods useless.

Furthermore AACAdditionPro can hook ViaVersion to only let players with a certain client version join your server. Blocking 1.9-1.9.4 clients is required to make your setup compatible with the KillauraEntity check.

ClientControl is a collection of tools to detect some mods and disable features of them if supported. This allows you to make a certain mod legal on your server by disabling the functionality you regard as cheating.

Other usages would include automatic actions, e.g. messaging poeple that there is a endorsed modification for their specific modloader upon login, or automatic punishment if no disabling is available (e.g. blocking the liteloader modification that serves as a basis for many cheat clients)

Contrary to other plugins which offer this feature AACAdditionPro can block just that one feature that you don't like of a mod without touching any other part as long as it supports disabling only parts of it.

Currently you probably have various plugins to block all the desired features. ClientControl allows you to have all your mod controls in one central place with lots of configuration options in a high-quality and up to date environment.

The full list of supported mods and actions can be found on the bottom of the config-gist.

Commands and Permissions:

• aac.verbose: Players with this permission will be able to get the verbose messages of AACAdditionPro if verbose is enabled in the config.
• aacadditionpro.bypass.*: Players with this permission bypass all checks and clientcontrols.

• aacadditionpro.entitycheck: Players with this permission have access to the entitycheck command to invoke a manual entity check (you have to enable this in the config).
• aacadditionpro.info: Players with this permission have access to the info command to show all violation levels of a player.
• aacadditionpro.neural: The initial permission for the full framework of InventoryHeuristics
• aacadditionpro.neural.create: Allows the creation, deletion and renaming of patterns.
• aacadditionpro.neural.train: Allows the training of patterns.
• aacadditionpro.tablistremove: This permission grants access to the tablistremove subcommand to temporarily remove a player from someone's else tablist. This can be helpful for catching cheaters with a Killaura.

AACAdditionPro supports tabcompletion of commands and subcommands.
Just type
/aacadditionpro
followed by a space and press tab to get to all subcommands or autocomplete arguments of the desired subcommand.
In order to get a quick overview of the effects of a certain command just type it in without arguments and add ? to make AACAdditionPro show you the command help.

• /aacadditionpro entitycheck <player> <duration>

• /aacadditionpro info <player>

• /aacadditionpro tablistremove <affected player> <removed player> <duration in ticks>

• /aacadditionpro heuristics
• /aacadditionpro heuristics create <name of pattern> <inputs><neuron count of layer 1> <neuron count of layer 2>...
• /aacadditionpro heuristics list
• /aacadditionpro heuristics remove <pattern>
• /aacadditionpro heuristics rename <pattern> <new pattern name>
• /aacadditionpro heuristics train <pattern> <player to learn from> <output>
• /aacadditionpro heuristics train <pattern> finish
  
• /aacadditionpro verbose
• /aacadditionpro verbose on
• /aacadditionpro verbose off

Please remember you can utilize the ? - character to show the command help.


The AACadditionPro config is heavily commented to explain every option and configurable feature in-depth. For simplicity, AACAdditionPro's config has an identical layout to the AAC config and functions the same with command configuration.

Warning: AACAdditionPro does not auto-update config values, so make sure you check the config revisions after each update and keep up with changes.

Here you can see the default config part for Inventory, the latest complete config.yml is available here.

Code (YAML):
# This check contains a lot of parts covering all aspects of inventory interaction.
Inventory:
# Do you want to enable the Inventory check
enabled: true
# Control the different parts of Inventory
parts:
# This part flags hitting while the inventory is open.
# This part will add 10 vl.
Hit:
# Do you want to enable the hit part
enabled: true
# Violation before AACAdditionPro starts to cancel the hits.
# Set this to 0 to never cancel hits.
cancel_vl: 30
# The move part detects movement when a player is still in his inventory.
# This part will add 3 vl when a player moves illegally and 10 vl if a player jumps illegally.
Move:
# Do you want to enable the move part
enabled: true
# Violation before AACAdditionPro starts to cancel the movements.
# Set this to 0 to never cancel movement.
cancel_vl: 30
# The minimum TPS the server must have to activate this check
# Low TPS will cause an extreme amount of false positives.
min_tps: 19.5
# This allows to add more lenience on servers with very high-ping players by stretching the no-punish time after
# opening an inventory.
# Normal connections are already covered by the default values.
lenience_millis: 0
# The MultiInteraction part prevents players from moving more than one item per tick
# This part will add 1 to 3 vl, depending on the severity of the violation.
MultiInteraction:
# Do you want to enable the MultiInteraction part
enabled: true
# Violation before AACAdditionPro starts to cancel the interacts.
# Set this to 0 to never cancel interacts.
cancel_vl: 18
# If a player has a ping higher than that value he bypasses the check
# Please make sure that you have some pingspoofer protection enabled if you use this feature
# Set this to -1 to disable
max_ping: 400
# The minimum TPS the server must have to activate this check
# Low TPS will cause an extreme amount of false positives.
min_tps: 18.5
# The rotation part detects head movement while having an open inventory.
# This part will add 1 vl.
Rotation:
# Do you want to enable the rotation part
enabled: true
# This part detects inventory interactions while a player is sprinting or sneaking.
# This part will add 20 vl.
Sprinting:
# Do you want to enable the sprinting part
enabled: true
# Violation before AACAdditionPro starts to cancel the inventory interactions.
# Set this to 0 to never cancel inventory interactions.
cancel_vl: 20
# Map of violation levels to command
thresholds:
55: "aacstaffnotify {player} in {world} is suspected for inventory cheats."
80: "aacstaffnotify {player} in {world} is highly suspected for inventory cheats."
100: "aackick {player} Inventory cheats."
You can execute multiple commands per vl, just use the same layout like in aac, i.e.:
Code (YAML):
# Map of violation levels to command
thresholds:
55: "aacstaffnotify {player} in {world} is suspected for inventory cheats."
80: "aacstaffnotify {player} in {world} is highly suspected for inventory cheats."
100:
- "aackick {player} Inventory cheats."
- "aacstaffnotify {player} has been kicked for Inventory cheats."

• {date} will be replaced with the current date (day, month and year)
• {player} will be replaced with the affected player's name
• {ping} will be replaced with the ping of the detected player
  
• {server} will be replaced with the server name (helpful for cross-server notification setups)
• {time} will be replaced with the current time (hour, minutes and seconds)
  
• {tps} will be replaced with the current server tps
• {world} will be replaced with the world in which the violation took place
• {team} will be replaced with a list of all team-members (this placeholder can only be used within the thresholds of the teaming check)

In order to get Verbose messages you need to have the verbose option in the config set to true and you need to have the permission aac.verbose.


AACAdditionPro is recommended to be used with the latest build of AAC and requires ProtocolLib 4.4.0 or higher.

Minecraft version 1.13.0 and 1.13.1 are not supported. Please update to 1.13.2

Minecraft version 1.12.0 and 1.12.1 are not supported. Please update to 1.12.2

Minecraft version 1.11.0 and 1.11.1 are not supported. Please update to 1.11.2

Minecraft versions 1.9-1.10.2 are not supported.

Minecraft versions below 1.8.8 are NOT supported as well. Please update to 1.8.8, this also fixes several critical security and crashing issues.

This plugin is not compatible with reloads. Please restart your server.

While AACAdditionPro will function on most major release versions of MC, more recent versions will generally run better since more tools for optimizing have become available.

Please note that AACAdditionPro utilizes bStats metrics to see usage statistics and general trends. Its privacy policy is available here. You can opt out of bStats in its config which will be generated in the plugin's configuration folder on the first startup.


AACAdditionPro has an extensive api with a main class and several events.

The API of AACAdditionPro allows to set violation levels of a player as well as disable and enable checks and additions while the server is running.

APILoadedEvent
This event is called once the plugin is loaded and ready for hooks.

ClientControlEvent
Called after joining with a client that is covered by ClientControl and can be detected.

InventoryHeuristicsEvent
This event is called when a player is detected by a pattern of InventoryHeuristics. It can be used to disable specific patterns, nerf or buff them by modifying the confidence or any other task you want to connect to the check.

PlayerAdditionViolationCommandEvent
This event gets called when a command is executed from the config and can be cancelled.

PlayerAdditionViolationEvent
The basic event that gets called on a violation and can be cancelled.

The KillauraEntityAddon-system allows you to take full control over the spawned entities in the KillauraEntity check.