Rust

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 Rust (Oxide/uMod).

Prérequis

• Serveur Rust avec Oxide ou uMod installé

Installation

1. Téléchargez QuantumLogs.cs depuis votre espace client

2. Copiez le fichier dans le dossier plugins de votre serveur :

   /chemin/vers/rust/server/oxide/plugins/QuantumLogs.cs

3. Le plugin se charge automatiquement. Sinon, utilisez la commande :

   oxide.reload QuantumLogs

Configuration

Le fichier de configuration est généré automatiquement au premier chargement dans :

oxide/config/QuantumLogs.json

{
  "API URL": "https://votre-instance.quantumlogs.cloud/logs",
  "API Token": "votre-cle-api-ici",
  "Send Interval (seconds)": 10.0,
  "Max Queue Size": 1000,
  "Debug Mode": false,
  "Integrations": {
    "Player Connection": true,
    "Player Disconnection": true,
    "Player Kill": true,
    "Player Death": true,
    "Player Chat": true,
    "Player Respawn": true,
    "Player Wounded": true
  }
}

Intégrations disponibles

Intégration	Measurement	Description
Player Connection	player_connection	Connexions de joueurs
Player Disconnection	player_disconnection	Déconnexions
Player Kill	player_kill	Kills PvP (arme, distance, partie du corps)
Player Death	player_death	Morts PvE et suicides
Player Chat	player_chat	Messages du chat
Player Respawn	player_respawn	Réapparitions
Player Wounded	player_wounded	Joueur blessé

Détails des kills

Les logs de kills incluent automatiquement :

• Arme utilisée

• Distance du tir

• Partie du corps touchée (tête, torse, jambes, etc.)

• Steam ID de l'attaquant et de la victime

Commandes

Commandes chat (en jeu)

Commande	Description
/qlogs	Affiche l'aide
/qlogs status	Affiche l'état du plugin et la file d'attente
/qlogs flush	Force l'envoi des logs en attente
/qlogs test	Envoie un log de test

Commandes console (RCON)

Commande	Description
qlogs.status	État du plugin
qlogs.flush	Envoi forcé

API pour d'autres plugins

D'autres plugins Oxide peuvent envoyer des logs via QuantumLogs :

// Envoyer un log personnalisé
var tags = new Dictionary<string, string>
{
    { "player_name", player.displayName },
    { "player_global_id", player.UserIDString }
};

var fields = new Dictionary<string, object>
{
    { "value", "Description de l'événement" }
};

Interface.CallHook("SendCustomLog", "mon_evenement", tags, fields);

// Vérifier la taille de la file d'attente
int queueSize = (int)Interface.CallHook("GetQueueSize");

// Forcer l'envoi
Interface.CallHook("FlushLogs");

Vérification

1. Chargez le plugin sur votre serveur

2. Vérifiez dans la console serveur qu'il n'y a pas d'erreur

3. Utilisez /qlogs test en jeu pour envoyer un log de test

4. Vérifiez dans le dashboard QuantumLogs que le log apparaît

Activez "Debug Mode": true dans la configuration pour voir les messages détaillés dans la console du serveur.