Saltar al contenido principal

Problemas comunes

Si algo no funciona, empieza por aquí. La mayoría de fallos se solucionan en 30 segundos.

El recurso no arranca​

Si ves esto en la consola:

Couldn't find resource fiverank_guard

Solución:

  1. Comprueba que la carpeta está en el sitio correcto: resources/fiverank_guard/fxmanifest.lua
  2. Comprueba que tu server.cfg tiene la línea ensure fiverank_guard.

"Token inválido"​

Si ves esto:

[FiveRank Guard] INVALID_TOKEN — el token no existe o ha sido revocado.

Soluciones:

  1. Comprueba que el token está bien escrito en server.cfg (sin espacios, con las comillas bien cerradas).
  2. Genera un token nuevo en Panel → FR Guard → Generar nueva API Key y sustitúyelo en server.cfg.
  3. Cada token solo sirve para un servidor. Si has copiado un token de otro servidor tuyo, no va a funcionar.

"Servidor no verificado"​

Si ves esto:

[FiveRank Guard] NOT_VERIFIED_OWNER — este servidor no está verificado.

Solución:

FR Guard solo funciona en servidores verificados. Ve a Panel → Servidores → [Tu servidor] → Verificar y completa el proceso.

Todos los jugadores son rechazados​

Si nadie puede entrar al servidor:

  1. Mira si te dice "Discord requerido". Probablemente tus jugadores no tienen Discord abierto. Anúnciales que deben abrir Discord antes de conectarse.
  2. Comprueba que tu VPS tiene salida a internet. Desde tu VPS prueba: 
    curl -I https://fiverank.gg
    Debería responder HTTP/2 200. Si no, es un problema de firewall de tu hosting.
  3. Asegúrate de tener set fiverank_fail_open "1" para que un problema temporal no bloquee a todo el mundo.

La tarjeta de conexión se queda colgada​

Si la tarjeta "Comprobando tu reputación…" no avanza nunca:

  • Tu servidor no puede contactar con fiverank.gg. Casi siempre es el firewall del hosting bloqueando salida HTTPS. Pide a tu proveedor que abra el puerto 443 saliente.
  • Si usas una red privada (Pterodactyl, Docker), comprueba que tienes salida a internet desde el contenedor.

Quiero ver más logs para entender qué pasa​

Activa los logs detallados temporalmente:

set fiverank_debug "1"

Reinicia el recurso. Ahora verás en consola cada chequeo:

[FiveRank Guard] [debug] connecting: Carlos (270...)
[FiveRank Guard] [debug] discord = 123456789012345678
[FiveRank Guard] [debug] cache miss → respuesta en 142ms → allowed

Cuando termines, desactívalo otra vez (set fiverank_debug "0") para no ensuciar los logs.

El detector god_mode me detecta a mí (que no soy cheater)​

Si en el panel ves una alerta como:

God mode — HP intacta (200) tras daño ≥ 78 en 3 muestras

Y tú sí tenías armadura puesta:

  • Versión 1.8.3 o anterior: era un falso positivo conocido. El detector solo miraba HP y no consideraba el chaleco — si el armor absorbía todo el daño, la HP no bajaba y saltaba la alerta.
  • Versión 1.8.4 en adelante: corregido. Ahora mide el "pool efectivo" (HP + Armor). Solo flagea si ambos permanecen intactos en 3 muestras consecutivas. Mensaje actualizado: HP+Armor intactos (200+0) tras daño ≥ 78.

Solución: actualiza al último zip desde el panel y restart fiverank_guard.

Modo shadow

De serie, los detectores arrancan en mode = 'shadow' (solo registran, no kickean). Aunque salte un falso positivo, no se aplica ninguna acción automática — solo queda como evento auditable en el panel.

Warning "versión X.Y.Z no reconocida en el manifest oficial"​

Si al arrancar ves:

[FiveRank Guard][integrity] [warn] ⚠ versión 1.8.3 no reconocida en el manifest oficial. Actualiza el recurso desde docs.fiverank.gg.

Significa que el zip que tienes instalado es una versión más nueva que el último manifest oficial publicado en el backend. Es solo informativo — el recurso funciona igual.

Soluciones:

  1. Lo más habitual: descarga el zip actualizado del panel de descargas. El backend ya tiene el manifest de esa versión publicado.
  2. Si tú eres el que mantiene un fork propio, ejecuta node scripts/guard-publish-manifest.js para publicar el manifest de tu versión actual.

Sigo sin que me funcione​

No te quedes atascado. Únete al Discord y te ayudamos en menos de 24 h:

Cuando pidas ayuda, adjunta:

  1. Captura de la consola con fiverank_debug activado.
  2. Tu server.cfg (oculta el token antes de enviarlo).
  3. Qué framework usas (ESX, QBCore, etc.).