Agency-Reports: la herramienta de denuncias para administradores de FiveM que sí se usa

El estado de los informes de FiveM en 2026

La mayoría de los servidores todavía usan tickets de Discord o un comando de chat dentro del juego para los informes de los jugadores. Ambos sistemas fallan. Discord no tiene contexto del jugador; un comando de chat pierde toda la información en cuanto el jugador que envió el informe se desconecta. Los administradores terminan haciendo de detectives cuando deberían estar arbitrando. Agency-Reports es la herramienta que nos habría gustado tener cuando gestionábamos nuestro propio servidor.

Contexto capturado automáticamente

Cuando un jugador envía un informe, capturamos automáticamente sus coordenadas, los ID de los jugadores cercanos, el arma equipada, el vehículo y los últimos 60 segundos del chat. Los administradores ven la situación, no solo la acusación. Esto por sí solo reduce el tiempo de investigación a la mitad.

Asignación inteligente

Los informes se asignan al personal según el tipo, la prioridad y quién está conectado en ese momento. Las trampas se asignan a administradores técnicos, las disputas de RP a administradores de RP y el acoso a quien esté de turno. Los informes sin resolver se ponen en cola y generan una alerta en Discord. Se acabó lo de preguntar «¿alguien se está ocupando de esto?» en el chat del personal.

Seguimiento de la resolución

Cada informe tiene un estado: abierto, asignado, en investigación, resuelto, cerrado. Los administradores escriben notas sobre la resolución que quedan guardadas en el informe para siempre. Seis meses después, cuando el mismo jugador envía otro informe, su historial está a un clic. Así trabajan los equipos profesionales de moderación en los MMO, y ya era hora de que llegara a FiveM.

Comentarios para los jugadores

Cuando se resuelve un informe, quien lo envió recibe un breve mensaje explicando qué ocurrió. Aunque la respuesta sea «revisado, no es necesario tomar medidas», los jugadores sienten que se les escucha en vez de que se les ignore. Las comunidades en las que los jugadores se sienten escuchados son más leales; ese es el verdadero mecanismo de retención que ofrecen las buenas herramientas de moderación.

Instalación y configuración

Agency-Reports requiere oxmysql para guardar el historial de informes. Importa reports.sql, copia la carpeta del recurso y añade ensure agency-reports a server.cfg. Conecta tu webhook de Discord en config.lua para reenviar las alertas cuando no haya personal conectado. En el primer inicio, las reglas de asignación se inicializan desde tu configuración, no hace falta ninguna otra configuración de la base de datos.

Los jugadores abren la interfaz de informes del juego con una tecla configurable (por defecto: F9 o un comando de chat). El panel de administración es independiente y solo pueden acceder a él los jugadores con permisos de administrador.

Opciones de configuración

El config.lua controla la asignación, la retención y el comportamiento de la interfaz:

• Categorías de informes, define tantas categorías como quieras (trampas, acoso, disputa de RP, informe de errores, etc.) con reglas de asignación para cada categoría.
• Asignación al personal, cada categoría se asigna a niveles de permisos específicos. Las trampas a los administradores técnicos, las disputas de RP a los moderadores de RP, etc.
• Lista de captura automática, define qué campos de contexto se capturan automáticamente (coordenadas, jugadores cercanos, últimos 60 s del chat, vehículo, arma). Activa o desactiva cada campo por separado.
• Webhook de Discord , URL para reenviar informes cuando no haya nadie conectado. Los informes que no tengan un administrador conectado que coincida con la ruta se envían a Discord.
• Plantillas de mensajes de resolución, personaliza el mensaje que reciben los jugadores cuando se cierra su informe.
• Informes anónimos, activa o desactiva la opción para que quienes informan puedan enviar informes sin revelar su identidad a otros jugadores (los administradores siempre ven quién informó).

Compatibilidad con frameworks

Agency-Reports funciona con QBCore, ESX y standalone. El único componente que interactúa con el framework es la comprobación de permisos para acceder al panel de administración. Para configuraciones standalone, implementa Config.IsAdmin(src, level) en config.lua. El almacenamiento, el enrutamiento y la interfaz de los informes son independientes del framework.

Por qué esto importa para el roleplay

Cada informe de un jugador que queda sin resolver genera desconfianza. Cuando un jugador envía un informe y nunca recibe respuesta, acaba tomando cartas en el asunto (lo que agrava la situación) o se desconecta del servidor por completo. Agency-Reports cierra ese ciclo de comunicación con el sistema de mensajes de resolución, para que los jugadores sepan que su informe se recibió y se procesó, aunque el resultado no fuera el que esperaban.

El sistema de captura de contexto multiplica la eficacia de la moderación en la práctica. Los administradores que llegan a una escena cinco minutos después para investigarla cuentan con todo el contexto: dónde estaba cada persona, qué se dijo y qué llevaba el acusado. Dedican el tiempo a tomar decisiones, no a reconstruir los hechos. Esta reducción del tiempo de investigación aumenta directamente la cantidad de informes que el equipo de administración puede gestionar por hora.

El acceso al historial de seis meses es una función que suele pasarse por alto y que protege a las comunidades a largo plazo. Reconocer patrones en el historial de informes de varios meses permite detectar a jugadores que infringen las reglas poco a poco, en vez de hacerlo descaradamente: quien infringe las reglas de forma moderada, envía tres informes al mes y recibe otros tres, siempre rozando el umbral para que se tomen medidas. El historial permite ver ese patrón.

Preguntas frecuentes

¿Pueden los jugadores adjuntar capturas de pantalla o vídeos como prueba a un informe?

Los jugadores pueden adjuntar la URL de una prueba externa (Imgur, YouTube, Medal.tv). No se admite la subida directa de archivos al servidor por motivos de seguridad y almacenamiento. Los informes vinculados a Discord incluyen la URL de la prueba en la notificación de Discord para que sea fácil revisarla.

¿Qué ocurre con los informes cuando el jugador que los envió se desconecta?

Los informes permanecen en la base de datos, independientemente de si el jugador está conectado. Se guarda todo el contexto capturado cuando se envió el informe (coordenadas, chat, etc.). Los administradores pueden investigar y resolver informes después de que quien los envió se haya ido, y el mensaje de resolución se entrega la próxima vez que el jugador se conecte.

¿Podemos integrar Agency-Reports con nuestro bot de tickets actual?

Sí, mediante el reenvío a un webhook de Discord. Si tu bot de tickets lee mensajes de un canal de Discord, configura el webhook para que use ese canal y los informes aparecerán como mensajes de Discord que el bot puede procesar. Para una integración más estrecha, el recurso activa un evento del lado del servidor agency-reports:onNewReport al que puede suscribirse cualquier script del lado del servidor.

¿Hay una función para cerrar varios informes a la vez durante incidentes con muchos informes?

Sí. El panel de administración incluye una selección múltiple en la lista de informes. Los administradores sénior pueden seleccionar varios informes, aplicar una única nota de resolución y cerrarlos en bloque. Es útil después de eventos del servidor que generan informes duplicados sobre el mismo incidente.

Requisitos

• Servidor FiveM (QBCore, ESX o standalone)
• oxmysql
• Cuenta de cfx.re con una licencia válida de Agency-Reports
• URL del webhook de Discord (para alertas cuando no haya nadie conectado)

Capacitación del equipo con Agency-Reports

Agency-Reports es especialmente útil para quienes empiezan como moderadores. El sistema les guía durante la investigación sin necesidad de una formación extensa. Cuando un moderador nuevo acepta su primer informe, recibe todo el contexto automáticamente: no tiene que preguntar «¿qué ha pasado?», porque los datos capturados de antemano responden a la mayoría de las preguntas antes de que escriba una sola palabra.

El requisito de incluir una nota de resolución (opcional, pero recomendable mediante la configuración) sirve como herramienta de formación. Escribir «revisé las grabaciones, el jugador infringió claramente la regla 3.2, impuse una suspensión de 24 horas» obliga al moderador a explicar sus motivos. Explicarlos mejora la calidad de las decisiones con el tiempo y crea un registro para posibles escaladas o apelaciones.

Si tu comunidad está pasando de moderar mediante tickets de Discord a usar Agency-Reports, mantén ambos sistemas en paralelo durante dos a cuatro semanas. Deja que el equipo use el que prefiera mientras haces un seguimiento del tiempo de resolución y la satisfacción de quienes envían informes. Los datos suelen mostrar que Agency-Reports resuelve los tickets más rápido. Usa esos datos para fomentar la adopción voluntaria en lugar de imponer el cambio.