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
endLogPlayer() — 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.colorgeneral. Créez-la et activez-la avant de l’utiliser dans vos scripts.Champs utiles du log
| Champ | Description |
|---|---|
license | Licence du joueur (hex, sans license:) |
playerName / playerOOC | Nom IC et nom Steam |
targetLicense / targetName | Autre joueur impliqué |
details / reason | Texte descriptif de l’événement |
items | Tableau d’objets (nom, quantité…) |
amount | Quantité numérique (argent, etc.) |
location | Coordonnées ou zone |
severity | DEBUG, INFO, WARNING, ERROR ou CRITICAL |
video | Duré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
| Vue | Utilisation |
|---|---|
| Logs → GENERAL | Tous les événements du serveur par catégorie |
| Profil du joueur | Historique d’un joueur précis |