Panel web FR Guard
El panel web es la consola de administración completa de FR Guard, accesible desde cualquier navegador en fiverank.gg. Todo lo que ves aquí es exclusivo de tu servidor — ningún otro owner ve tus datos.
¿Cómo llego? Inicia sesión → Panel → Mis servidores → (tu servidor) → FR Guard.
Cabecera y alertas críticas
En la parte superior siempre verás:
- Estado del recurso —
integridad OK/pendiente/alterado, con la versión del ZIP que tienes instalado en tu FXServer. - Banner de alertas críticas (rojo) — aparece si en las últimas 24 h algún jugador alcanzó
risk = critical(HWID baneado, anomalía de combate imposible, Honeypot disparado…). Click → modal con la lista completa + botón "Descartar" por alerta. Las alertas se crean automáticamente, sin intervención humana.
Pestañas del panel
🔑 Keys — API Keys
Gestión de los tokens de tu servidor.
- Generar nueva API Key — crea una key
frk_live_…. Se muestra solo una vez; cópiala antes de cerrar. - Revocar — invalida la key actual. Útil si se ha filtrado o compartido por error.
- Última conexión — fecha y hora del último chequeo desde tu FXServer. Detecta tokens inactivos o problemas de conectividad.
Si tienes varios servidores, genera una key distinta para cada uno. Un token filtrado no compromete los demás.
🚫 Bans
Listado completo de todos los bans aplicados en tu servidor, ya sean creados desde el panel web o desde el panel in-game /fivepanel.
Dos sub-pestañas:
Discord — Bans por Discord ID. El jugador recibe un mensaje de kick con la razón y el enlace de apelación.
HWID — Bans a nivel de hardware (hash del PC del jugador). Sobreviven a la creación de una cuenta nueva de Discord. Cuando un jugador con HWID baneado se conecta:
- El factor
hwid_banned(peso 75) eleva su risk score acritical. - Se dispara un push de notificación al staff.
- No kickea automáticamente — tú decides la acción desde el panel.
Acciones por ban: ver detalles completos · Revocar · Exportar.
✅ Allowlist — Excepciones locales
Añade usuarios de FiveRank que puedan entrar a tu servidor aunque su fama global esté en negativo.
- La excepción es local a tu servidor — no cambia la fama del usuario en la red ni afecta a otros servidores.
- NO salta bans activos del propio servidor. Para readmitir a alguien baneado, revoca primero el ban en la pestaña anterior.
- Útil para amigos del staff, testers, creadores de contenido o jugadores con apelación aceptada.
🛂 Whitelist — Control de acceso (v1.9+)
Si tu servidor tiene Config.Behavior.requireWhitelist = true, esta pestaña es donde gestionas quién puede entrar.
Flujo completo:
- El jugador solicita acceso — desde la ficha pública de tu servidor en fiverank.gg rellena el formulario de whitelist que hayas diseñado con el Builder.
- Tu staff revisa — en esta pestaña aparecen las solicitudes con estado
pending. El staff puede aprobar, rechazar o pedir más información. - FR Guard aplica — cuando el jugador se conecte, el recurso consultará a la API y solo le dejará entrar si
whitelist.approved == true.
Sub-secciones:
| Sección | Qué contiene |
|---|---|
| Solicitudes | Lista de todas las solicitudes (filtrable por estado: pending, approved, rejected). Acciones: aprobar, rechazar con motivo, conceder segunda oportunidad. |
| Usuarios permitidos | Pre-aprobados manualmente (sin formulario). Ideal para amigos del staff, streamers invitados, etc. |
| Vetos | Jugadores vetados permanentemente. Un jugador vetado nunca entra aunque tenga solicitud aprobada. |
| Builder | Editor visual del formulario de whitelist: preguntas, opciones, requisitos personalizados por servidor. |
Relación con Allowlist:
- Allowlist = excepciones a la fama negativa (deja pasar a jugadores con mala reputación que tú confías).
- Whitelist = puerta de acceso general (solo entran los aprobados, independientemente de su fama).
Son complementarias: un jugador puede estar en la whitelist (acceso) y también necesitar la allowlist si además tiene fama negativa.
- Servidor público con pocos controles → Solo fama (default, sin whitelist ni allowlist).
- Servidor público tolerante → Fama + Allowlist (dejas pasar a algunos con mala fama).
- Servidor privado / RP serio → Whitelist obligatoria (
requireWhitelist = true). - Servidor ultra-seguro → Whitelist + Fama + Allowlist (todos los filtros activos).
🚨 Detecciones
KPIs + tabla con todas las anomalías detectadas automáticamente por FR Guard.
KPI cards: total de detecciones · últimas 24 h · sin revisar · últimos 7 días.
Filtros: categoría (god_mode, event_spam, weapon_mod, vpn, movement, explosion, entity_spawn, honeypot…) · severidad (info / suspicious / critical) · Discord ID · "solo sin revisar".
Tabla de detecciones:
- Fila expandible con el JSON de evidencia completo, IP y todos los metadatos del evento.
- Autorefresh cada 30 s.
- Marcar como revisada con nota opcional para tu staff.
Sub-pestañas:
Feed (por defecto) — La tabla de detecciones descrita arriba.
Webhooks — Configura URLs de Discord para que tu staff reciba un embed con cada detección crítica en tiempo real. La URL queda enmascarada en la UI tras guardarla; nadie puede leerla aunque acceda al panel.
Honeypot — Disparos del Honeypot Engine. Cada fila es prueba absoluta de uso de menú externo: el cliente invocó un evento, native o variable que no existe en el código real del recurso. Cero falsos positivos por diseño de arquitectura. Ver Detectores para el detalle técnico.
🛡 Integridad
Verificación SHA-256 de los archivos .lua de tu instalación de FR Guard.
| Campo | Descripción |
|---|---|
| Versión instalada | Versión del ZIP que tienes en resources/. |
| Versión publicada | Última versión oficial del manifest de FiveRank. |
| Última verificación | Timestamp + motivo (startup / sweep periódico). |
| Status | ok · tampered · unknown_version · missing_manifest |
Si un archivo ha sido modificado, ves qué archivos difieren y sus hashes esperados vs. los actuales. El reporte llega automáticamente cada vez que el recurso arranca.
tamperedSignifica que uno o más archivos Lua difieren del ZIP oficial. Puede ser una edición accidental, una actualización parcial o un intento de manipulación. Descarga el ZIP limpio y reinstala.
📋 Audit — Historial de acciones
Tabla append-only (solo lectura) de toda acción humana o de sistema que modifique algo del Guard: cambios de config, bans creados, allowlist modificada, keys generadas/revocadas, acciones del staff, etc.
- Filtros por actor, tipo de acción y rango de fechas.
- Paginación por keyset (cursor basado en ID) — escala a históricos grandes sin degradar rendimiento.
- Útil para auditorías internas, demostrar acciones del staff o investigar incidentes.
👥 Players — Jugadores en vivo
Dashboard de todos los jugadores conectados ahora mismo, ordenados por risk score 0–100 (los más sospechosos arriba).
Por cada jugador:
- Avatar, nombre, Discord ID, badges (verificado FiveRank, bans previos, etc.)
- Pill de riesgo animado — verde (limpio) → amarillo (warn) → naranja (suspicious) → rojo parpadeante (critical).
- Score numérico y desglose de factores que lo elevan: bans previos, detecciones recientes, multi-cuenta, reputación negativa, federación, etc.
Acciones rápidas:
| Acción | Descripción |
|---|---|
| Kick | Drop in-game con razón personalizada. |
| Warn | Mensaje de chat privado al jugador. |
| Ban | Crea el ban en la API + kick inmediato desde la cola. |
| Espectar | Mueve tu cámara al jugador (requiere allowStaffMovementActions = true). |
| Ir a | Teletransporta tu personaje junto al jugador. |
| Traer | Teletransporta al jugador junto a ti. |
| Revivir | Reanima al jugador si está muerto. |
| Curar | Restaura HP + Armor al máximo. |
| Congelar / Descongelar | Inmoviliza al jugador en su posición actual. |
Las acciones de movimiento están sincronizadas con el panel in-game /fivepanel y requieren Config.Behavior.allowStaffMovementActions = true.
Modal de perfil completo: click en la tarjeta del jugador → modal con todos los detalles: badges, hasAccount, IP, inicio de sesión, sesiones previas en este servidor, factores de riesgo y historial de flags.
🎬 Forensic — Replays de anomalías
Revisión de Forensic Replays congelados automáticamente al detectar:
- Un evento de riesgo
critical. - Un disparo del Honeypot Engine.
- Una petición manual de staff.
Cada replay incluye:
- Timeline visual con scrubber — posiciones en el mapa, daño dado/recibido por tick, armas usadas, eventos de red relevantes.
- Metadatos completos: Discord ID, IP, versión del cliente, framework session.
- Triggers de Honeypot recientes asociados al mismo jugador.
El sistema presenta los hechos objetivamente. El owner decide con evidencia — nunca hay ban automático.
🎯 Combat — Combat Anomaly Detector
Anomalías de combate detectadas en tiempo real por el servidor.
| Tipo | Qué detecta |
|---|---|
| ROF | Rate of fire imposible para el arma (dispara más rápido que su cadencia máxima). |
| Headshot ratio | Porcentaje de headshots fuera de 4σ vs. baseline del servidor. |
| Multi-hit simultáneo | Varios impactos en el mismo tick — imposible con armas de proyectil único. |
| Distancia | Daño registrado fuera del envelope realista del arma (más allá del falloff máximo). |
Baselines calibrados por servidor: FR Guard no usa valores genéricos. Los baselines se calculan sobre los datos reales de tu servidor (sampleSize configurable), por lo que un jugador con aim entrenado legítimo no genera alertas.
Filosofía: cero falsos positivos por diseño. NUNCA dispara ban automático. Cada anomalía eleva el risk score y congela un replay forense para que tú decidas con evidencia.
🌐 Federation — Red federada cross-server
La Cross-Server Federated Reputation Network permite a los servidores opt-in compartir eventos cualificados con evidencia para protegerse mutuamente de jugadores problemáticos itinerantes.
Cómo funciona:
- Cuando tu servidor detecta un evento grave (combat critical, honeypot, ban con evidencia), lo federa con firma HMAC a la red.
- Otros servidores opt-in reciben el evento ponderado por el trust del emisor y el decay temporal (los eventos pierden peso con el tiempo).
- El evento contribuye como factor al risk score del jugador en otros servidores.
- El jugador puede impugnar el evento desde su perfil en FiveRank — el proceso es auditable.
Los 3 mandamientos:
- CERO falsos positivos — el evento federado aporta como factor de risk, nunca dispara ban automático.
- Owner soberano — tú decides qué peso le das a la red en tu servidor.
- Privacidad — solo se federan Discord IDs y categoría del evento. Nunca IPs, coordenadas ni datos personales.
🚪 Pre-Connect — Risk Gateway en la conexión
Evalúa el riesgo del jugador antes del spawn vía playerConnecting deferrals de FiveM.
Thresholds configurables:
- A partir de qué score se activa (warn / suspicious / critical).
- Acción por threshold:
log only·warn·kick·ban.
Fail-open garantizado: ante cualquier error (token inválido, DB down, timeout de red), el jugador entra. La seguridad nunca rompe la experiencia de usuario.
Aprovecha la red federada: un jugador con reputación crítica federada puede ser bloqueado antes de spawnear, incluso si nunca ha pisado tu servidor.
Otras secciones del panel
Predictive Engine
Motor de riesgo estadístico opt-in. Muestra:
- Tabla de calibración por factor: multiplicador, sample size, follow-rate, baseline actual.
- Toggle para activar/desactivar el motor.
- Botón de recompute manual forzado.
La estadística es cerrada, auditable y calculada per-server. No es ML black-box — cada factor y su peso está documentado.
Ban history público
En el perfil público de tu servidor aparece un bloque con el total de bans aplicados usando FR Guard. Sirve como señal social: "este servidor tiene moderación activa". No expone Discord IDs ni datos de los baneados.
Resumen de pestañas
| Pestaña | Acceso | Para qué |
|---|---|---|
| 🔑 Keys | Owner | Gestionar API Keys |
| 🚫 Bans | Owner / Staff | Ver, crear y revocar bans Discord y HWID |
| ✅ Allowlist | Owner / Staff | Excepciones de acceso por servidor |
| 🚨 Detecciones | Owner / Staff | Feed de flags, webhooks, honeypot |
| 🛡 Integridad | Owner | Verificación SHA-256 del recurso |
| 📋 Audit | Owner | Historial append-only de acciones |
| 👥 Players | Staff | Jugadores en vivo con riesgo y acciones |
| 🎬 Forensic | Staff | Replays visuales de anomalías |
| 🎯 Combat | Staff | Anomalías de combate calibradas |
| 🌐 Federation | Owner | Red federada cross-server |
| 🚪 Pre-Connect | Owner | Thresholds y acciones antes del spawn |
| 🔮 Predictive | Owner | Motor de riesgo estadístico |