Des logs FiveM consultables, avec alertes sur Discord.

Pourquoi un salon Discord est un mauvais endroit pour des logs

La plupart des serveurs FiveM commencent de la même façon : chaque ressource poste un embed sur un webhook Discord, un salon par catégorie. Le premier jour, ça marche. Au troisième mois, les salons contiennent des centaines de milliers de messages, la recherche Discord ne sait pas filtrer sur un montant ou une license, les limites de débit des webhooks font perdre des événements aux heures chargées, et les captures jointes à ces messages deviennent des liens qui expirent.

BasiX garde ce qui fonctionne — une notification Discord quand un humain doit intervenir — et déplace l’historique lui-même là où on peut l’interroger. Votre staff est toujours notifié ; il clique simplement vers une recherche au lieu de faire défiler.

Envoyer des événements depuis FiveM

Installez la ressource basix, mettez votre clé dans server.cfg, puis appelez exports.basix:info, warn, error ou debug depuis n’importe quelle ressource. Les événements sont regroupés et envoyés toutes les deux secondes en une requête, et jusqu’à 400 sont gardés en mémoire si l’API est injoignable : une courte coupure ne fait pas perdre la trace d’un ban. La ressource appelante est renseignée automatiquement.

Tout ce qui sait faire une requête HTTP peut aussi envoyer des logs : POST https://basix.media/api/v1/logs avec un dataset et jusqu’à 500 événements par requête. Le point d’accès accepte 240 requêtes par minute et par clé, largement assez une fois les événements regroupés.

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

Logs joueurs : un profil par joueur

Chaque événement envoyé avec un champ player alimente un profil : première et dernière apparition, nombre d’événements par catégorie, et identifiants trouvés dans les métadonnées — license, license2, discord, steam, fivem, xbl, live, rockstar et citizenid. Votre équipe peut ajouter un nom d’affichage, des notes internes et des champs personnalisés : l’historique d’un joueur souvent reporté tient sur une page au lieu d’une recherche dans dix salons.

Catégories, colonnes et vues enregistrées

Chaque dataset peut devenir une catégorie avec libellé, couleur, icône et groupe, et des colonnes lues dans les métadonnées : un log d’économie peut afficher le montant et la source en vraies colonnes, un log de véhicules la plaque. Les vues enregistrées mémorisent un jeu de filtres — catégories, niveaux, joueur, ressource, texte et période — et sont partagées avec l’équipe par défaut : le modérateur de garde ouvre la même vue que celle construite par l’admin principal.

Des alertes Discord quand ça compte

Une règle d’alerte se déclenche quand un nombre d’événements correspondants arrive dans une fenêtre de temps — par exemple trois événements warn ou error dans la catégorie économie en cinq minutes, avec la métadonnée source égale à admin. Elle reste ensuite silencieuse pendant un délai que vous choisissez, pour qu’une rafale n’inonde pas le salon. Les alertes partent vers un webhook Discord, vers vos propres points de webhook, ou les deux.

Les règles d’alerte sont incluses dans les offres : 5 avec Starter, jusqu’à 100 avec Ultra.

Conservation et prix

Les logs sont inclus dans toutes les offres, pas vendus comme un abonnement à part. Ils comptent dans le même stockage que vos fichiers et sont conservés selon votre offre : Free 3 jours, Starter 30 jours, Pro 90 jours, Business 90 jours, Ultra 180 jours. Un quota plein renvoie une erreur explicite au lieu d’ignorer des événements en silence.