LOOP Docs
Menu F1GuidesItems
Accueil/Systèmes/Logs du serveur

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.

Console des logs, onglet Accueil
Accueil : en en-tête le nom du serveur, le nombre d’entrées et de familles, l’indicateur Flux actif (rafraîchissement automatique), le curseur de transparence du fond (30 % = apparence d’origine) et la clé de permission. Les tuiles résument le journal : entrées, période couverte, personnages distincts, comptes bancaires, actions admin et permissions tracées. Rechercher n’importe quoi accepte un numéro de personnage, une plaque, un numéro de téléphone, une arme, une licence…

Le journal

Onglet Journal des logs
Journal : à gauche la recherche (texte libre, période 1 h, 24 h, 7 j ou tout, date précise et raccourcis des derniers jours), les vues rapides (Dons, Argent, Staff, Véhicules, Violence), les identifiants (numéro de personnage, plaque, licence, Discord ou IP) et les catégories avec leur volume. À droite les entrées, de la plus récente à la plus ancienne : heure, famille en couleur, action, pseudo et numéro de personnage, message. Confort / Dense règlent l’espacement.

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

Logs, Global 1 · nouvelle direction artistique
Global 1 · nouvelle direction artistique · Logs, style 3
Logs, Global 2 · direction originale
Global 2 · direction originale · Logs, style 1

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).
Onglet Joueurs des logs
Joueurs : à gauche les comptes, au centre leurs personnages, à droite la fiche du personnage choisi : identité, numéros, état, date de naissance, sexe, taille, numéro de sécurité sociale (masqué ici), licence, rang serveur, métier et patrimoine.
Onglet Graphiques des logs
Graphiques : le total sur la période, puis l’activité par jour (événements, personnages, connexions ou alertes) ; un clic sur un jour l’ouvre dans le journal. Plus bas, l’activité par heure (heure de Paris) et par jour de la semaine.

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é.

Onglet Permissions des logs, rang Moderateur
Permissions (rang développeur seulement) : les grades de modération et le nombre de familles qu’ils voient (17 sur 19 pour Moderateur). Décocher une famille la masque à ce grade ; la première case accorde ou retire l’accès à la console. Tout autoriser / Tout masquer agissent sur le grade affiché.

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 Studios · documentation générée depuis le serveur loop_dev le 22/10/2026 · accueil · Raccourci : Ctrl K