Installation

VersusAC installation documentation

If you need support while installing the anticheat, please create a ticket in the discord!

After buying

1. Join the Versus Anticheat Discord. Click here

2. Create a ticket and verify your payment.

3. Double check that you bought it on the right FiveM account. The same account as the account you have your license key with (Keymaster).

4. To download the anticheat please go to keymaster: https://keymaster.fivem.net/asset-grants

5. Unzip the file you have downloaded and follow the steps below.

Standalone installation

1. Unzip the file and put the folder VersusAC in your resources.

2. Rename this resource to anything you like. Make sure that the name is something weird and not associated with the anticheat name. But for the easy use we will the name in this documentation VersusAC.

3. Now load the sql.sql file in your database. We use HeidiSQL for this. Make sure you run mysql-async or oxmysql

4. Go into the configs folder in the resource and configure everything you like. Warning: you need to configure your server name and the webhooks before starting the anticheat. Otherwise it will not start.

5. If you want to enable screenshots please download screenshot-basic here

6. Now you can go into your server.cfg and add these 2 lines directly under your core (qb-core or es_extended or any other framework core):

server.cfg

start screenshot-basic
start VersusAC

7. After you have done these steps you can whitelist your admins and moderators. This can be done in the whitelist.lua as shown below:

server.cfg

VersusACWhitelist.Whitelist = {

    ["license:271cc422c882ks92ls72hdb4ja498e719be81c09"] = {
        name = "Avey",
        permission = "admin"
    },

    ["license:271cc422c882ks92lsi8l0sdea498e719be81c09"] = {
        name = "Versus",
        permission = "admin"
    },

    ["license:2olw03dk23d03s92ls72hdb4ja498e719be81c09"] = {
        name = "Versus Mod",
        permission = "moderator"
    },

}

Underneath where you whitelist your mods or admins, you can set the permissions for each group. ( VersusACWhitelist.Permissions ). You can individually set all the permissions for the anticheat and the admin menu! PLEASE ONLY USE THE ROCKSTAR LICENSE TO WHITELIST YOUR STAFF MEMBERS AS SHOWN IN THE EXAMPLE!

If you don't want to use the permissions file. You can use our old ACE permissions system. We have vacadmin and vacbypass permissions. They technically are the same.

8. If everything works and if you restarted your server, you will see a big printed message in your console:

If you get an error like this one: You lack the required entitlement to use VersusAC

then you will need to check if you use the correct fivem license key. This should be from same account you got VersusAC on.

Please configure both server_config and client_config to prevent false bans and issues

ESX installation

Make sure to follow the standalone installation steps and these extra steps below:

1. Go into both server_config and client_config and set VersusAC.UseESX to true

2. Go into menu_config and set VersusPanel.ESX to true

QBCore installation

Make sure to follow the standalone installation steps and these extra steps below:

1. Go into server_config and set VersusAC.UseQBCore to true

2. Go into menu_config and set VersusPanel.QBCore to true

3. Now go into fxmanifest.lua and replace the code with the code below:

fxmanifest.lua

fx_version 'adamant'

author 'Avey | VersusAC'
description 'VAC | https://discord.gg/qMm4Jh9Afv'
version '2.0'
lua54 'yes'

game 'gta5'

client_scripts {
    'configs/client_config.lua',
    'configs/menu_config.lua',
    'locales/locales.lua',
    'client/checks.lua',
    'client/main.lua',
    'client/menu.lua',
    'client/import.lua'
}

server_scripts {
    '@oxmysql/lib/MySQL.lua',
    'configs/server_config.lua',
    'configs/menu_config.lua',
    'server/main.lua',
    'server/menu.lua',
    'locales/locales.lua',
    'configs/whitelist.lua',
    'main/install.lua'
}

ui_page 'html/index.html'

file {
    'html/*.html',
    'html/*.js',
    'html/*.css',
}

escrow_ignore {
    'configs/client_config.lua',
    'locales/locales.lua',
    'configs/server_config.lua',
    'configs/menu_config.lua',
    'html/*.html',
    'html/*.js',
    'html/*.css',
  }

For oxmysql support use @oxmysql/lib/MySQL.lua instead of @mysql-async/lib/MySQL.lua ( You need to run on the latest oxmysql release for it to work correctly )