← Back to Home

Installation Guide

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

Table of Contents

  1. Requirements
  2. Get Your License
  3. Download the Resource
  4. Install on Your Server
  5. Verify It's Working
  6. Configure Detections
  7. Set Up Discord Webhooks
  8. Add Staff Members
  9. Whitelist Players
  10. Uninstall
  11. Troubleshooting

1. Requirements

Before installing Pilot AC, make sure your server has:

RequirementDetails
FiveM ServerAny FiveM server with OneSync enabled
oxmysqlMySQL resource for FiveM (GitHub)
MySQL DatabaseAny MySQL/MariaDB database (already required by most frameworks)
FrameworkQBCore, ESX, or Standalone — Pilot AC auto-detects
screenshot-basic(Optional) For taking player screenshots on detection (GitHub)
Note: If you're running QBCore or ESX, you already have oxmysql and a database. No extra setup needed.

2. Get Your License

1

Purchase from the Tebex Store

Visit the official store to purchase your license:

https://pilotac.tebex.io
2

View Your License in the Panel

After purchase, log in with Discord at pilotac.com/panel. You'll see your license key in the License section.

3. Download the Resource

1

Go to Keymaster

Visit the Cfx.re Keymaster portal to download the resource:

https://portal.cfx.re
2

Download from Granted Assets

Navigate to Granted Assets → find PilotAC → click Download. You will get a .zip file with the resource.

Note: The resource is downloaded from Keymaster (portal.cfx.re), not from the Pilot AC panel. The panel is used for configuration and management only.

4. Install on Your Server

1

Create the resource folder

Create a folder called pilotac inside your server's resources/ directory.

2

Extract the zip contents

Extract the contents of the downloaded zip into the pilotac folder:

resources/
├── [core]/
├── [standalone]/
├── pilotac/           <-- here
│   ├── fxmanifest.lua
│   ├── config.lua     (encrypted — do not edit)
│   ├── shared/
│   ├── server/
│   └── client/
└── ...
3

Configure your license key in server.cfg

Add these lines to your server.cfg. Set your license key via the convar and make sure pilotac loads after oxmysql and your framework:

set pilotac_license "YOUR-LICENSE-KEY-HERE"

ensure oxmysql
ensure es_extended  # or qb-core
ensure pilotac
4

Restart your server

Restart your FiveM server. Pilot AC will automatically:

Important: Pilot AC must load AFTER oxmysql and your framework (qb-core or es_extended). The ensure order matters.
Do not edit config.lua: The resource is encrypted. All configuration is done from the web panel or via the pilotac_license convar in server.cfg.

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

All configuration is done from the web panel — the resource's config.lua is encrypted and cannot be edited.

From the Web Panel

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

Resource Whitelist

If a detection causes false positives with a specific resource, you can whitelist that resource from the panel. This prevents it from triggering detections while keeping the rest of the anti-cheat active.

Available Detections

DetectionWhat It DetectsDefault
God ModePlayer health doesn't decrease after damageON
TeleportImpossible movement distanceON
Speed HackVehicle or on-foot speed exceeding limitsON
NoclipFlying without vehicle, under mapON
Weapon SpawnWeapons not given by the serverON
Vehicle SpawnVehicles not spawned legitimatelyON
ExplosionsExplosion spam or blacklisted typesON
Resource InjectionLua executors and injected resourcesON
Ped ModelUnauthorized player model changesON
FreecamCamera detached from player pedON
InvisibilityPlayer made themselves invisibleON
Super JumpAbnormal jump heightON
Entity SpamMass object/ped/vehicle creationON
Mass ActionOne player affecting all othersON
Self ReviveSelf-resurrection without game mechanicsON

7. Set Up Discord Webhooks

To receive alerts in your Discord server:

1

Create webhooks in Discord

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

2

Paste URLs in the Web Panel

Go to Config at pilotac.com/panel and paste your webhook URLs in the corresponding fields (detections, bans, joins, admin).

8. Add Staff Members

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

  1. Go to Staff in the panel
  2. Select your server
  3. Click Add Staff
  4. Enter the staff member's Discord ID
  5. 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 & Resources

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

  1. Go to Whitelist in the panel
  2. Select your server
  3. Click Add to Whitelist
  4. 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.

Whitelist Resources

If a detection causes false positives with a specific server resource, you can whitelist that resource from the panel. This prevents it from triggering detections while keeping the rest of the anti-cheat fully active.

10. Uninstall

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

  1. Remove ensure pilotac from server.cfg
  2. Delete the pilotac folder from resources/
  3. (Optional) Run database_cleanup.sql to remove database tables
Clean uninstall: No files are modified outside the pilotac folder. Nothing is left behind.

11. Troubleshooting

"LICENSE INVALID OR EXPIRED"

"oxmysql" errors

False positives

Need help?

Join our Discord server for support.

© 2026 Pilot AC. All rights reserved.