Installation Guide

Get Pilot AC running on your FiveM server in under 5 minutes

Requirements
Get Your License
Download the Resource
Install on Your Server
Verify It's Working
Configure Detections
Set Up Discord Webhooks
Add Staff Members
Whitelist Players
Uninstall
Troubleshooting

1. Requirements

Before installing Pilot AC, make sure your server has:

Requirement	Details
FiveM Server	Any FiveM server with OneSync enabled
oxmysql	MySQL resource for FiveM (GitHub)
MySQL Database	Any MySQL/MariaDB database (already required by most frameworks)
Framework	QBCore, ESX, or Standalone — Pilot AC auto-detects

Note: If you're running QBCore or ESX, you already have oxmysql and a database. No extra setup needed.

2. Get Your License

Go to the Pilot AC Panel

Visit the panel and log in with Discord:

https://pilotac.com/panel/

Purchase or Receive a License

Contact the Pilot AC team to get your license key. Once activated, you'll see it in the License section of the panel.

3. Download the Resource

Go to License page in the panel

You'll see your license with a green "Download Resource (pilot-ac.zip)" button.

Click Download

The .zip file comes with your license key already configured. No need to edit any files.

Pro tip: Your license key is pre-configured in config.lua inside the zip. You don't need to paste it manually.

4. Install on Your Server

Extract the zip

Extract pilot-ac.zip. You'll get a folder called pilot-ac.

Move to resources

Move the pilot-ac folder into your server's resources/ directory:

resources/
├── [core]/
├── [standalone]/
├── pilot-ac/          <-- here
│   ├── fxmanifest.lua
│   ├── config.lua
│   ├── shared/
│   ├── server/
│   └── client/
└── ...

Add to server.cfg

Add this line to your server.cfg. Make sure it loads after oxmysql:

ensure oxmysql
ensure pilot-ac

Start your server

Start (or restart) your FiveM server. Pilot AC will automatically:

Create all database tables
Detect your framework (QBCore/ESX/Standalone)
Validate your license
Start all detection modules

Important: Pilot AC must load AFTER oxmysql and your framework (qb-core or es_extended). The ensure order matters.

5. Verify It's Working

When Pilot AC starts correctly, you'll see this in your server console:

  ██████╗ ██╗██╗      ██████╗ ████████╗     █████╗  ██████╗
  ██╔══██╗██║██║     ██╔═══██╗╚══██╔══╝    ██╔══██╗██╔════╝
  ██████╔╝██║██║     ██║   ██║   ██║       ███████║██║
  ██╔═══╝ ██║██║     ██║   ██║   ██║       ██╔══██║██║
  ██║     ██║███████╗╚██████╔╝   ██║       ██║  ██║╚██████╗
  ╚═╝     ╚═╝╚══════╝ ╚═════╝    ╚═╝       ╚═╝  ╚═╝ ╚═════╝

[Pilot AC] v1.0.0 - Starting up...
[Pilot AC] Framework detected: QBCore
[Pilot AC] Database tables ready
[Pilot AC] License validated successfully
[Pilot AC] Pilot AC is now protecting this server!
[Pilot AC] Framework: qbcore | Detections: 15 active

If you see "Pilot AC is now protecting this server!", everything is working.

6. Configure Detections

You can configure Pilot AC in two ways:

Option A: From the Web Panel (Recommended)

Go to the Config page in the panel. Toggle detections on/off and adjust thresholds in real-time. Changes apply immediately — no server restart needed.

Option B: Edit config.lua

Open pilot-ac/config.lua and edit the values directly. Restart the resource after changes:

-- In your server console:
restart pilot-ac

Available Detections

Detection	What It Detects	Default
God Mode	Player health doesn't decrease after damage	ON
Teleport	Impossible movement distance	ON
Speed Hack	Vehicle or on-foot speed exceeding limits	ON
Noclip	Flying without vehicle, under map	ON
Weapon Spawn	Weapons not given by the server	ON
Vehicle Spawn	Vehicles not spawned legitimately	ON
Explosions	Explosion spam or blacklisted types	ON
Resource Injection	Lua executors and injected resources	ON
Ped Model	Unauthorized player model changes	ON
Freecam	Camera detached from player ped	ON
Invisibility	Player made themselves invisible	ON
Super Jump	Abnormal jump height	ON
Entity Spam	Mass object/ped/vehicle creation	ON
Mass Action	One player affecting all others	ON
Self Revive	Self-resurrection without game mechanics	ON

7. Set Up Discord Webhooks

To receive alerts in your Discord server:

Create webhooks in Discord

Go to your Discord server → Channel Settings → Integrations → Webhooks → New Webhook. Create separate webhooks for each category (recommended).

Paste URLs in config.lua

Config.Webhooks = {
    enabled = true,
    detections = 'https://discord.com/api/webhooks/YOUR_WEBHOOK_URL',
    bans = 'https://discord.com/api/webhooks/YOUR_WEBHOOK_URL',
    joins = 'https://discord.com/api/webhooks/YOUR_WEBHOOK_URL',
    admin = 'https://discord.com/api/webhooks/YOUR_WEBHOOK_URL',
    serverName = 'My Server',
}

8. Add Staff Members

Your staff can manage the anti-cheat from the panel without needing your account:

Go to Staff in the panel
Select your server
Click Add Staff
Enter the staff member's Discord ID
Choose their role: Staff (ban/unban, view) or Manager (full control)

Note: The staff member must log in to the panel with Discord first before you can add them.

9. Whitelist Players

Need a developer or tester to use tools without getting banned?

Go to Whitelist in the panel
Select your server
Click Add to Whitelist
Enter the player's identifier (e.g. license:abc123, steam:110000xxx, or discord:123456)

Whitelisted players are completely exempt from all detections and auto-bans.

10. Uninstall

Pilot AC is 100% self-contained. To uninstall:

Remove ensure pilot-ac from server.cfg
Delete the pilot-ac folder from resources/
(Optional) Run database_cleanup.sql to remove database tables

Clean uninstall: No files are modified outside the pilot-ac folder. Nothing is left behind.

11. Troubleshooting

"LICENSE INVALID OR EXPIRED"

Check that your license key in config.lua is correct
Make sure Config.ApiUrl is set to the correct panel URL
Verify your license is active in the panel
If your server IP changed, update it in the panel's License section

"oxmysql" errors

Make sure ensure oxmysql is before ensure pilot-ac in server.cfg
Verify your database connection string in server.cfg

False positives

Go to Config in the panel and increase thresholds
The scoring system requires multiple consecutive flags before action
Increase consecutiveFlags values for sensitive detections
Add teleport grace periods if your garage/hospital systems trigger teleport detection

Need help?

Join our Discord server for support.