Log FiveM consultabili, con alert su Discord.

Perché i canali Discord sono un posto scomodo per i log

La maggior parte dei server FiveM inizia a loggare allo stesso modo: ogni risorsa posta un embed su un webhook Discord, un canale per categoria. Funziona il primo giorno. Al terzo mese i canali contengono centinaia di migliaia di messaggi, la ricerca di Discord non sa filtrare per importo o license, i rate limit dei webhook perdono eventi nelle ore di punta, e gli screenshot allegati a quei messaggi diventano link che scadono.

BasiX mantiene la parte che funziona — una notifica su Discord quando serve l'intervento umano — e sposta la cronologia stessa dove può essere interrogata. Il tuo staff viene comunque avvisato; clicca semplicemente su una ricerca invece di scorrere.

Inviare eventi da FiveM

Installa la risorsa basix, imposta la tua chiave in server.cfg, e chiama exports.basix:info, warn, error o debug da qualsiasi risorsa. Gli eventi vengono raggruppati e inviati ogni due secondi in un’unica richiesta, e fino a 400 vengono tenuti in memoria se l'API è irraggiungibile, così una breve interruzione non fa perdere la traccia di un ban. La risorsa chiamante viene compilata automaticamente.

Qualsiasi cosa sappia fare una richiesta HTTP può anche loggare: POST https://basix.media/api/v1/logs con un dataset e fino a 500 eventi per richiesta. L’endpoint accetta 240 richieste al minuto per chiave, ampiamente sufficiente una volta raggruppati gli eventi.

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

Log giocatori: un profilo per giocatore

Ogni evento inviato con un campo player alimenta un profilo: prima e ultima apparizione, conteggio eventi per categoria, e identificativi trovati nei metadata — license, license2, discord, steam, fivem, xbl, live, rockstar e citizenid. Il tuo team può aggiungere un nome visualizzato, note interne e campi personalizzati, così la cronologia di un giocatore segnalato spesso sta in una pagina invece che in una ricerca tra dieci canali.

Categorie, colonne e viste salvate

Ogni dataset può diventare una categoria con etichetta, colore, icona e gruppo, e con colonne lette dai metadata: un log di economia può mostrare importo e fonte come colonne vere, un log di veicoli la targa. Le viste salvate memorizzano un insieme di filtri — categorie, livelli, giocatore, risorsa, testo e intervallo di tempo — e sono condivise con il team di default, così il moderatore di turno apre la stessa vista costruita dall'admin principale.

Alert Discord quando conta davvero

Una regola di alert si attiva quando un numero di eventi corrispondenti arriva entro una finestra di tempo — per esempio tre eventi warn o error nella categoria economia in cinque minuti, con il metadata source uguale ad admin. Resta poi silenziosa per un periodo di cooldown che scegli tu, così una raffica non riempie il canale. Gli alert vengono inviati a un webhook Discord, ai tuoi endpoint webhook, o entrambi.

Le regole di alert sono incluse nei piani: 5 con Starter, fino a 100 con Ultra.

Retention e prezzo

I log sono inclusi in ogni piano, non venduti come abbonamento separato. Contano verso lo stesso spazio di archiviazione dei tuoi file e vengono conservati secondo il tuo piano: Free 3 days, Starter 30 days, Pro 90 days, Business 90 days, Ultra 180 days. Una quota piena risponde con un errore esplicito invece di scartare eventi in silenzio.