Agency-Admin: Herramientas de moderación profesionales para comunidades reales de FiveM

La brecha entre las herramientas para aficionados y las profesionales

La mayoría de los menús de administración de FiveM son de nivel aficionado: botones para dar armas, teletransportarse, usar noclip y cosas por el estilo. Agency-Admin está diseñado para comunidades que se toman la moderación tan en serio como lo haría un equipo de moderación de un estudio de videojuegos real.

Registro de acciones con contexto

Cada acción de administración se guarda en un registro resistente a manipulaciones, con el ID del administrador, el objetivo, la acción, la fecha y hora, y el motivo. Se acabaron los misterios de «¿quién le dio un Rhino a ese jugador?». Puedes consultar los registros desde la interfaz de administración con filtros por administrador, intervalo de tiempo y tipo de acción. Es la infraestructura básica de rendición de cuentas que los equipos de moderación realmente necesitan.

Niveles de permisos

Tres niveles integrados: moderador (expulsar, aplicar timeout y comprobaciones básicas de objetos), administrador (banear, dar objetos y teletransportar), administrador sénior (cambios de configuración, gestión de permisos y administración de bases de datos). Las acciones de cada nivel tienen un alcance estricto, un moderador no puede ascender sus propios permisos encontrando una vulnerabilidad. Hemos probado este modelo con varias comunidades grandes durante los últimos dos años.

Gestión de baneos

Los baneos admiten duración, motivo, URL de evidencia (enlace a una captura de pantalla o un vídeo), estado de la apelación y notas de revisión. Cuando un jugador baneado intenta volver a conectarse, el mensaje que ve incluye el motivo y, si se ha configurado, un enlace para apelar. Una moderación transparente es una moderación eficaz.

Detección de amenazas en tiempo real

Agency-Admin incluye una capa de detección configurable que señala patrones sospechosos: aumentos repentinos de dinero, teletransportes imposibles, duplicación rápida de objetos y aparición inusual de armas. Las alertas aparecen en el panel de administración con todo el contexto. No somos un anticheat, somos una herramienta de detección que reduce el tiempo de respuesta del equipo de administración de horas a minutos.

Instalación y configuración

Agency-Admin requiere oxmysql para guardar los registros. Importa admin.sql en tu base de datos, añade el recurso a tu servidor y añade ensure agency-admin a server.cfg . La asignación del primer administrador se hace mediante config.lua; añade tus identificadores de mayor confianza como administradores sénior. A partir de entonces, todos los demás permisos se asignan desde la interfaz del juego.

El recurso detecta automáticamente tu framework al iniciarse. Incluye hooks de permisos para QBCore y ESX; en las configuraciones standalone, implementa la función Config.IsAdmin(src, level) manualmente.

Opciones de configuración

El config.lua incluye ajustes de permisos y detección:

• Niveles de permisos, puedes redefinir por completo los nombres y las capacidades de cada nivel. El modelo predeterminado de tres niveles es un punto de partida, no un requisito.
• Umbrales de detección, configura el umbral de aumentos de dinero, el límite de distancia de teletransporte y la velocidad de aumento de la cantidad de objetos que activan alertas.
• Webhook de Discord, todas las acciones de administración y las alertas de detección pueden enviarse también a un canal de Discord, además de guardarse en el registro del juego.
• URL para apelar un baneo, la URL que se muestra a los jugadores baneados en el mensaje del baneo.
• Retención de registros, cuántos días se conservan los registros de acciones administrativas antes de la limpieza automática. Valor predeterminado: 90 días.
• Modo sigiloso para administradores sénior, los administradores sénior pueden navegar por el servidor de forma anónima sin aparecer en las listas de jugadores.

Compatibilidad con frameworks

Agency-Admin funciona con QBCore, ESX y configuraciones standalone. La capa de permisos es la única parte que interactúa con el framework; todo lo demás (la interfaz, los registros, el sistema de baneos y el motor de detección) es independiente del framework. Para frameworks personalizados, la capa de compatibilidad consta de cuatro funciones en config.lua.

Por qué esto importa para el roleplay

La salud del servidor está directamente relacionada con la calidad de la moderación. Las comunidades con una moderación visible, coherente y responsable retienen a los jugadores durante más tiempo que aquellas que dependen de decisiones informales. El registro de auditoría de Agency-Admin es el mecanismo clave de rendición de cuentas: cuando se cuestiona una decisión de moderación, el registro proporciona el contexto exacto de lo ocurrido, cuándo ocurrió y quién lo autorizó.

La capa de detección cambia la forma de trabajar del equipo de administración: pasa de reaccionar a actuar de forma proactiva. En lugar de esperar a que los jugadores denuncien a un posible tramposo, el panel muestra patrones sospechosos antes de que causen daños en todo el servidor. Detectar un exploit para duplicar dinero durante la primera hora causa mucho menos daño que dejar que siga funcionando durante dos días sin detectarlo.

El sistema de niveles de permisos protege frente a riesgos internos. Que un moderador recién incorporado tenga el mismo acceso que un administrador sénior es un problema de seguridad y responsabilidad. Los permisos estrictamente delimitados hacen que, incluso si un miembro del equipo se vuelve problemático, el alcance del daño quede limitado por su nivel.

Preguntas frecuentes

¿Puedo añadir comandos de administración personalizados que se integren con el sistema de permisos?

Sí. Usa exports['agency-admin']:RegisterCommand(name, tier, handler) para registrar comandos personalizados que heredan las comprobaciones de permisos y el registro automático de Agency-Admin. Tu comando aparecerá en la lista de comandos de la interfaz de administración y se registrará igual que las acciones integradas.

¿Cómo gestiona el sistema de baneos las cuentas con VPN o cuentas alternativas?

Agency-Admin registra el conjunto completo de identificadores (license, steam, discord, IP) en el momento del baneo. Cuando alguien intenta reconectarse, comprueba todos los identificadores, no solo el que se usó para iniciar sesión. Para servidores con problemas persistentes de evasión de baneos, el panel incluye un sistema de alertas para patrones sospechosos de identificadores.

¿Los moderadores pueden ver las alertas de detección antes de tomar medidas?

Las alertas están disponibles para todos los administradores cuyo nivel sea igual o superior al mínimo configurado para ese tipo de alerta. Las alertas de picos de dinero son visibles para todos los administradores; de forma predeterminada, las alertas de teletransportación imposible solo se muestran a los administradores técnicos. También se registra cada consulta de alertas, para que los administradores puedan ver qué alertas revisaron sus compañeros y qué medidas, si las hubo, tomaron.

¿Agency-Admin entra en conflicto con otros menús de administración, como vMenu o qb-adminmenu?

No hay conflicto. Agency-Admin puede funcionar junto con otros menús: usan distintas teclas de acceso rápido y no comparten estado. Algunos servidores usan Agency-Admin junto con un menú de administración antiguo durante la transición, para registrar acciones y detectar incidentes con Agency-Admin, mientras mantienen los comandos conocidos para el personal veterano.

Requisitos

• Servidor FiveM (QBCore, ESX o standalone)
• oxmysql
• Cuenta de cfx.re con una licencia válida de Agency-Admin
• Opcional: Agency-Reports (para gestionar de forma integrada los informes de jugadores)

Cómo crear una cultura de equipo en torno a las herramientas

Las mejores herramientas de administración del mundo no sirven de mucho si la cultura de tu equipo no fomenta la rendición de cuentas. El registro de auditoría de Agency-Admin es más valioso en comunidades donde el personal sabe que sus acciones quedan registradas y lo acepta como un procedimiento estándar, no como vigilancia.

Establece desde el principio que todas las acciones administrativas deben realizarse mediante la interfaz con registro. Resiste la tentación de saltarte el registro «solo esta vez» para resolver algo rápido: su valor depende de que esté completo. Cuando necesitas reconstruir lo ocurrido, un registro con lagunas es casi tan malo como no tener ninguno.

Usa las alertas de detección en las revisiones semanales del equipo, no solo cuando algo sale mal. Revisar las alertas de la semana, incluso cuando no haya ocurrido nada destacable, ayuda a familiarizarse con lo que es normal y facilita detectar anomalías cuando aparecen.

El sistema de niveles de permisos funciona mejor cuando los ascensos entre niveles son hitos significativos. Un moderador que obtiene acceso de administrador después de tres meses de trabajo sin incidentes y registrado cuenta con una experiencia y un compromiso que no se consiguen al conceder acceso completo de inmediato.