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

Téléchargez QuantumLogs.cs depuis votre espace client
Copiez le fichier dans le dossier plugins de votre serveur :
```
/chemin/vers/rust/server/oxide/plugins/QuantumLogs.cs
```
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

Chargez le plugin sur votre serveur
Vérifiez dans la console serveur qu'il n'y a pas d'erreur
Utilisez /qlogs test en jeu pour envoyer un log de test
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.