Logs de FiveM que puedes buscar, con alertas en Discord.

Por qué los canales de Discord son un mal sitio para guardar logs

La mayoría de los servidores de FiveM empiezan a registrar logs de la misma forma: cada recurso publica un embed en un webhook de Discord, un canal por categoría. Funciona el primer día. Al tercer mes los canales tienen cientos de miles de mensajes, la búsqueda de Discord no puede filtrar por un importe o una licencia, los límites de velocidad del webhook descartan eventos en las horas de más tráfico, y las capturas adjuntas a esos mensajes se convierten en enlaces que caducan.

BasiX conserva lo que funciona — un aviso en Discord cuando algo necesita a una persona — y traslada el registro en sí a un lugar donde se puede consultar. Tu staff sigue recibiendo el aviso; solo que entra directo a una búsqueda en vez de desplazarse por el canal.

Enviar eventos desde FiveM

Instala el recurso basix, configura tu clave en server.cfg, y llama a exports.basix:info, warn, error o debug desde cualquier recurso. Los eventos se agrupan y se envían cada dos segundos en una sola solicitud, y se guardan hasta 400 en memoria si no se puede contactar con la API, así que un corte breve no pierde un registro de ban. El recurso que llama se rellena por ti.

Cualquier cosa capaz de hacer una solicitud HTTP también puede registrar logs: haz un POST a https://basix.media/api/v1/logs con un dataset y hasta 500 eventos por solicitud. El endpoint acepta 240 solicitudes por minuto y clave, de sobra una vez que agrupas los eventos.

exports.basix:log('info', 'Player bought a car', {
    player = GetPlayerIdentifierByType(source, 'license'),
    metadata = { model = 'sultan', price = 25000 },
})

Logs de jugador: un perfil por jugador

Cada evento enviado con un campo player construye un perfil: primera y última vez visto, número de eventos por categoría, e identificadores encontrados en los metadatos — license, license2, discord, steam, fivem, xbl, live, rockstar y citizenid. Tu equipo puede añadir un nombre visible, notas internas y campos personalizados, así que el historial de un jugador que acumula reportes es una sola página en vez de una búsqueda por diez canales.

Categorías, columnas y vistas guardadas

Cada dataset puede convertirse en una categoría con una etiqueta, color, icono y grupo, y con columnas leídas de los metadatos: un log de economía puede mostrar el importe y el origen como columnas reales, uno de vehículos la matrícula. Las vistas guardadas almacenan un conjunto de filtros — categorías, niveles, jugador, recurso, texto y un rango de tiempo — y se comparten con tu equipo por defecto, así que el moderador de turno abre la misma vista que creó el admin principal.

Alertas de Discord cuando importa

Una regla de alerta se activa cuando llega un número de eventos que coinciden dentro de una ventana — por ejemplo tres eventos warn o error en la categoría economía en cinco minutos, con el metadato source igual a admin. Después queda en silencio durante un tiempo de espera que tú eliges, así que una ráfaga no inunda el canal. Las alertas se publican en un webhook de Discord, en tus propios endpoints de webhook, o en ambos.

Las reglas de alerta vienen con un plan: 5 en Starter, hasta 100 en Ultra.

Retención y precio

Los logs están incluidos en todos los planes, no se venden como una suscripción aparte. Cuentan en el mismo almacenamiento que tus archivos y se conservan según la retención de tu plan: Free 3 days, Starter 30 days, Pro 90 days, Business 90 days, Ultra 180 days. Una cuota llena responde con un error explícito en lugar de descartar eventos en silencio.