Configuration

circle-info

The best configuration of the anticheat is the default configuration unless you have issues with some players' actions that you allow on your server (example: Prop spawn spam) or bad quality scripts. If you do not have any issue with players' actions or bad quality scripts, do not modify the configuration file unnecessarily. Update the configuration file only if needed and only if you know what are you doing. Modifying the configuration file without knowing what are you doing or causing errors can lead to security, server or anticheat issues

The configuration file can be found in config folder of anticheat resource named config.lua. Inside the config file you can set values or actions for every feature of anticheat. Down below, each feature will be detailed with more details about each feature even though there are instructions in the config file. Copy and find in the config file the feature you need to adjust
circle-exclamation

Anti stop resource

The anti stop resource will prevent player to stop the anticheat resource. This feature does NOT exist in config to be set to true or false, as if it was possible to set to false, your server would have been exposed to a very high risk and anticheat will not monitor some cheating actions and we would have been exposed as bad advertisment. Resource stopped means that client lost the tranmission with server and there are only five cases when the client loses the transmission with the server which are:
  1. Resource stopped from executor (most common)

  2. Host low performance: unstable network (freezings, drops, packet loss, DDOS attacks), lost internet, poor specifications

  3. Server low performance: high server resource consumption

  4. Player's low pc performance: poor specifications

  5. Player's bad internet connection: unstable internet connection, low internet speed

Stopping resource from executor is the most common reason (1). In case all players got kicked for stop resource it means that the server or host has low performance (2) (3). In case only one player got kicked for stop resource it means he stopped the resource from cheat (1) or he has low pc performance or bad internet connection (4) (5), where stop resource is the most common reason. The penalty can be KICK (if the player stops the resource while he is on the server) or BAN (if the player stops the reasource before joining the server)
circle-info

The anti stop resource check does not produce false positives. In case there are multiple player disconnect with the reason Server-client inactivity, this means a server timeout (both Server-client inactivity and server timeout given by FiveM are the same thing). In such cases, it is recommended to monitor your host and server performance to ensure a stable server-client connection (checking the host network and server consumption). Server-client inactivity is not affected by the anticheat resource and the anticheat has no issue in checking the anticheat resource activity on each player. If you deal with such issues, you have to solve the issue from your side. We can support to find the issue and solve it by giving you advices.

Commands names

Config.Help, Config.ClearAllCommand, Config.ClearVehiclesCommand, Config.ClearPedsCommand, Config.ClearObjectsCommand, Config.BanListCommand, Config.UnbanCommand, Config.UnbanAllCommand - variables that sets your commands names that you can call from server console in order to perform the right action. For more guidance visit Commands section

Config.SafeGameEnvironment

Config.SafeGameEnvironment
true: Add extra security to your server environment (more safe then if it is set to false). You need to also add in your server.cfg the following permission: 
add_ace resource.rac command allow

false: Don't allow the anticheat to add extra security to your server

Recommended: true

Config.ScreenshotAPI

circle-info

For hosting images, we recommend Fivemanage. Fivemanage is a specialized image hosting used to store and retrieve screenshots or image logs captured by the anticheat

Config.SendPlayerLogWithImage

Config.LiveKitWebsocketURL, Config.LiveKitAPIKey, Config.LiveKitAPISecret

circle-info

LiveKit is a real-time video and audio infrastructure. LiveKit helps in multi-spectate feature, allowing users with access on the anticheat menu to view live streams of multiple players simultaneously in monitor tab

Config.DiscordServer

Config.AccessMenuIds

Config.HasUserAccessMenuId

circle-exclamation
circle-exclamation

Config.TeleportToPlacesMenu

circle-exclamation

Config.WhitelistedIds

Config.WhitelistedIds

circle-exclamation
circle-exclamation
circle-exclamation

Config.ShowPrints

Config.RockstarId

Config.SteamId

Config.SteamIdAge

Config.DiscordId

Config.DiscordIdAge

Config.MaxNameLength

Config.AntiBlacklistedNames

Config.AntiSpecialCharactersConnect

Config.XSSConnect

Config.AntiEmojiConnect

Config.AntiVPN

Config.AntiMultipleSessions

Config.AntiBanEvade

Config.AntiBanEvadeIP

circle-info

Under both Config.AntiBanEvade and Config.AntiBanEvadeIP, do not players fool or manipulate you with excuses like "I have never cheated" or "It was not me, it was my brother / cousin playing in my house / on my computer". Always check their previous IP activity

circle-info

The only edge case of a false ban detection is under Config.AntiBanEvadeIP, if there are two players from the same small city or rural area

Config.AntiSpoofer

Config.AntiReleaseMode

Config.AntiMenus

Config.AntiExecutor

circle-info

Config.AntiExecutor does not make pc/files checks, it is just an algorithm based on player's actions while he is using or navigating through the cheat menu. This algorithm does not guarantee 100% that the player has really used a cheat menu, but you will get rid of some cheaters and in case the player reports a false ban you can check on him

Config.AntiLuaInject

circle-info

Config.AntiLuaInject feature can be installed manually in every resource that you want to monitor. In order to install this feature, you have to add the following lines in the fxmanifest of the resource you want to monitor if the cheater executes code from that resource:

circle-info

Config.AntiLuaInject feature can be installed automatically using command racinstallantiluainject [resourcename | all], but make sure you create a backup of your server before using this command as all fxmanifest of your resource(s) will be modified. The command racuninstallantiluainject [resourcename | all] will revert the process of command racinstallantiinject, so it will remove the lines added above from your fxmanifest of your resource(s)

Config.DeathPrint

Config.DamagePrint

Config.ComaHealth

Config.AntiExplosions

Config.BlockedExplosions

circle-exclamation
circle-info

Explosion occured from client will not work. Banned reason can tell that the explosion has not been occured by the player. This means that the explosion has not been occured on the server, only from client, so this means it occured from a cheating method

Config.AntiInvisibleExplosions

Config.AntiSilentExplosions

Config.AntiSpamExplosions

circle-info

Vehicle explosion is a common method used by cheaters in order to deal damage to players. With Config.AntiSpamExplosions set to true, vehicle explosion is handled in order to cancel the damage to players and punish the player who tries to explodes with this method

Config.AntiProjectiles

Config.AntiSpamProjectiles

Config.WhitelistedProjectiles

circle-exclamation

Config.AntiParticles

Config.WhitelistedParticles

circle-exclamation

Config.AntiCollision

Config.RemoveCollisionProps

circle-exclamation
circle-exclamation

Config.FrameworkAntiWeapons

Config.FrameworkAntiWeaponsCheck

circle-info

weaponname is the name of the item/weapon (Example: WEAPON_PISTOL)

circle-exclamation
circle-exclamation

Config.AntiBlacklistedWeapons

circle-info

Config.AntiBlacklistedWeaponsPenalty is applied only for the players who damage other players with a blacklisted weapon. Our detections for having in loadout, pull out, shoot or aim with a blacklisted weapon will only remove the weapon (due to an unfixable exploit where cheaters can give weapons to other players without being detected -> this exploit is cancelled only if Config.SafeGameEnvironment is set to true), but in case he succeed damage a player with a blacklisted weapon, he will get penalty.

Config.BlacklistedWeapons

circle-exclamation

Config.AntiExplosiveWeapons

Config.AntiLoadout

circle-info

Loadout citizen file is a file that can be added to fivem data game, where players can load weapons (only for those who loads the file) in game when they spawn to the server

circle-info

It is recommended to activate the pure level in your server.cfg, even though the player will lose some graphics modes or other files that can benefit them. To add the pure level in your server.cfg you have to add this line:

Config.AntiGiveWeapon

circle-info

There is an unfixable exploit that can give weapons to other players that is not catched by this feature. The only way to cancel this exploit is to set Config.SafeGameEnvironment to true

Config.AntiRemoveWeapon

Config.AntiInfiniteAmmo

Config.AntiInfiniteBullets

Config.AntiRapidFire

Config.AntiNoRecoil

Config.AntiFastReload

circle-info

Fast reload the weapon can be produced by meta files for fast reload the weapon, cheating functions or bug abuse by the players through key bindings or commands from other scripts. In case you give them permission to bug abuse through such things you can keep this to false.

Config.AntiStunPlayer

Config.AntiSuperPunch

Config.AntiDamageModifier

Config.AntiDamageMultiplier

circle-info

The difference between Config.AntiDamageModifier and Config.AntiDamageMultiplier is that damage modifier applies changes on the player, while damage multiplier applies changes on the weapon

Config.AntiBulletModifier

Config.AntiSilencedWeapon

Config.AntiRangeModifier

Config.AntiKill

Config.AntiKillPlayersInMass

Config.AntiSpawnWeapon

Config.AntiSpoofWeapon

circle-info

Set this feature to false will allow cheaters to use aimbot, silent aimbot and magic bullet if they use spoof or spawned safe weapons

Config.AntiMetaFiles

circle-info

It is recommended to activate the pure level in your server.cfg, even though the player will lose some graphics modes or other files that can benefit them. To add the pure level in your server.cfg you have to add this line:

Config.AntiAimbotAccuracy

Config.AntiAimbotRpf

circle-info

It is recommended to activate the pure level in your server.cfg, even though the player will lose some graphics modes or other files that can benefit them. To add the pure level in your server.cfg you have to add this line:

Config.AntiAimbot1

circle-info

If Config.AntiAimbot2 feature is set to true, keep Config.AntiAimbot1 to false

circle-info

This feature does not penalty the player if he uses aimbot, it just disable the functionality of aimbot

Config.AntiAimbot2

circle-info

This feature does not penalty the player if he uses aimbot, it just disable the functionality of aimbot

circle-info

Config.AntiAimbot2 is very accurate at disabling aimbots by eliminating the aimbot, compared to Config.AntiAimbot1, which allows a small time frame where aimbot might work due to the weapon pullout animation

circle-info

If you prefer to keep this small time frame when aimbot might work, you can set Config.AntiAimbot1 to true and Config.AntiAimbot2 to false, but it is still disabling aimbot in most cases, beside the small time frame of weapon pullout animation (Instant shot cases).

circle-info

If both Config.AntiAimbot1 and Config.AntiAimbot2 are set to true, Config.AntiAimbot2 will handle the anti aimbot functionality

Config.AntiAimbot3

circle-info

The Config.AntiAimbot3 feature is recommended to be on true, even if Config.AntiAimbot2 or Config.AntiAimbot1 are set to true because the Config.AntiAimbot3 feature adds extra check and penalty in case a cheater finds a way to hook our algorithm to disable the aimbot functions

circle-info

The Config.AntiAimbot2 or Config.AntiAimbot1 features are recommended to keep to true (either Config.AntiAimbot2, either Config.AntiAimbot1 -> we recommend Config.AntiAimbot2 to set to true and Config.AntiAimbot1 set to false), even if Config.AntiAimbot3 is set to true because the Config.AntiAimbot3 feature is just an extra check to give penalty in case a cheater finds a way to hook our algorithm to disable the aimbot functions, while Config.AntiAimbot2 or Config.AntiAimbot1 disable most of aimbot functions

Config.AntiSilentAim

circle-info

This feature does not penalty the player if he uses silent aimbot or magic bullet, it just disable the functionality of silent aimbot and magic bullet

Config.AntiSilentAim2

circle-info

The Config.AntiSilentAim2 feature is recommended to be on true, even if Config.AntiSilentAim is set to true because the Config.AntiSilentAim2 feature adds extra check and penalty in case a cheater finds a way to hook our algorithm to disable the silent aimbot or magic bullet functions

circle-info

The Config.AntiSilentAim feature is recommended to keep to true, even if Config.AntiSilentAim2 is set to true because the Config.AntiSilentAim2 feature is just an extra check to give penalty in case a cheater finds a way to hook our algorithm to disable the silent aimbot or magic bullet functions, while Config.AntiSilentAim disables most of silent aimbot or magic bullet functions

Config.AntiCornerShoot

Config.AntiTriggerbot

circle-info

There are three possible ways a player can be detected by the Config.AntiTriggerbot feature, as there are multiple triggerbot functionalities: Anti Triggerbot (1) – the player is only aiming and the menu shoots automatically Anti Triggerbot (2) – similar to Anti Triggerbot (1), but analysing in a different way in case the player is not caught by Anti Triggerbot (1) Anti Triggerbot (3) – detect if player aims on body and hits in head

Config.AntiESP1

circle-info

Info: This feature does not penalty the player if he uses ESP, as ESP softwares are impossible to be detected

Config.AntiESP2

circle-info

Info: This feature does not penalty the player if he uses ESP, as ESP softwares are impossible to be detected

Config.AntiBlacklistedVehicles

Config.BlacklistedVehicles

circle-exclamation
circle-exclamation

Config.AntiBlacklistedModels

Config.WhitelistedModels

circle-exclamation
circle-exclamation

Config.AntiBlacklistedPeds

Config.WhitelistedPeds

circle-exclamation
circle-exclamation
circle-exclamation

Config.AntiBlacklistedProps

Config.WhitelistedProps

circle-info

You are able to add in the Config.WhitelistedProps table either name or hash of prop / object. Adding the hash is in case you have a custom prop / object and cannot find the name of the prop / object.

circle-exclamation
circle-exclamation

Config.OneSyncEntities

Config.CountEntities

circle-info

For Config.VehiclesCounter there is also a check if the player has spawned in the network more than (Config.VehiclesCounter + 5) vehicles. If the player exceeded this value, all unoccupied vehicles will be deleted

triangle-exclamation

Config.EntitySpawnCheck

circle-info

By default it is set to true, but test your server and be sure that this feature will not break your scripts which have creating entities functions. Keep this feature to true only if you are very sure that will not cause issues for spawning entities, otherwise set it to false

circle-info

The only penalty for spawning entities from outside the server is BAN and it cannot be changed. Config.CountEntitiesPenalty is not the penalty for this feature. In case you want to disable this feature, set Config.EntitySpawnCheck to false

circle-info

The Config.EntitySpawnCheck feature will not affect or insert anything to your server scripts

circle-info

The Config.EntitySpawnCheck feature will catch entities spawned from cheating methods only if the cheat did not inject in any of your server resources

triangle-exclamation

Config.AdvancedEntitySpawnCheck

circle-info

The Config.AdvancedEntitySpawnCheck feature will not affect or insert anything to your server scripts

circle-info

The Config.AdvancedEntitySpawnCheck feature is different from Config.EntitySpawnCheck, as it checks if the entity has been spawned from a valid script that can create vehicles, peds or objects/props

circle-info

By default it is set to false, but test your server and be sure that this feature will not break your scripts which have creating entities functions, before set to true. Set this feature to true only if you are very sure that will not cause issues for spawning entities, otherwise set it to false

circle-exclamation
triangle-exclamation

Config.AnticheatEntityLockdown

circle-info

Config.AnticheatEntityLockdown feature requires manual installation in every resource where you spawn entities. In order to install this feature, you have to replace natives for entity creation CreateVehicle, CreatePed and CreateObject in both server side and client side files as following:

Example:

Before

After

Config.EntitiesTimer

Config.AntiInvisibleEntities

triangle-exclamation
circle-info

It is recommended to create a backup of your server files before shift and make tests after shift

circle-info

For more information about how to shift entity creating from client-side to server-side directly from your server you can follow the Secure your server section

Config.AntiEmptyVehicle

Config.AntiAttachVehicles

Config.AntiFlyingVehicles

Config.AntiLaunchingVehicles

Config.AntiBlackholeVehicles

circle-info

Blackhole function will work only for vehicles that the player owns, but in case the cheater will start a blackhole function, the Config.AntiBlackholeVehicles feature will stop and eventually delete the vehicles from blackhole

Config.AntiVehicleWeapons

Config.AntiKillEngine

Config.AntiKillWheels

Config.AntiKickFromVehicle

Config.AntiVDM

Config.AntiVehicleParachute

Config.AntiVehicleNoclip

Config.AntiVehicleFix

Config.AntiVehicleChangeColor

Config.AntiVehicleChangeMods

Config.AntiTeleportIntoVehicle

circle-info

If a player will perform multiple times teleportation into vehicles or other players' vehicle he will get banned

Config.TeleportIntoVehicles

circle-info

In case you use scripts (such as job scripts) that spawns vehicles at a long distance from the player you should better adjust the script to first teleport the player to the create vehicle location using SetEntityCoords for your player instead of adding the vehicles inside the Config.TeleportIntoVehicles table or setting Config.AntiTeleportIntoVehicle to true.

Example of usage native SetEntityCoords before vehicle creation

Before

After

Config.AntiStealVehicle

circle-info

The Config.AntiTeleportIntoVehicle feature will prevent players to teleport inside other players' vehicles, so they cannot steal their vehicles, but it is good to keep the Config.AntiStealVehicle feature to true in case the Config.AntiTeleportIntoVehicle feature does not take action and player succeed to steal the other players' vehicles.

Config.AntiVehicleSpeedHack

Config.AntiVehicleRocketBoost

Config.AntiInstantBrake

Config.AntiLongDistanceVehicle

Example of usage native SetEntityCoords before vehicle creation

Before

After

Config.AntiMultipleSameVehicles

Config.AntiMultipleVehicles

Config.AntiNoDriverVehicle

Config.AntiNoDriverExcludeVehicles

Config.AntiChangeVehiclePlate

Config.AntiBlacklistedPlate

Config.BlacklistedPlates

circle-exclamation
circle-exclamation

Config.AntiPickup

Config.AntiSpamChat

Config.AntiBlacklistedWords

Config.BlacklistedWords

circle-exclamation

Config.AntiBlacklistedCommands

Config.BlacklistedCommands

circle-exclamation

Event protection (SecuredServerEvents, SecuredClientEvents)

circle-exclamation
circle-info

Documentation for event protection has been taken from Commands section

Config.AntiSpamTriggers

Config.SpamTriggers

circle-exclamation
circle-exclamation

Config.AntiBlockedEvents

Config.BlockedEvents

circle-exclamation

Config.TriggerEventsExploitCheck

Config.AntiBlacklistedAnims

Config.AntiClearPedTasksEvent

Config.AntiFreeze

circle-info

Even if a cheater has no possibility to freeze another player or another player's vehicle as he cannot manipulate players or vehicles that does not own, it is a feature that you can leave set to true. The only way a cheater can freeze another player or another player's vehicle is if he uses an existent code from your server

Config.AntiFire

Config.AntiVoid

Config.AntiSound

Config.AntiSpectate

Config.AntiFreecam

Config.AntiFreecamShot

Config.AntiNoclip

Config.AntiNoclipShot

Config.AntiTeleport

Config.AntiTeleportToWaypoint

Config.AntiInvisible

Config.AntiWalkUnderWater

Config.AntiDisableHeadshot

Config.AntiGodmode

Config.AntiGodmode2

circle-info

Both Config.AntiGodmode and Config.AntiGodemode2 will perform analysing if the player has god mode functions or not. Config.AntiGodmode already detects majority types of god mode functions, but in order to cover all types of godmode functions you have to set your server safezones to Config.ServerSafezones table and Config.AntiGodemode2 to true to ensure more security against these types of functions

circle-exclamation

Config.AntiInfiniteHealth

Config.AntiRevive

circle-info

Config.AntiRevive feature requires manual installation in every resource where you give health to player. In order to install this feature, you have to replace natives for giving health to player SetEntityHealth in client side files as following:

Example

Before

After

Config.AntiInfiniteArmour

Config.AntiArmour

circle-info

Config.AntiArmour feature requires manual installation in every resource where you give armour to player. In order to install this feature, you have to replace natives for giving health to player SetPedArmour and AddArmourToPed in client side files as following:

Example

Before

After

Config.AntiInfiniteStamina

Config.AntiRagdoll

Config.AntiNightVision

Config.AntiThermalVision

Config.AntiMenyoo

Config.AntiTrackPlayers

Config.AntiSpeedHack

Config.AntiTinyPed

Config.AntiSuperJump

Config.AntiFallingPeds

Config.AntiClonePed

Config.AntiAggressivePeds

Config.AntiCrasher

Config.AntiDevTools

Config.AntiSoloSession

Config.AntiFakeDesync

Config.AntiCombatRoll

Config.AntiInfiniteRoll

Config.AntiBlacklistedOutfits

circle-info

This feature is useful for players who equip troll outfits

circle-exclamation
circle-info

The key names match the name of component id from native SetPedComponentVariation (https://docs.fivem.net/natives/?_0x262B14F48D29DE80arrow-up-right)

circle-exclamation

Example:

circle-exclamation

Example:

circle-exclamation

Config.AntiCopyOutfit

circle-info

This feature checks if a player changed his outfit through some monitored component variations using a complex algorithm that will not impact with your server's uniforms or EUP systems from jobs or factions or change clothing systems in a standalone way. The only edge case possible to be detected by the algorithm as a player, is only through commands or options that will refresh your outfit, changing your uniform or EUP to the initial player outfit (the outfit saved in the player database), and at least one player from the server has exactly the same outfit (all component variations) or even commands or options that can copy the outfit of a player.

Config.AntiRandomizeOutfit

Config.UseModuleScreenshotBasic

circle-info

Screenshot-basic is a basic resource provided by FiveM for making screenshots of clients' game. Installing screenshot-basic resource requires to also add its dependencies yarn and webpack which are also basic resources provided by FiveM. Without these dependencies, only the screenshot-basic resource installed, the resource screenshot-basic will not start

circle-info

The Config.UseModuleScreenshotBasic feature is used for the anti blacklisted words on screen (anti menus) system / OCR system in order to record the player's screen. In case Config.UseModuleScreenshotBasic is set to true, but you do not have the screenshot-basic resource installed and started, the anti blacklisted words on screen / OCR system will not work

Config.AntiBlacklistedWordsOnScreen

circle-info

The Config.AntiBlacklistedWordsOnScreen feature requires to set Config.UseModuleScreenshotBasic feature to true and install screenshot-basic resource with its dependencies (yarn, webpack)

circle-info

By default this feature is set to false (Config.AntiBlacklistedWordsOnScreen) to let you install the resources screenshot-basic, yarn, webpack first in order to make it work. After installing these resources provided by FiveM you can set Config.UseModuleScreenshotBasic and Config.AntiBlacklistedWordsOnScreen to true

Config.BlacklistedWordsOnScreen

circle-info

If Config.UseModuleScreenshotBasic and Config.AntiBlacklistedWordsOnScreen are set to true, anti blacklisted words on screen / OCR system will monitor the player's screen and in case the player's screen contains one of these words from the table, the player will be penalty with Config.AntiBlacklistedWordsOnScreenPenalty

circle-info

Anti blacklisted words on screen / OCR (Optical Character Recognition) system will catch faster a player that injected a lua menu for cheating (no executor), but even if it is set to false, it does not mean the anticheat will not detect cheaters' actions. By setting Config.UseModuleScreenshotBasic and Config.AntiBlacklistedWordsOnScreen to true, this feature will just detect and penalty faster the player who has a menu on the screen by detecting the blacklisted words on screen from Config.BlacklistedWordsOnScreen

circle-exclamation

Last updated