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)

1. Clonez le dépôt du plugin

2. Placez le dossier QLogs/ dans src/ServerScriptService/

3. Utilisez rojo serve pour synchroniser avec Roblox Studio

Manuellement

1. Téléchargez le plugin depuis votre espace client

2. Dans Roblox Studio, placez le dossier QLogs dans ServerScriptService

3. 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

1. Publiez votre jeu ou testez en Play mode

2. Vérifiez la console Output pour les messages QLogs (si DEBUG = true)

3. Connectez-vous au dashboard QuantumLogs pour voir les logs