Configuration
Be careful with the values and tables. If you do not keep the same format or delete them it will cause errors.
Config.discordServer - represents the discord link invite for your server. This link will appear as hyperlink when someone gets banned and tries to connect to your server. Ban window will tell them to join your discord server and they can create a ticket to get unbanned. Also, it will be shown the Reason Anticheat discord server in case they are interested in our work, but if they join to our discord we cannot handle their ban, because it is a local ban.Keep the same format if you want to add a player in the table.
Config.detectionStart - after this timer, the anticheat will start all detections from client. This timer has been added in case a player has low performance even though it is also checked the player spawn. It is recommended to set a timer between 10-20 seconds (value of 10000-20000 in config files) to not get any detections while he is in awaiting scripts or falling through the map. Also, if the server has low performance, setting a timer is a good thing.Config.detectionThreshold - represents the timer at which all detections will be performed on player.Config.AccessMenuIds - is a table where you can add all player's identifier who will have access to the menu. Is it enough to add only one identifier (license, discord, fivem, xbl, live, steam) in order to grant access to the in game menu. You can find player's identifiers in your database or anticheat logs. Adding your user licenses to access menu table will also make you a whitelisted user.Config.WhitelistedIds - is a table where you can add all players' identifier who will be protected from almost all anticheat detections (if you use cheat as whitelisted user you can get banned for several reasons. we do not allow cheating at all). Is it enough to add only one identifier (license, discord, fivem, xbl, live, steam) in order to whitelist a player in order to be protected from almost all anticheat detections. You can find player's identifiers in your database or anticheat logs.Keep the same format if you want to add a player in the table.
In case a player is local banned, whitelisting the player will not allow the player to connect to the server. Whitelisting a player with his identifiers will only give access to the anticheat menu and protect him from almost all anticheat detections. In order to allow him connect to the server you should check Bans section to see how to unban a player in order to allow him connect to the server.
Config.Help, Config.ClearAllCommand, Config.ClearVehiclesCommand, Config.ClearPedsCommand, Config.ClearObjectsCommand - variables that sets your command you can call from server console in order to perform the right action. Check category Commands from the documentations to see the usage of commands and their features.Config.BlockedExplosions - is a table where is the name of the explosion along with its id that is allowed or not. In case a player will execute any of this not allowed explosion will get banned on first explosion usage. If the name of the explosion along with its id is commented (-- before explosion) means that it is allowed, else if the name of the explosion along its id is not commented (it has not -- before explosion) means that it is not allowed and the player will get banned if he is execute such explosion. In case you use any explosion on the server it will print the explosion id on anticheat logs so you can allow it. Config.antiExplosions will cancel the explosion used at first usage if it set to true. It is recommended to set it to true. Config.explosionsPenalty represents the punishment for the player who executes the action. The punishment can be WARNING, KICK or BAN. It is recommended to keep it as it is in configuration file by default. In this case, it is recommended to keep it with ban because it can be harmful for your server to spawn explosions on the server. In case you have scripts that uses explosions you have to allow them carefuly in Config.BlockedExplosions (even though you have scripts with explosions it is not recommended to allow any explosion and leave the table as it is by default. a cheater can have in his executor / menu an explosion that is allowed and harm your server).Config.countExplosions will start counting each player explosions used in a certain period of time (Config.explosionsTimer). If a player cause an amount of any type of explosions (Config.explosionsCounter) even though the explosion is allowed (beside the explosions from gas, vehicles or other explosions that can be produced on the server by players) in a certain period of time (Config.explosionsTimer seconds) he will get punished. Even though the explosions from vehicles are not blacklisted they will count in different situations such as the explosion has been produced with no vehicle nearby the player (if there is no vehicle nearby and he is the owner of a vehicle explosion he must be cheating) and try to prevent this type of explosions by deleting the vehicle which is going to explode. This is one example of a situation that is analyzed and deliver full information about the explosion. Also, explosions which are not produced on the server and only on client will be punished. Config.countExplosionsPenalty represents the punishment for the player who executes the action. The punishment can be WARNING, KICK or BAN. It is recommended to keep it as it is in configuration file by default. In this case, it is recommended to keep it with ban because it can be harmful for your server to spawn a big amount of explosions in a short time on the server.Keep the same format if you want to add / remove a explosion in / from the table.
Config.WhitelistedParticles - is a table which contains all id particles that are allowed on the server. In case the particle is not added as whitelisted particle, the player who execute any particle which is not whitelisted will get banned on first particle usage. In case you use any particle on the server it will print the particle id on anticheat logs so you can whitelist it. Config.antiParticles will cancel the particle used at first usage if it is set to true. It is recommended to set it to true. Config.particlePenalty represents the punishment for the player who executes the action. The punishment can be WARNING, KICK or BAN. It is recommended to keep it as it is in configuration file by default. In this case, it is recommended to keep it with ban because it can be harmful for your server to spawn particles for every player on the server. In case you have scripts that uses particles you have to add them in Config.WhitelistedParticles.Keep the same format if you want to add a particle in the table.
Keep the same format if you want to add / remove a weapon in / from the table.
Keep the same format if you want to add a new vehicle model to be blacklisted.
Do not delete the entire table in case you want to allow spawning any vehicle that is blacklisted. You can set it on false or delete only the vehicle you want to use. Deleting the entire table will cause errors and issues to your server.
There are two penalties for blacklisted peds: Config.blacklistedModelsPenalty which is the penalty for using a ped model for your player and Config.blacklistedPedsPenalty which is the penalty for spawning a ped on the server.
Keep the same format if you want to add a new ped model to be whitelisted or blacklisted.
Do not delete the entire table in case you want to allow spawning any ped that is blacklisted. You can set it on false or delete only the ped you want to use. Deleting the entire table will cause errors and issues to your server.
Keep the same format if you want to add a new object / prop model to be whitelisted.
Do not delete the entire table in case you want to allow spawning any object / pro that is not whitelisted. You can add the object / prop that you want to use or set to false in case you do not want to use that object / prop. Deleting the entire table will cause errors and issues to your server.
It is not recommended at all to use warning penalty because it has no punishment for the player who is spamming entities and this can lead to server crash due to high consumption of your server and also player's client.
The Config.entitySpawnCheck feature can be influenced by server performance, latency because it depends on how quickly information is synchronized between client and server. In case there are problems on your server about performance or latency we recommend to try solve them because this feature also tries to avoid these issues as much as possible. In case this feature will affect your server (delete entities which are spawned correctly), if you have set this feature to true, please set it back to false.
The only penalty for spawning entities from unknown or injected (abnormal) scripts that are not supposed to create vehicles, peds or objects/props 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.advancedentitySpawnCheck to false
The Config.advancedentitySpawnCheck feature can be influenced by server performance, latency because it depends on how quickly information is synchronized between client and server. In case there are problems on your server about performance or latency we recommend to try solve them because this feature also tries to avoid these issues as much as possible. In case this feature will affect your server (delete entities which are spawned correctly), if you have set this feature to true, please set it back to false.
Even though there are still some methods where cheaters can create entities from their menus/executors, the anticheat resource blocks all possible suspicious entity creation activities at the moment. In case there will be a fix to prevent their actions, it will be announced on future updates. In order to prevent this issue, the only solution is to shift entity creation from client-side to server-side directly from your server or make sure that you have all entity creation functions on server-side and add to your server.cfg one of the lines below at your choice:
sv_entityLockdown relaxed #Blocks only client-created entities that are not owned by scripts.
sv_entityLockdown strict #Prevents clients from creating any entities.
It is recommended to make tests before launching this shift.
Keep the same format if you want to add / remove obiect / prop collision.
It is recommended for you to keep the gas pump's collision removed and Config.antiCollision set to true in order to avoid explosions on the server and maybe punished.
Keep the same format if you want to add / remove blacklisted words on chat.
Keep the same format if you want to add / remove blacklisted command on chat.
Keep the same format if you want to add / remove blacklisted plate on vehicle.
Config.triggerEventsPenalty set to warning will not perform any action as it could spam your server console and discord log in case there is a player spamming an existing event from the table. Prints on server console and discord log are available only for kick and ban punishment. In case there are bans for an existing event from the table, you can adjust your trigger limit, remove the event from the table or set Config.triggerEvents to false
Keep the same format if you want to add event names or comment (--) / delete them (the entire row) in case you want to remove it. You can also adjust the limit in case you have issues with players that are spamming and you allow this thing.
Keep the same format if you want to add client event names. If you have registered in your server one of the client events, remove them (delete them) and keep only blacklisted event names that you do not have in your resources and cannot be used at all.
Keep the same format if you want to add server event names. If you have registered in your server one of the server events, remove them (delete them) and keep only blacklisted event names that you do not have in your resources and cannot be used at all.
Keep the same format if you want to add / remove a server safezone in Config.serverSafezones
Resource stopped from executor (most common)
Host low performance: unstable network (freezings, drops, packet loss, DDOS attacks), lost internet, poor specifications
Server low performance: high server resource consumption
Player's low pc performance: poor specifications
Player's bad internet connection: unstable internet connection, low internet speed
In case your server uses similar menus to cheating menus (made with Rage UI) be sure that the words from the table will not exist in your server menus. Also, in case there are punishment with words that exist in the table, but the player does not use a cheating menu, remove the word from the table. This thing usually happens with short words, so you should avoid adding short words in the table. In case the player is banned for being detected with a blacklisted word on the screen but you do not see a cheating menu on his screen, you have to remove that word from the table.
Keep the same format if you want to add a new blacklisted outfit.
You must keep the keys exactly as they are: face, mask, hair, hands, pants, bag, shoes, accessory, undershirt, kevlar, badge, jacket. Changing any of keys will cause errors and issues to your server. In order to add a new blacklist outfit you have to keep the same format and change only the drawable id values (the number corresponding to each specific key)
Example:
If you donβt need to compare all components for a particular outfit, you can enter only the keys you want to check.
Example:
Do not delete the entire table in case you want to allow some outfit. The table is dedicated only to blacklisted outfits. In case you do not want to use this feature you can leave it to false as it was in the default configuration. Deleting the entire table will cause errors and issues to your server.
Last updated