Logs Docs
Présentation
Kairo Logs enregistre ce qui se passe sur ton serveur : mouvements d'argent, objets, connexions, morts, commandes d'administration. Chaque entrée contient l'identité du joueur (nom, licence, ID).
Les journaux partent vers Discord (un salon par catégorie si tu veux), dans un fichier, ou les deux. Les modules Kairo y envoient automatiquement leurs événements ; tu peux aussi y écrire depuis tes propres ressources.
Installation
- Télécharge l'archive depuis « Mes achats » et décompresse-la.
- Place le dossier kairo-logs dans resources/[kairo]/ de ton serveur.
- Vérifie que kairo-core est démarré avant kairo-logs dans ton server.cfg.
- Ajoute la ligne ensure kairo-logs, puis redémarre le serveur. Les tables sont créées automatiquement au premier lancement.
# server.cfgensure kairo-coreensure kairo-logs
Configuration
Une catégorie sans webhook n'écrit que dans le fichier. Les couleurs sont au format décimal attendu par Discord.
-- config.luaConfig.File = true -- logs/kairo-YYYY-MM-DD.logConfig.Categories = { money = { webhook = 'https://discord.com/api/webhooks/…', color = 3066993 }, items = { webhook = 'https://discord.com/api/webhooks/…', color = 15844367 }, admin = { webhook = 'https://discord.com/api/webhooks/…', color = 15158332 }, connect = { webhook = false }, -- fichier seulement}
API
Les exports s'appellent avec exports['kairo-logs']:Nom(...). Les fonctions serveur ne sont jamais accessibles depuis le client.
Send
serveurexports['kairo-logs']:Send(category, data)
Écrit une entrée dans une catégorie. Si data contient player, l'identité du joueur est ajoutée automatiquement.
| Paramètre | Type | Description |
|---|---|---|
category | string | Nom de la catégorie |
data | table | Champs à enregistrer |
Retour rien
exports['kairo-logs']:Send('money', { player = source, amount = 500, reason = 'paycheck',})
RegisterCategory
serveurexports['kairo-logs']:RegisterCategory(name, webhook, color)
Crée une catégorie depuis une autre ressource, sans toucher à la configuration.
| Paramètre | Type | Description |
|---|---|---|
name | string | Nom de la catégorie |
webhook | string|false | URL du webhook ou false |
color | number? | Couleur Discord |
Retour rien
exports['kairo-logs']:RegisterCategory('casino', webhookUrl, 10181046)FAQ
Discord limite-t-il le nombre de messages ?
Oui. Kairo Logs regroupe les entrées et respecte les limites de Discord : en cas de pic, les messages sont mis en file plutôt que perdus.
Combien de temps les fichiers sont-ils gardés ?
Un fichier par jour, conservé selon Config.KeepDays (30 jours par défaut).