Instalación

Instalar FR Guard tarda menos de 5 minutos. No necesitas tocar bases de datos, no hay dependencias y no hay que programar nada.

Antes de empezar

Comprueba que tienes:

✅ Servidor FiveM dado de alta y verificado en fiverank.gg. Si aún no lo has hecho → Panel → Servidores → Añadir servidor.
✅ Acceso a la carpeta resources/ y al server.cfg de tu FXServer.
✅ Salida HTTPS al exterior (puerto 443 saliente). Compruébalo con:
```
curl -I https://fiverank.gg
```
Debe responder HTTP/2 200. Si no, contacta con tu proveedor de hosting.

Paso 1 · Generar tu API Key

Entra en fiverank.gg e inicia sesión.
Ve a Panel → Mis servidores → [Tu servidor] → FR Guard.
Pulsa Generar nueva API Key.
Cópiala — empieza por frk_live_….

Solo se muestra una vez

Si la pierdes, no pasa nada: bórrala desde el panel y genera una nueva. El cambio tarda menos de 30 segundos.

Una key = un servidor

Cada key solo funciona para un servidor. Si tienes varios servidores, genera una key distinta para cada uno.

Paso 2 · Descargar el recurso

Ve a fiverank.gg/recursos o desde el panel → FR Guard → Descargar FR Guard (.zip).
Descomprime el ZIP dentro de la carpeta resources/ de tu servidor.

La estructura debe quedar así:

resources/
└── fiverank_guard/
    ├── fxmanifest.lua
    ├── config.lua
    ├── client/
    ├── server/
    ├── html/
    └── shared/

Nombre de carpeta

La carpeta debe llamarse fiverank_guard exactamente. Si la renombras, el recurso no arrancará.

Paso 3 · Configurar `server.cfg`

Abre tu server.cfg y añade esto al final del archivo:

# ─── FiveRank Guard ──────────────────────────────────────────────────
# OBLIGATORIO
set fiverank_token     "frk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Idioma de las tarjetas y mensajes: es | en | pt | fr | de
set fiverank_language  "es"

# Si la API no responde, ¿dejar pasar al jugador? (recomendado: 1)
set fiverank_fail_open "1"

# Contador de jugadores en vivo en fiverank.gg (recomendado: 1)
set fiverank_metrics   "1"

# Following Activity — "amigos jugando ahora" (recomendado: 1)
set fiverank_presence  "1"

ensure fiverank_guard

Sustituye frk_live_xxx… por tu token del paso 1.

Variables de `server.cfg`

Variable	Valores	Por defecto	Descripción
`fiverank_token`	`frk_live_…`	—	Obligatorio. Tu API Key.
`fiverank_language`	`es` `en` `pt` `fr` `de`	`es`	Idioma de tarjetas y mensajes.
`fiverank_fail_open`	`0` `1`	`1`	`1` = deja pasar si la API cae.
`fiverank_debug`	`0` `1`	`0`	`1` = logs detallados en consola. Solo para diagnóstico.
`fiverank_metrics`	`0` `1`	`0`	`1` = envía jugadores en vivo a la plataforma.
`fiverank_presence`	`0` `1`	`1`	`1` = activa Following Activity.
`fiverank_staff_discord_ids`	IDs separados por coma	—	Staff extra exento de detecciones (sin necesidad de ACE).

Paso 4 · Reiniciar el servidor

Reinicia tu FXServer completo (no solo el recurso — necesita recargar las variables set).

Al arrancar, verás en consola:

[FiveRank Guard] online · framework=esx · base=https://fiverank.gg
[FiveRank Guard] language=es · cache=5min · fail_open=true
[FiveRank Guard] detectors: eventSpam=shadow · entitySpawn=shadow · explosion=shadow · ...

✅ Si ves online, la instalación es correcta.

Paso 5 · Verificar que funciona

Conéctate al servidor desde tu propio FiveM:

Verás durante un instante la tarjeta "Comprobando tu reputación…" (con la marca FiveRank).
Si tienes reputación limpia → "¡Bienvenido!" y entras.

Si no ves la tarjeta o hay un error → ve a Problemas comunes.

Estructura del recurso

fiverank_guard/
├── fxmanifest.lua        ← manifiesto con versión y scripts
├── config.lua            ← TODA la configuración editable está aquí
├── shared/
│   ├── brand.lua         ← identidad visual FiveRank (solo lectura)
│   └── utils.lua         ← helpers compartidos
├── server/
│   ├── main.lua          ← core: pre-connect, bans, sweep
│   ├── detectors.lua     ← motor de detecciones
│   ├── combat.lua        ← Combat Anomaly Detector
│   ├── honeypot.lua      ← Honeypot Engine
│   ├── integrity.lua     ← verificación SHA-256
│   ├── federation.lua    ← red federada cross-server
│   └── commands.lua      ← comandos de consola y chat
├── client/
│   ├── main.lua          ← tarjetas de conexión NUI
│   ├── panel.lua         ← panel /fivepanel NUI
│   └── movement.lua      ← detector de movimiento
└── html/
    ├── index.html        ← UI del panel /fivepanel
    ├── app.js
    └── style.css

Solo edites config.lua. El resto se actualiza sustituyendo el ZIP.

Actualizar a una versión nueva

Descarga el ZIP nuevo desde el panel.
Haz una copia de tu config.lua si tienes personalización.
Elimina la carpeta fiverank_guard/ antigua de resources/.
Descomprime el ZIP nuevo.
Restaura tu config.lua personalizado (o aplica los cambios al nuevo).
Reinicia el servidor.

tip

El ZIP siempre incluye un config.lua con valores por defecto. Compara con el tuyo antes de sobreescribir.

¿Y ahora qué?

Ajusta detectores y comportamiento → Configuración
Aprende los comandos de staff → Comandos
Entiende el panel web → Panel web
Cambia textos o idioma → Idiomas

Cuéntaselo a tus jugadores

Pídeles que se registren gratis en fiverank.gg. Cuantos más jugadores estén en FiveRank, mejor funciona la red de protección para todos los servidores.

Antes de empezar​

Paso 1 · Generar tu API Key​

Paso 2 · Descargar el recurso​

Paso 3 · Configurar server.cfg​

Variables de server.cfg​

Paso 4 · Reiniciar el servidor​

Paso 5 · Verificar que funciona​

Estructura del recurso​

Actualizar a una versión nueva​

¿Y ahora qué?​