Saltar al contenido principal

Comandos

FR Guard tiene 3 comandos. Puedes usarlos desde la consola del servidor o desde el chat del juego (si eres staff).

¿Quién puede usarlos?​

Por defecto:

  • ESX — usuarios con grupo admin, superadmin o mod.
  • QBCore — usuarios con grupo admin o god.
  • Standalone — usuarios con el permiso ACE fiverank.admin.

La consola del servidor siempre puede.

fiverank_status​

Muestra el estado actual: idioma, framework detectado, cuántos jugadores hay en caché, etc.

> fiverank_status
[FiveRank Guard] ─── STATUS ─────────────────────
  framework      : esx
  language       : es
  cache entries  : 47
  checks (1h)    : 142
  rejections (1h): 2
─────────────────────────────────────────────────

Úsalo para comprobar rápido que todo está bien.

fiverank_clear_cache​

Vacía la caché. La próxima vez que cualquier jugador se conecte, FR Guard le hará un chequeo nuevo en lugar de usar el resultado anterior.

> fiverank_clear_cache
[FiveRank Guard] cache vaciada

Cuándo usarlo: si acabas de banear o desbanear a alguien y quieres que el cambio se note al instante.

fiverank_recheck <id>​

Re-chequea a un jugador concreto ignorando la caché. Si resulta que ya no debería estar dentro (porque le has baneado hace un momento), FR Guard lo kickea automáticamente.

> fiverank_recheck 12
[FiveRank Guard] re-check 12 (Carlos) → BANNED → kick

Donde 12 es el server ID del jugador (el número que ves en la lista de jugadores).

fiverank_metrics_status​

Muestra el estado del módulo de métricas en vivo (heartbeats a fiverank.gg).

> fiverank_metrics_status
[FiveRank Guard] metrics enabled=true · nonce=4287 · failures=0 · players=42/64

Campos:

  • enabled — true si el módulo está activo (convar fiverank_metrics="1" y token válido).
  • nonce — contador incremental de heartbeats enviados (sobrevive a restarts).
  • failures — fallos consecutivos. Si es > 0, el sistema está reintentando con backoff exponencial (hasta 5 min entre intentos).
  • players — jugadores actuales / slots máximos.

Dar permiso a alguien que no es admin del framework​

Si quieres dar acceso a estos comandos a alguien sin que sea admin del framework, añade esta línea a tu server.cfg:

add_ace identifier.discord:123456789012345678 fiverank.admin allow

Cambia 123456789012345678 por su Discord ID.

Panel staff in-game (/fivepanel) (Sprint 20.2-20.3)​

FR Guard incluye un panel NUI completo que el staff puede abrir dentro del juego, con fondo transparente (se ve el juego detrás).

Abrir el panel​

  • Comando: /fivepanel en el chat.
  • Tecla rápida: F6 por defecto (reasignable en FiveM → Ajustes → Controles del teclado → "FiveRank Guard").
  • Cambiar la tecla por defecto: edita Config.Behavior.panelKey = 'F7' en config.lua.

Qué ves​

El panel muestra cada jugador conectado como una tarjeta con:

  • Avatar con iniciales y nombre.
  • Badge #source y ping con color semáforo.
  • Badge Discord (presente o ausente).
  • Badge FiveRank (gold si tiene cuenta vinculada, gris discontinuo si no).
  • Pill de riesgo (verde / amarillo / naranja / rojo animado para crítico).
  • Score numérico de riesgo y línea con el Discord ID completo.

Acciones disponibles por jugador​

Moderación clásica (siempre activas):

  • Kick — expulsa con motivo personalizado.
  • Ban — ban temporal o permanente sincronizado con el panel web.

Acciones in-game (Sprint 20.3, controladas por Config.Behavior.allowStaffMovementActions):

IconoAcciónQué hace
👁Espectar / SalirActiva modo espectador (toggle, marca rojo cuando activo). Auto-stop si el target se desconecta.
⬆Ir aTeletransporta al staff a las coordenadas del jugador.
⬇Traer aquíTeletransporta al jugador a las coordenadas del staff.
➕RevivirLo levanta del suelo (NetworkResurrectLocalPlayer).
❤CurarRestaura HP máxima + 100 de armor.
❄Congelar / DescongelarBloquea el movimiento del jugador (2 botones).

Salvaguardas automáticas​

  • Doble validación isStaff() en cliente y servidor.
  • Rate-limit de 1.5 s por administrador (anti-spam).
  • Cada acción queda en consola + se hace broadcast al resto del staff in-game con el formato [FivePanel] Admin → Target (accion).
  • Notificación al jugador objetivo en chat: [FiveRank Staff] Has sido curado/movido/revivido/congelado por un administrador.
  • No se permite auto-target en bring/goto/spectate.

Si no quieres las acciones in-game​

Deja solo Kick/Ban para un servidor RP estricto:

Config.Behavior.allowStaffMovementActions = false