Saltar al contenido principal

Configuración

FR Guard funciona perfecto sin tocar nada después de instalarlo. Pero si quieres ajustar algo, aquí están las opciones más útiles explicadas en lenguaje normal.

Todas se ponen en tu server.cfg con set <opción> "<valor>".

Opciones principales​

fiverank_token (obligatorio)​

Tu API Key. Sin esto FR Guard no funciona.

set fiverank_token "frk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

fiverank_language — Idioma​

Idioma de las tarjetas que ven los jugadores y de las notificaciones a tu staff.

set fiverank_language "es"

Valores válidos: es, en, pt, fr, de. (Por defecto es.)

fiverank_fail_open — Si FiveRank cae​

Qué hacer si la API de FiveRank no responde a tiempo.

set fiverank_fail_open "1"
  • "1" (recomendado) — Tu servidor sigue funcionando con normalidad y deja entrar a los jugadores. Pierdes la protección solo mientras dura el incidente.
  • "0" — Si la API cae, nadie entra. Solo úsalo si prefieres "mejor cerrar el servidor que dejar entrar a un cheater por error".

fiverank_debug — Logs detallados​

set fiverank_debug "0"
  • "0" (normal) — solo logs importantes.
  • "1" — logs detallados de cada chequeo. Úsalo solo si tienes un problema y quieres ver qué pasa.

fiverank_metrics — Contador de jugadores en vivo​

Envía cada 30 s a fiverank.gg el número de jugadores online de tu servidor. Con esto activado tu ficha pública muestra:

  • Contador en vivo en el listing (42 / 64) con punto verde animado.
  • Gráfica de las últimas 24 h con media, máximos y mínimos.
  • Picos del día, semana e histórico.
  • Uptime % estimado de tu servidor.
set fiverank_metrics "1"
  • "1" (recomendado) — activa el envío de métricas en vivo.
  • "0" — desactiva todo el módulo de métricas. Tu ficha mostrará solo los slots declarados por ti, sin contador en vivo ni gráfica.
Es puramente visual

El contador de jugadores no afecta a tu ranking. Solo se usa para mostrar actividad al público y ayudar a jugadores a elegir un servidor activo.

¿Qué datos se envían?

Solo número de jugadores conectados, máximo de slots y tamaño de la cola. Nunca se envian nombres, identificadores ni IPs.

fiverank_presence — Lista de jugadores conectados (Following Activity)​

Cuando está activo, FR Guard adjunta a cada heartbeat la lista de identificadores Discord/license/steam de los jugadores conectados ahora mismo. El backend de FiveRank cruza el Discord ID con User.discordId y, solo para los seguidores del jugador y respetando su configuración de privacidad, muestra:

  • "Tus seguidos jugando ahora" en su perfil.
  • Badge "X amigos jugando" en la navbar.
  • Widget "Tus seguidos aquí" en la ficha del servidor.
  • Widget "Tendencia entre tus seguidos" (top servidores con más amigos online).
set fiverank_presence "1"
  • "1" (por defecto, recomendado) — envía la lista de identificadores.
  • "0" — desactiva el envío. Tus jugadores no aparecerán en los widgets de "amigos jugando" de FiveRank.
Privacidad por defecto

Cada usuario controla quién puede ver dónde juega desde fiverank.gg/panel/ajustes: público, seguidores (default), mutuos o invisible. Además puede activar modo invisible temporal (1 h – 7 d). El servidor solo envía la lista cruda — el filtrado de visibilidad ocurre en el backend de FiveRank, no en tu servidor.

¿Qué datos se envían exactamente?

Solo discord:xxxxx, license:xxxxx y steam:xxxxx de cada player conectado. Nunca se envían nombres en pantalla, IPs, coordenadas, inventario ni nada relacionado con la sesión de juego. Ver Following Activity.

Cambiar el comportamiento (opcional)​

Si quieres ajustar cosas más finas, abre el archivo config.lua que está dentro de resources/fiverank_guard/.

¿Permitir jugadores sin Discord abierto?​

FR Guard identifica a los jugadores por su cuenta de Discord. Si alguien se conecta sin Discord abierto, no se le puede identificar.

Config.Behavior.failOpenNoDiscord = false  -- recomendado
  • false (recomendado) — Si no tienen Discord abierto, no entran. Es la única forma de evitar que un cheater simplemente cierre Discord para saltarse el sistema.
  • true — Se les deja pasar igualmente. No recomendado.

Refrescar bans cada X minutos​

Si baneas a alguien desde el panel web de FiveRank y ese jugador ya está conectado a tu servidor, FR Guard lo kickea automáticamente en el siguiente "barrido".

Config.Behavior.banSweepMinutes = 3
  • 3 (recomendado) — buen equilibrio.
  • 1 — más rápido pero más carga.
  • 0 — desactivado (los bans solo se aplican cuando reconectan).

Tiempo de caché​

FR Guard recuerda durante 5 minutos si un jugador puede entrar, para no preguntar mil veces al servidor.

Config.Behavior.cacheTtlMinutes = 5

Normalmente no tienes que tocarlo.

Exigir cuenta de FiveRank para entrar (Sprint 20.2)​

Si quieres que solo entren al servidor jugadores con cuenta vinculada en fiverank.gg, activa esta opción. El Discord del jugador debe estar vinculado a una cuenta FiveRank para poder pasar.

Config.Behavior.requireFiveRankAccount = false  -- por defecto
  • false (por defecto) — cualquier jugador con buena reputación entra, tenga cuenta FiveRank o no.
  • true — solo entran usuarios con cuenta FiveRank vinculada. Ideal si quieres control total de identidad y reputación. Los jugadores sin cuenta ven el motivo en su idioma y un enlace para registrarse.
Cache fail-open

Si un jugador entra usando cache (chequeo anterior reciente), no se le aplica este filtro — evita kickeos masivos al activar la opción por primera vez.

Tecla para abrir el panel staff (Sprint 20.3)​

Tecla por defecto que abre /fivepanel para el staff. El jugador puede reasignarla en FiveM → Ajustes → Controles del teclado → "FiveRank Guard".

Config.Behavior.panelKey = 'F6'

Acepta cualquier tecla válida de FiveM: F1..F12, INSERT, HOME, PAGEUP, letras, etc.

Acciones de movimiento del staff (Sprint 20.3)​

¿El staff puede usar Espectar, Goto, Bring, Revivir, Curar y Congelar desde las tarjetas del panel?

Config.Behavior.allowStaffMovementActions = true
  • true (por defecto) — el staff tiene los 7 botones de acción in-game.
  • false — solo siguen disponibles las acciones clásicas de moderación (Kick, Ban). Útil para servidores roleplay estrictos donde el staff no debe tener herramientas de god-mode in-game.

Imprime el logo ASCII coloreado FIVERANK en la consola cuando arranca el recurso.

Config.Behavior.bannerEnabled = true
  • true (por defecto) — muestra el banner con la paleta crimson + gold.
  • false — consola silenciosa. Útil si tu consola no soporta ANSI 256 (cmd.exe antiguo) y ves los escapes como basura.

Cambiar tu token​

Si crees que tu token se ha filtrado:

  1. Ve a Panel → Servidores → [Tu servidor] → FR Guard.
  2. Pulsa Revocar sobre la key actual.
  3. Genera una nueva.
  4. Cambia el valor de set fiverank_token en tu server.cfg.
  5. Reinicia el recurso: restart fiverank_guard.
Nunca compartas tu token
  • No subas tu server.cfg con el token a GitHub, Pastebin ni Discord público.
  • Cada token solo sirve para un servidor. No reutilices tokens entre servidores.