Saltar al contenido principal

Problemas comunes

Si algo no funciona, empieza por aquí. La mayoría de problemas se resuelven en menos de 2 minutos.

El recurso no arranca​

Si en consola ves:

Couldn't find resource fiverank_guard

Solución:

  1. Verifica que la carpeta está en el lugar correcto: resources/fiverank_guard/fxmanifest.lua.
  2. Comprueba que server.cfg tiene la línea ensure fiverank_guard.
  3. El nombre de la carpeta debe ser exactamente fiverank_guard (sin espacios, sin mayúsculas).

"Token inválido"​

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

Solución:

  1. Verifica que el token está bien copiado en server.cfg — sin espacios extra, con las comillas bien cerradas.
  2. Genera un token nuevo en Panel → FR Guard → Generar nueva API Key y sustitúyelo.
  3. Cada token solo funciona para un servidor. No reutilices tokens entre servidores.

"Servidor no verificado"​

[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 de verificación.

Todos los jugadores son rechazados​

Si nadie puede entrar al servidor:

  1. Discord requerido: comprueba si el mensaje dice "Discord requerido". Los jugadores deben tener Discord abierto antes de conectarse. Anúnciales el requisito.
  2. Sin salida a internet: comprueba conectividad desde tu VPS: 
    curl -I https://fiverank.gg
    Debe responder HTTP/2 200. Si no, el firewall de tu hosting bloquea HTTPS saliente — contacta con el soporte del hosting.
  3. Fail-open desactivado: asegúrate de tener set fiverank_fail_open "1" para que una incidencia temporal no bloquee a todos.

La tarjeta de conexión se queda colgada​

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 (puerto 443). Pide al soporte de tu proveedor que lo abra.
  • Si usas contenedores (Pterodactyl, Docker), verifica que el contenedor tiene acceso a internet.

Quiero ver más logs​

Activa los logs detallados temporalmente:

set fiverank_debug "1"

Reinicia el recurso. 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 de diagnosticar, desactívalo:

set fiverank_debug "0"

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

Si en el panel ves:

God mode — HP+Armor intactos (200+0) tras daño ≥ 78 en 3 muestras

Y tú tenías armadura puesta:

  • Versión 1.8.3 o anterior: falso positivo conocido. El detector solo miraba HP, no el chaleco. Si el armor absorbía todo el daño, la HP no bajaba.
  • Versión 1.8.4 en adelante: corregido. Ahora mide el pool combinado HP + Armor. Solo flagea si ambos permanecen intactos en 3 muestras consecutivas.

Solución: actualiza al último ZIP desde el panel.

Modo shadow

Por defecto todos los detectores arrancan en mode = 'shadow' (solo registran). Aunque salte un falso positivo, no se aplica ninguna acción automática.

El detector movement flagea a un jugador que usó una misión/warp​

Si tu script teleporta jugadores legítimamente (revivir, cambiar de sala, inicio de misión), el detector de movimiento puede generar un flag de teleport.

Solución: llama al export antes del warp para aplicar una ventana de gracia:

exports.fiverank_guard:setMovementGrace(source, 5000)  -- 5 segundos de gracia

El export está disponible en todos los recursos del servidor. Añade la llamada justo antes de la teletransportación.

Mi staff genera muchos flags de detección​

El staff suele usar noclip, god mode y spawnear vehículos — acciones que los detectores identifican como sospechosas.

Solución: asegúrate de que Config.Detections.exemptStaff = true (activo por defecto). Si tus admins no tienen los grupos del framework correctamente configurados, añade sus Discord IDs manualmente:

Config.Detections.staffDiscordIds = {
  '123456789012345678',  -- Discord ID del admin
}

O en caliente desde consola:

fiverank_add_staff 123456789012345678

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

[FiveRank Guard][integrity] [warn] ⚠ versión 1.8.3 no reconocida en el manifest oficial.

Significa que el ZIP que tienes instalado es más nuevo que el último manifest publicado en el backend. El recurso funciona igual — es solo informativo.

Solución: descarga el ZIP actualizado desde el panel de descargas. El backend ya tiene el manifest de esa versión.

El panel /fivepanel no se abre​

Si pulsas F6 y no pasa nada:

  1. Verifica que eres staff (grupo admin del framework o ACE fiverank.admin).
  2. Comprueba que la tecla no esté asignada a otra función en tus ajustes de FiveM.
  3. Prueba con el comando /fivepanel en el chat para descartar un conflicto de tecla.
  4. Si la tecla está en conflicto, cambia Config.Behavior.panelKey en config.lua y reinicia.

El ban creado desde el panel web no kickea al jugador conectado​

Si baneas a alguien desde el panel web y ese jugador ya está dentro, el kick no es instantáneo — ocurre en el próximo ciclo del ban sweep.

Solución: reduce Config.Behavior.banSweepMinutes (recomendado: 2-3) o usa fiverank_recheck <id> desde la consola para forzar un re-chequeo inmediato:

fiverank_recheck 12

Sigo sin que me funcione​

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