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

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

2. Obtener tu Licencia

Entra al Panel de Pilot AC

Visita el panel e inicia sesion con Discord:

https://pilotac.com/panel/

Compra o Recibe una Licencia

Contacta al equipo de Pilot AC para obtener tu clave de licencia. Una vez activada, la veras en la seccion License del panel.

3. Descargar el Recurso

Ve a la pagina License en el panel

Veras tu licencia con un boton verde "Download Resource (pilot-ac.zip)".

Haz click en Download

El archivo .zip viene con tu clave de licencia ya configurada. No necesitas editar ningun archivo.

Tip: Tu clave de licencia ya viene puesta en config.lua dentro del zip. No tienes que pegarla manualmente.

4. Instalar en tu Servidor

Extrae el zip

Extrae pilot-ac.zip. Obtendras una carpeta llamada pilot-ac.

Mueve a resources

Mueve la carpeta pilot-ac al directorio resources/ de tu servidor:

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

Agrega a server.cfg

Agrega esta linea a tu server.cfg. Asegurate de que cargue despues de oxmysql:

ensure oxmysql
ensure pilot-ac

Inicia tu servidor

Inicia (o 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.

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

Puedes configurar Pilot AC de dos formas:

Opcion A: Desde el Panel Web (Recomendado)

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

Opcion B: Editar config.lua

Abre pilot-ac/config.lua y edita los valores directamente. Reinicia el recurso despues de los cambios:

-- En la consola de tu servidor:
restart pilot-ac

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 config.lua

Config.Webhooks = {
    enabled = true,
    detections = 'https://discord.com/api/webhooks/TU_WEBHOOK_URL',
    bans = 'https://discord.com/api/webhooks/TU_WEBHOOK_URL',
    joins = 'https://discord.com/api/webhooks/TU_WEBHOOK_URL',
    admin = 'https://discord.com/api/webhooks/TU_WEBHOOK_URL',
    serverName = 'Mi Servidor',
}

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

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.

10. Desinstalar

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

Quita ensure pilot-ac de server.cfg
Borra la carpeta pilot-ac 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 pilot-ac. No queda nada.

11. Solucion de Problemas

"LICENSE INVALID OR EXPIRED"

Verifica que tu clave de licencia en config.lua es correcta
Asegurate de que Config.ApiUrl apunta a la URL correcta del panel
Verifica que tu licencia esta activa en el 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 pilot-ac 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
Aumenta los valores de consecutiveFlags para detecciones sensibles
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.