Documentation / Utiliser les logs sur le serveur

Utiliser les logs sur le serveur

Comment enregistrer des événements depuis vos scripts FiveM et les consulter dans le panneau.

Adictos_WebLogs centralise les événements de votre serveur. De nombreux logs sont générés automatiquement (inventaire ox, connexions, véhicules…), mais vous pouvez enregistrer les vôtres depuis n’importe quel script grâce aux exports de la ressource.

Logs automatiques d’ox_inventory

Avec l’intégration ox_lib, les mouvements d’inventaire arrivent seuls dans le panneau lorsque Adictos_WebLogs est démarré. WebLogs les interprète (casier, coffre, donner un objet…) et les regroupe ; aucun code supplémentaire n’est nécessaire dans vos scripts.

ox_inventory (lib.logger)
    │
    ▼
ox_lib/imports/logger/server.lua  ← adapté (Adictos_WebLogs)
    │
    ▼
Adictos_WebLogs (buffer → panneau)
    │
    ▼
Panneau web (traitement + vue Logs)

Enregistrer un log depuis un autre script

Depuis le côté serveur de n’importe quelle ressource, avec Adictos_WebLogs démarré. Il existe deux méthodes courantes :

Log() — vous fournissez les données du joueur

Utile si vous avez déjà xPlayer ou si vous voulez contrôler vous-même la licence, le nom IC et le nom OOC. Vérifiez que la ressource est active avant l’appel :

if GetResourceState('Adictos_WebLogs') == 'started' then
    exports['Adictos_WebLogs']:Log('inventory', 'item_give', {
        license = xPlayer.identifier,   -- sin prefijo license:
        playerName = xPlayer.getName(),
        playerOOC = GetPlayerName(source),
        details = 'Entregó 5x pan',
        severity = 'INFO',              -- DEBUG | INFO | WARNING | ERROR | CRITICAL
    }, true)  -- true = enviar a Discord si la categoría tiene webhook
end

LogPlayer() — la ressource renseigne le joueur

Passez le source du joueur et WebLogs récupère automatiquement la licence et les noms. Moins de code lorsque l’événement provient d’un joueur connecté :

exports['Adictos_WebLogs']:LogPlayer(source, 'jobs', 'duty_on', {
    details = 'Entró de servicio',
}, true)

Catégories

Chaque log appartient à une catégorie : elle regroupe les événements dans le panneau (vue GENERAL, filtres, profil du joueur) et, si vous le souhaitez, dans un salon Discord distinct. L’appel Log(categoría, acción, datos) utilise deux identifiants différents :

  • Catégorie (1er paramètre) — type d’événement au niveau du serveur : inventory, vehicles, jobs, anticheat… Elle doit exister dans le panneau et être active.
  • Action (2e paramètre) — ce qui s’est passé dans cette catégorie : item_give, duty_on, vehicle_delete… Vous la définissez dans le script ; elle sert à filtrer et rechercher.

Les catégories se créent dans Mes serveurs → Catégories. Dans le tableau, la colonne Catégorie est l’identifiant technique (texte court en minuscules, sans espaces : inventory, vehicles…). Ce même texte est le 1er paramètre de Log() — il doit correspondre lettre pour lettre. Le nom de la catégorie sert uniquement à l’affichage dans le panneau ; le webhook est optionnel.

-- Ejemplo: categoría 'jobs', acción 'duty_on'
exports['Adictos_WebLogs']:Log('jobs', 'duty_on', { details = 'Entró de servicio' }, true)

-- Ver qué categorías tiene tu servidor ahora mismo
for _, categoria in ipairs(exports['Adictos_WebLogs']:GetCategoryIds()) do
    print(categoria)
end

local meta = exports['Adictos_WebLogs']:GetCategoryMeta('inventory')
-- meta.name, meta.icon, meta.color
Si l’identifiant de catégorie n’existe pas dans le panneau ou est désactivé, le log peut ne pas s’afficher là où vous l’attendez ou tomber dans general. Créez-la et activez-la avant de l’utiliser dans vos scripts.

Champs utiles du log

ChampDescription
licenseLicence du joueur (hex, sans license:)
playerName / playerOOCNom IC et nom Steam
targetLicense / targetNameAutre joueur impliqué
details / reasonTexte descriptif de l’événement
itemsTableau d’objets (nom, quantité…)
amountQuantité numérique (argent, etc.)
locationCoordonnées ou zone
severityDEBUG, INFO, WARNING, ERROR ou CRITICAL
videoDurée en ms pour enregistrer l’écran du joueur (server_id requis)

Helpers et événements alternatifs

Pour connecter facilement d’autres ressources, il existe shared/integration.lua. Le guide complet (événements, véhicules, hook de suppression) se trouve dans API d’intégration.

-- Resumen rápido (ver guía completa en /documentation/integration-api)
shared_scripts { '@Adictos_WebLogs/shared/integration.lua' }

AdictosWebLogs.logPlayer(source, 'jobs', 'duty_on', { details = 'Entró de servicio' })

Flux de données

Votre script (export Log)
    │
    ▼
Adictos_WebLogs (buffer en mémoire)
    │ envoi périodique au panneau
    ▼
Panneau web (base de données)
    │
    ├─► Vue Logs / profil du joueur
    └─► Discord (si la catégorie a un webhook)

Où voir les logs dans le panneau

VueUtilisation
Logs → GENERALTous les événements du serveur par catégorie
Profil du joueurHistorique d’un joueur précis
La connexion FiveM → panneau est validée par l’IP enregistrée dans Mes serveurs. Aucune clé API n’est nécessaire dans le Lua.