Guia de Instalacion

Instala Pilot AC en tu servidor de FiveM en menos de 5 minutos

Contenido

Requisitos
Obtener tu Licencia
Descargar el Recurso
Instalar en tu Servidor
Verificar que Funciona
Configurar Detecciones
Configurar Webhooks de Discord
Agregar Staff
Whitelist de Jugadores
Desinstalar
Solucion de Problemas

1. Requisitos

Antes de instalar Pilot AC, asegurate de que tu servidor tiene:

Requisito	Detalles
Servidor FiveM	Cualquier servidor FiveM con OneSync activado
oxmysql	Recurso MySQL para FiveM (GitHub)
Base de Datos MySQL	Cualquier MySQL/MariaDB (ya lo tienes si usas QBCore o ESX)
Framework	QBCore, ESX, o Standalone — Pilot AC lo detecta automaticamente
screenshot-basic	(Opcional) Para tomar capturas de pantalla del jugador al detectar (GitHub)

Nota: Si usas QBCore o ESX, ya tienes oxmysql y base de datos. No necesitas configurar nada extra.

2. Obtener tu Licencia

Compra en la Tienda Tebex

Visita la tienda oficial para comprar tu licencia:

https://pilotac.tebex.io

Mira tu Licencia en el Panel

Despues de la compra, inicia sesion con Discord en pilotac.com/panel. Veras tu clave de licencia en la seccion License.

3. Descargar el Recurso

Ve a Keymaster

Visita el portal Keymaster de Cfx.re para descargar el recurso:

https://portal.cfx.re

Descarga desde Granted Assets

Navega a Granted Assets → busca PilotAC → haz click en Download. Obtendras un archivo .zip con el recurso.

Nota: El recurso se descarga desde Keymaster (portal.cfx.re), no desde el panel de Pilot AC. El panel se usa solo para configuracion y gestion.

4. Instalar en tu Servidor

Crea la carpeta del recurso

Crea una carpeta llamada pilotac dentro del directorio resources/ de tu servidor.

Extrae el contenido del zip

Extrae el contenido del zip descargado en la carpeta pilotac:

resources/
├── [core]/
├── [standalone]/
├── pilotac/           <-- aqui
│   ├── fxmanifest.lua
│   ├── config.lua     (encriptado — no editar)
│   ├── shared/
│   ├── server/
│   └── client/
└── ...

Configura tu clave de licencia en server.cfg

Agrega estas lineas a tu server.cfg. Configura tu clave de licencia via convar y asegurate de que pilotac cargue despues de oxmysql y tu framework:

set pilotac_license "TU-CLAVE-DE-LICENCIA-AQUI"

ensure oxmysql
ensure es_extended  # o qb-core
ensure pilotac

Reinicia tu servidor

Reinicia tu servidor FiveM. Pilot AC automaticamente:

Crea todas las tablas en la base de datos
Detecta tu framework (QBCore/ESX/Standalone)
Valida tu licencia
Inicia todos los modulos de deteccion

Importante: Pilot AC debe cargar DESPUES de oxmysql y tu framework (qb-core o es_extended). El orden de ensure importa.

No edites config.lua: El recurso esta encriptado. Toda la configuracion se hace desde el panel web o mediante el convar pilotac_license en server.cfg.

5. Verificar que Funciona

Cuando Pilot AC inicia correctamente, veras esto en la consola de tu servidor:

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

[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

Si ves "Pilot AC is now protecting this server!", todo esta funcionando.

6. Configurar Detecciones

Toda la configuracion se hace desde el panel web — el config.lua del recurso esta encriptado y no se puede editar.

Desde el Panel Web

Ve a la pagina Config en pilotac.com/panel. Activa/desactiva detecciones y ajusta umbrales en tiempo real. Los cambios se aplican inmediatamente — no necesitas reiniciar el servidor.

Whitelist de Recursos

Si una deteccion causa falsos positivos con un recurso especifico, puedes poner ese recurso en whitelist desde el panel. Esto evita que active detecciones mientras el resto del anti-cheat sigue activo.

Detecciones Disponibles

Deteccion	Que Detecta	Default
God Mode	La salud del jugador no baja al recibir dano	ON
Teleport	Movimiento de distancia imposible	ON
Speed Hack	Velocidad excesiva en vehiculo o a pie	ON
Noclip	Volar sin vehiculo, debajo del mapa	ON
Weapon Spawn	Armas no dadas por el servidor	ON
Vehicle Spawn	Vehiculos no spawneados legitimamente	ON
Explosiones	Spam de explosiones o tipos bloqueados	ON
Resource Injection	Ejecutores Lua y recursos inyectados	ON
Ped Model	Cambios de modelo de jugador no autorizados	ON
Freecam	Camara separada del jugador	ON
Invisibilidad	Jugador se hizo invisible	ON
Super Jump	Altura de salto anormal	ON
Entity Spam	Creacion masiva de objetos/peds/vehiculos	ON
Mass Action	Un jugador afectando a todos los demas	ON
Self Revive	Auto-revivirse sin mecanica del juego	ON

7. Configurar Webhooks de Discord

Para recibir alertas en tu servidor de Discord:

Crea webhooks en Discord

Ve a tu servidor de Discord → Configuracion del Canal → Integraciones → Webhooks → Nuevo Webhook. Crea webhooks separados para cada categoria (recomendado).

Pega las URLs en el Panel Web

Ve a Config en pilotac.com/panel y pega tus URLs de webhook en los campos correspondientes (detecciones, bans, joins, admin).

8. Agregar Staff

Tu staff puede manejar el anti-cheat desde el panel sin necesitar tu cuenta:

Ve a Staff en el panel
Selecciona tu servidor
Click Add Staff
Ingresa el Discord ID del miembro del staff
Elige su rol: Staff (ban/unban, ver datos) o Manager (control total)

Nota: El miembro del staff debe iniciar sesion en el panel con Discord primero antes de que puedas agregarlo.

9. Whitelist de Jugadores y Recursos

Necesitas que un desarrollador o tester use herramientas sin ser baneado?

Ve a Whitelist en el panel
Selecciona tu servidor
Click Add to Whitelist
Ingresa el identificador del jugador (ej: license:abc123, steam:110000xxx, o discord:123456)

Los jugadores en whitelist estan completamente exentos de todas las detecciones y auto-bans.

Whitelist de Recursos

Si una deteccion causa falsos positivos con un recurso especifico de tu servidor, puedes poner ese recurso en whitelist desde el panel. Esto evita que active detecciones mientras el resto del anti-cheat sigue completamente activo.

10. Desinstalar

Pilot AC esta 100% contenido en una sola carpeta. Para desinstalar:

Quita ensure pilotac de server.cfg
Borra la carpeta pilotac de resources/
(Opcional) Ejecuta database_cleanup.sql para borrar las tablas de la base de datos

Desinstalacion limpia: No se modifica ningun archivo fuera de la carpeta pilotac. No queda nada.

11. Solucion de Problemas

"LICENSE INVALID OR EXPIRED"

Verifica que tu clave de licencia en server.cfg es correcta: set pilotac_license "TU-CLAVE"
Verifica que tu licencia esta activa en el panel en pilotac.com/panel
Si cambio la IP de tu servidor, actualizala en la seccion License del panel

Errores de "oxmysql"

Asegurate de que ensure oxmysql esta antes de ensure pilotac en server.cfg
Verifica tu connection string de la base de datos en server.cfg

Falsos positivos

Ve a Config en el panel y sube los umbrales
El sistema de scoring requiere multiples flags consecutivos antes de actuar
Pon en whitelist recursos especificos desde el panel si causan falsos positivos
Agrega periodos de gracia para teleport si tus sistemas de garajes/hospitales activan la deteccion

Necesitas ayuda?

Unete a nuestro servidor de Discord para soporte.