Roblox

L'installation des plugins est réservée au propriétaire du serveur de jeux.

Guide d'installation et de configuration du plugin QuantumLogs pour Roblox.

Prérequis

HttpService doit être activé : Game Settings > Security > Allow HTTP Requests = ON

Sans HttpService activé, le plugin ne pourra pas envoyer de logs. Assurez-vous de l'activer avant l'installation.

Installation

Avec Rojo (recommandé pour le développement)

Clonez le dépôt du plugin
Placez le dossier QLogs/ dans src/ServerScriptService/
Utilisez rojo serve pour synchroniser avec Roblox Studio

Manuellement

Téléchargez le plugin depuis votre espace client
Dans Roblox Studio, placez le dossier QLogs dans ServerScriptService
Créez un Script dans ServerScriptService :

local QLogs = require(game.ServerScriptService.QLogs)

Configuration

Éditez le fichier QLogs/Config.lua :

local Config = {}

-- URL de votre instance QuantumLogs
Config.API_URL = "https://votre-instance.quantumlogs.cloud/logs"

-- Votre clé API
Config.API_TOKEN = "votre-cle-api-ici"

-- Intervalle d'envoi (en secondes)
Config.SEND_INTERVAL = 10

-- Taille maximum de la file avant envoi forcé
Config.MAX_QUEUE_SIZE = 100

-- Nombre de tentatives en cas d'échec
Config.RETRY_COUNT = 3

-- Délai entre les tentatives (en secondes)
Config.RETRY_DELAY = 5

-- Mode debug
Config.DEBUG = false

return Config

Intégrations disponibles

Configurez les intégrations dans Config.Integrations :

Intégration	Measurement	Description
`PlayerConnection`	`player_connection`	Connexions de joueurs
`PlayerChat`	`player_chat`	Messages du chat
`PlayerDeath`	`player_death`	Morts de joueurs
`MarketplacePurchase`	`marketplace_purchase`	Achats DevProducts et GamePass
`DataStoreError`	`datastore_error`	Erreurs DataStore

Envoyer des logs personnalisés

Vous pouvez envoyer vos propres logs depuis n'importe quel script serveur :

local QLogs = require(game.ServerScriptService.QLogs)

-- Créer un log
local point = QLogs.Protocol.Point("mon_evenement")
    :AddPlayer("player", player)
    :AddField("value", "Description de l'événement")
    :AddTag("categorie", "gameplay")

QLogs.Send(point)

Exemples

Log de transaction en jeu :

local point = QLogs.Protocol.Point("transaction")
    :AddPlayer("player", joueur)
    :AddField("value", joueur.Name .. " a acheté une épée pour 500 coins")

QLogs.Send(point)

Log d'événement admin :

local point = QLogs.Protocol.Point("admin_action")
    :AddPlayer("player", admin)
    :AddPlayer("target", joueurCible)
    :AddField("value", admin.Name .. " a banni " .. joueurCible.Name)

QLogs.Send(point)

Identification du serveur

Le plugin identifie automatiquement le serveur avec le format PlaceId-JobId, permettant de distinguer les logs entre plusieurs serveurs d'un même jeu.

Flush automatique

Les logs en attente sont automatiquement envoyés lorsque le serveur s'arrête, pour éviter toute perte de données.

Vérification

Publiez votre jeu ou testez en Play mode
Vérifiez la console Output pour les messages QLogs (si DEBUG = true)
Connectez-vous au dashboard QuantumLogs pour voir les logs