Logs personnalisés & système d'événements

Flitt capture automatiquement les logs des systèmes populaires et vous permet aussi d'envoyer vos propres événements depuis vos ressources/addons.

⚡

1. Logs automatiques

Flitt capture automatiquement :

FiveM

qb-log, 7DiscordLog

GMod

bLogs/GAS, Helix

🎮

2. Logs personnalisés (FiveM)

Placez ceci dans votre ressource au démarrage :

VVBS.Logs.RegisterCategory("myresource")
VVBS.Logs.RegisterModule("myresource", "actions")

Puis, pour envoyer un log :

VVBS.Logs.Send("myresource", "actions", {
  action = "open_menu",
  player = "Sterwim",
  player_id = 12,
  details = "Clicked on settings"
})

🛠️

3. Logs personnalisés (GMod)

Placez ceci dans votre addon au démarrage :

VVBS.Logs.RegisterCategory("myaddon")
VVBS.Logs.RegisterModule("myaddon", "actions")

Puis, pour envoyer un log :

VVBS.Logs.Send("myaddon", "actions", {
  action = "ban_player",
  admin = "AdminName",
  player = "PlayerName",
  reason = "RDM"
})

🧱

4. Logs Minecraft (exports)

Depuis un plugin Minecraft (Java), utilisez l'API exportée Flitt :

// Récupère l'instance core Flitt
Plugin flitt = getServer().getPluginManager().getPlugin("Flitt");
if (flitt instanceof fr.flitt.bukkit.FlittBukkitPlugin) {
  fr.flitt.common.FlittPlugin core = ((fr.flitt.bukkit.FlittBukkitPlugin) flitt).getPlugin();

  // Enregistrer une catégorie + sous-catégorie au démarrage
  core.getLogManager().log("custom", "myplugin", "register", "Category registered", "", "");

  // Loguer un événement dans cette catégorie/module (ex: mort d'un joueur)
  core.getLogManager().log("custom", "myplugin", "death", player.getName() + " died", player.getUniqueId().toString(), player.getName());
}

Avec Skript (via Skript-Reflect) :

# Récupère l'instance core Flitt
set {_vvPlugin} to plugin "Flitt"
set {_core} to call method "getPlugin" of {_vvPlugin}
set {_logManager} to call method "getLogManager" of {_core}

# Enregistrer catégorie / sous-catégorie au chargement du script
call method "log" of {_logManager} with arguments "custom", "skript", "register", "Category registered", "", ""

# Loguer un événement dans cette catégorie/module (ex: mort d'un joueur)
call method "log" of {_logManager} with arguments "custom", "skript", "death", "%name of player% died", "%uuid of player%", "%name of player%"

✅

5. Bonnes pratiques

•Enregistrez les catégories/modules une seule fois au démarrage
•Utilisez des noms clairs (ex : economy, actions, staff)
•Évitez d'envoyer des données sensibles

💡

Besoin de plus d'exemples ?

Consultez l'API publique ou les exemples dans les ressources officielles.