- Minecraft Versions
- 1.8, 1.12, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20
Welcome to the overview of my plugin, AntiCheatAddition.
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 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 convenient automation features like Log-Bot over interesting little abilities like changing the brand of your server shown in F3 mode to highly advanced checks such as Inventory, Scaffold and Tower.
AntiCheatAddition is, as the name implies, supposed to be used with a main anticheat (movement, combat, etc).
It is my hope this plugin can live up to your expectations.
~ Photon
Plugin Support
Donations are always appreciated
The full list of supported mods and actions can be found on the bottom of the config-gist.
The AntiCheatAddition config is heavily commented to explain every option and configurable feature in-depth. For simplicity, AntiCheatAddition 's config has an identical layout to the AAC config and functions the same with command configuration.
Warning: AntiCheatAddition 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.
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 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 convenient automation features like Log-Bot over interesting little abilities like changing the brand of your server shown in F3 mode to highly advanced checks such as Inventory, Scaffold and Tower.
AntiCheatAddition is, as the name implies, supposed to be used with a main anticheat (movement, combat, etc).
It is my hope this plugin can live up to your expectations.
~ Photon
- AutoEat: This check will try to detect AutoEat bots that time eating perfectly with inhuman speed.
- AutoFish: This check will prevent Auto-Fishing mods. 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.
- Duping: This check will help you notice any duping exploits on your server.
- DoubleDropped: This check will detect collecting exactly twice the amount of items a player dropped.
- SecretStash: This check will detect the creation of secret stashes (chests that are completely surrounded by blocks) that make it very hard to remove all duped items from your server.
- 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 illegal 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.
- AverageClickHeuristic: This part tries to detect inventory stealers, auto-armor bots and similar modifications that do not randomize their click speed.
- 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.
- PerfectExit: This part detects chest stealers which close the inventory inhumanly fast after the last item is looted
- 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
- PacketAnalysis: This check examines the packets sent by a player to detect various modifications.
- Animation: Detects especially bad Killauras, often called Forcefield, which do not swing the players arm
- 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.
- IllegalPitch: This checks for derp cheats that send pitch values below -90 or above 90 degrees.
- PerfectRotation: Checks if the rotation of a player jumps to accurate values unlike mouse movements.
- 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
- Behaviour analysis: These checks will try to detect Scaffold by analysing the behaviour of the player detecting most Scaffolds very fast
- Shield: This check covers all aspects of shield checking
- Hit: Detects hitting an entity while using a shield.
- 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.
- 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.
Sentinel is a comprehensive framework for plugin messages. It allows you to register your own checks for plugin message channels so you can easily detect all mods instantly on join that send them. Writing a check is no more work than writing a few lines in the config.
If you did not understand the previous paragraph, don't worry. Sentinel comes with a wide range of predefined checks you only need to enable. A few noteworthy mentions:
Sentinel has deep integration with the LabyMod client and allows you to simply set your own server tablist banner, control the features of the client and disable voicechat for your server.
Sentinel can 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.
Sentinel can disable the WorldDownloader mod.
Another aspect of Sentinel is the prevention of various exploits and removal of illegal items.
If you did not understand the previous paragraph, don't worry. Sentinel comes with a wide range of predefined checks you only need to enable. A few noteworthy mentions:
Sentinel has deep integration with the LabyMod client and allows you to simply set your own server tablist banner, control the features of the client and disable voicechat for your server.
Sentinel can 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.
Sentinel can disable the WorldDownloader mod.
Another aspect of Sentinel is the prevention of various exploits and removal of illegal items.
- 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 AntiCheatAddition.
This is just a demonstration. In order to achieve this picture I used the following BrandHider configuration:
Code:# 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
[*]DamageIndicators: This spoofs the actual health of players which is normally sent to all clients and can therefore be displayed by mods and cheat clients. With DamageIndicators enabled all players will appear to have full health for such mods and clients.
[*]EnchantmentHider: This obfuscates your players' enchantments to prevent players using ESP cheats or resource packs such as VisualEnchantments to correctly identify enchantments.
[*]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
- 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.
- AutoFish can only be used on minecraft versions above 1.8
- AutoPotion can only be used on minecraft versions above 1.8
- ESP equipment hiding can only be used on minecraft versions above 1.8
- The DoubleDropped part of Duping can only be used on minecraft versions above 1.8
- The Animation part of PacketAnalysis can only be used on minecraft versions above 1.8
- Various exploit sentinels are not available on minecraft version 1.8 or 1.8 and 1.12.
- Shield can only be used on minecraft version 1.15+
- /anticheataddition main command to print the version of AntiCheatAddition
- /anticheataddition debug [on/off] toggles the debug messages in chat
- /anticheataddition info <player> prints an overview of all violations a player has.
- /anticheataddition setvl <player> <module_id> <vl> set the vl of a player for testing purposes
- /anticheataddition internaltest <subcommand> allows you to spoof cheats without having a cheat client installed. This is mainly for testing purposes and can be used to false flag a player. Make sure only trustworthy people have access to this command.
- anticheataddition.bypass.* allows you to bypass all checks and sentinels.
- If you want to give permission to bypass a specific check, use the format given by the config (in this example the hit part of Inventory):
- anticheataddition.bypass.anticheataddition_inventory.parts.hit
- anticheataddition.bypass.sentinel.* allows you to bypass all sentinel checks.
- If you want to give permission to bypass a specific sentinel, proceed as with normal checks, eg.:
- anticheataddition.bypass.sentinel.custom.<SENTINELNAME>
- anticheataddition.debug allows for seeing debug messages in chat if enabled in the config. Also allows access to the debug command to toggle these messages.
- anticheataddition.info gives access to the info command which prints all violations a player has.
- anticheataddition.internaltest allows a player access to the internaltest command.
- anticheataddition.setvl allows access to the setvl command.
Plugin Support
- For setup support, use the #anticheataddition channel on the AAC Discord
- Please use the official Issue-Tracker if you find issues in the plugin or want to request features.
- Relinquished
- Aquatrooper
Donations are always appreciated
The full list of supported mods and actions can be found on the bottom of the config-gist.
The AntiCheatAddition config is heavily commented to explain every option and configurable feature in-depth. For simplicity, AntiCheatAddition 's config has an identical layout to the AAC config and functions the same with command configuration.
Warning: AntiCheatAddition 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:
# Inventory monitors player's inventory actions. It will auto-disable during low server TPS.
Inventory:
enabled: true
# Players with a higher ping are exempt from the check. Set to -1 to disable.
# Note: Most parts do not depend on ping and will ignore this value.
max_ping: 400
parts:
# Detects regular intervals between inventory clicks, typical of chest stealer bots.
# NOTE: Disable this part if you allow inventory sorting mods.
# Adds 20 to 70 VL
AverageHeuristic:
enabled: true
# This part detects attacking while the inventory is open.
# Adds 20 VL.
Hit:
enabled: true
# VL threshold for canceling attacks. Set to 0 for no cancellations.
cancel_vl: 60
# The move part detects when a player moves while they are in their inventory.
# Adds 5 (moving) to 20 (jumping) VL
Move:
enabled: true
# VL threshold for canceling movements. Set to 0 for no cancellations.
cancel_vl: 60
# Reduces false positives for extremely high ping players, but will make the check less effective.
# Normal connections are covered by the default leniency.
extreme_ping_leniency: false
# The MultiInteraction part prevents players from moving items too fast.
# Adds 1 to 8 VL.
MultiInteraction:
enabled: true
# VL threshold for canceling inventory interactions. Set to 0 for no cancellations.
cancel_vl: 25
# This part detects chest stealers that close empty inventories with perfect timing.
# Adds 20 to 40 VL.
PerfectExit:
enabled: true
# The rotation part detects head movement while having an open inventory.
# Adds 1 VL.
Rotation:
enabled: true
# Detects inventory interactions while sprinting/sneaking.
# Adds 30 VL.
Sprinting:
enabled: true
# VL threshold for canceling inventory interactions. Set to 0 for no cancellations.
cancel_vl: 110
# Uses statistical tests to detect some randomized bot click behaviors.
# Adds 1 to 60 VL.
Statistical:
enabled: true
# Commands to execute at specific violation levels.
thresholds:
110: "<YOUR_STAFFCHAT_COMMAND> {player} in {world} is suspected for inventory cheats."
160: "<YOUR_STAFFCHAT_COMMAND> {player} in {world} is highly suspected for inventory cheats."
200: "kick {player} 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
AntiCheatAddition requires ProtocolLib.
AntiCheatAddition is only compatible with the "tested versions" on top of this page. Generally, only the last sub-version (e.g. 1.16.5 for 1.16) is compatible.
This plugin is not compatible with reloads. Please restart your server.
While AntiCheatAddition 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 AntiCheatAddition 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.
You will need at least Java 17 to run AntiCheatAddition.
