Logs du serveur
Presque tout ce qui se passe sur le serveur laisse une ligne dans un journal central : connexions, messages et commandes, morts et tirs, argent, objets, véhicules, actions du staff, refus de permission, alertes de l’anticheat. Le staff le consulte dans la console Logs, ouverte par F1 › Administration › 📜 Logs. Les entrées sont gardées 30 jours.
En bref
| Ouvrir | F1 › Administration › Logs |
| Pour qui | f1.logs.consulter ; masquer une famille à un rang : f1.logs.masquer.<famille> |
| Où | Table volta_logs (une ligne par événement, avec l’identité et l’état du joueur) |
| Rétention | 30 jours (convar loop_logs_retention_days, 0 = jamais purgé) |
| Écrire une ligne | Export |
| Ressources | loop-framework (enregistrement), loop-admin (console, et ) |
Pour les joueurs
Les joueurs n’ont pas accès à la console. Ce qu’il faut savoir : vos connexions, vos messages de chat, vos commandes (300 premiers caractères), vos morts, vos transactions et vos mouvements d’objets sont enregistrés avec votre position et votre état du moment, pour permettre au staff de vérifier un litige ou une triche. Seuls les membres du staff qui ont l’accès peuvent les lire ; l’adresse IP n’est affichée qu’au rang développeur.
Pour le staff
Ouvrir la console
F1 › Administration › 📜 Logs. Le serveur vérifie f1.logs.consulter ; sans elle : « Accès aux logs refusé ». Échap ou la croix ferment la console.

Le journal

Cliquer une entrée ouvre son détail : identifiants, position, vie et armure, arme en main, véhicule et vitesse, argent liquide et en banque, groupe, et les données propres à l’événement. La console charge les 3 000 dernières entrées à l’ouverture ; les filtres interrogent la base (jusqu’à 5 000 lignes par recherche).
Deux directions artistiques : la console des journaux


Ce que change Global 1 par rapport à Global 2
- Fenêtre opaque sombre, compteurs et onglets plus compacts.
- Global 2 garde la même organisation en panneau translucide avec accents bleus et dorés.
Le staff choisit la direction artistique de tout le serveur (Global 1 ou Global 2) ou un style par interface dans la galerie des styles en jeu ; le changement s’applique aux joueurs sans redémarrage.
Les autres onglets
| Onglet | Ce qu’il montre |
|---|---|
| Banque | Comptes bancaires (IBAN, titulaire, solde, type, banque, verrouillage) et les 8 000 dernières transactions. |
| Téléphone | Lignes (numéro, appareil, carte SIM, titulaire), messages et appels (durée, décroché, anonyme, vidéo, haut-parleur). |
| Staff | Chaque membre du staff qui a des actions admin ou permission au journal, avec son rang, son poids, sa dernière action et l’historique de ses actions. |
| Biens | Véhicules enregistrés : plaque, modèle, statut, propriétaire (personnage ou groupe), bâche, dates de création et de mise à jour. |
| Joueurs | Comptes et personnages : identité RP, statut, licence, rang, métier, temps de jeu, argent, position. |
| Armes et Objets | Contenu des inventaires, coffres et boîtes à gants, et les 4 000 derniers mouvements d’objets (dons, crafts, loots, achats). |
| Graphiques | Activité par jour, par heure, par jour de la semaine, par famille, alertes anticheat et joueurs les plus actifs. |
| Permissions | Réservé au rang développeur : quelles familles chaque rang voit. |
| Traçabilité | Toute l’histoire d’un personnage (400 dernières entrées). |


Masquer des familles à un rang
Par défaut, un rang qui a l’accès voit tout. Pour lui cacher une famille (par exemple le téléphone ou la banque pour les modérateurs), donnez à ce rang la clé f1.logs.masquer.<famille> : ses entrées disparaissent alors partout, dans le journal, les recherches et les totaux. Ces clés sont créées automatiquement pour chaque famille connue, dans la section « Accès aux logs » de /perms. Le rang développeur n’est jamais masqué.

Les familles
Les familles connues de la console sont : admin, anticheat, banque, boutique, braquage, chat, combat, commande, config, connexion, craft, drogue, economie, ems, groupe, immobilier, inventaire, jeu, job, loot, marker, menu, mort, permission, personnage, police, porte, prop, reseaux, rp, serrurier, service, societe, staff, surveillance, systeme, telephone, vehicule, vol. Toute autre famille trouvée dans la table (par exemple tablette, peche, monde) est ajoutée d’elle-même à la liste et à ses clés de masquage.
Quelques repères :
| Famille | Exemples d’entrées |
|---|---|
connexion |
« … se connecte », « … se déconnecte » (avec la raison) |
commande |
chaque commande tapée, au plus une toutes les 200 ms par joueur |
admin |
bans, kicks, avertissements, gel, téléportations du staff |
staff |
usage d’une permission accordée, options de triche du staff |
permission |
refus (« tente … sans la permission »), rangs appliqués |
mort, combat |
« … tué par … (arme) », tirs |
menu |
ouvertures de menus, regroupées pour ne pas inonder la table |
Les autres journaux
- Réglages du serveur : chaque valeur modifiée est aussi journalisée (voir Réglages du serveur).
- Console du serveur (txAdmin) : messages techniques des ressources, erreurs, et refus de permission quand le journal n’est pas joignable.
Bon fonctionnement
Écrire une entrée
Les entrées sont mises en file et écrites par lots toutes les 1,5 seconde (500 en attente au plus ; au-delà, les nouvelles sont ignorées jusqu’à l’écriture suivante). Elles sont aussi diffusées en interne par l’événement serveur loop:log:entree, que d’autres scripts peuvent écouter.
Purge
Toutes les 6 heures, les entrées plus vieilles que loop_logs_retention_days (30 par défaut) sont supprimées par paquets de 2 000. Avec 0, rien n’est purgé : surveillez alors la taille de la table.
La console
La console (loop-admin) ne lit que la base. À chaque requête, le serveur revérifie f1.logs.consulter et ignore les réponses destinées à une session de console fermée entre-temps. Les gros paquets (annuaire, objets) sont mis en cache 12 secondes et envoyés en flux lent pour ne pas geler le jeu ; la console se rafraîchit toute seule toutes les 12 secondes quand aucun champ n’est en cours de saisie. Les IP sont vidées dans toutes les réponses sauf pour le rang développeur.
Données sensibles
La console donne accès aux messages et appels des téléphones, aux comptes bancaires et aux inventaires de tous les personnages. Réservez f1.logs.consulter aux rangs de confiance et masquez les familles telephone et banque aux rangs qui n’en ont pas besoin.
Problèmes courants
| Symptôme | Cause | Solution |
|---|---|---|
| « Accès aux logs refusé » | Pas de f1.logs.consulter |
Donnez la clé au rang dans /perms. |
| La console s’ouvre mais reste vide | Base de données indisponible ou table volta_logs absente |
Vérifiez oxmysql ; la table est créée au démarrage de loop-framework. |
| Une famille n’apparaît pas pour un modérateur | Elle lui est masquée (f1.logs.masquer.<famille>) |
Onglet Permissions de la console, ou /perms. |
| Les heures affichées ont une heure d’avance en hiver | La console convertit l’heure en UTC+2 fixe (constat dans le code) | Retirez une heure entre fin octobre et fin mars. |
| Des événements manquent lors d’un pic | File d’attente pleine (plus de 500 entrées en 1,5 s) | Rare ; cherchez la ressource qui journalise en boucle. |
| La table grossit sans fin | loop_logs_retention_days vaut 0 |
Remettez un nombre de jours. |
LOOP Docs