Configuration initiale
Ce guide s'adresse aux propriétaires qui configurent une nouvelle instance QuantumLogs.
1. Récupérer votre clé API
Votre clé API est nécessaire pour que vos serveurs de jeux puissent envoyer des logs à QuantumLogs. Vous la trouverez dans les paramètres de votre instance sur le portail de facturation, onglet API Info :
Ne partagez jamais votre clé API publiquement. Toute personne possédant cette clé peut injecter des logs dans votre instance.
2. Inviter le bot QuantumLogs
Pour que QuantumLogs puisse vérifier les rôles Discord de vos membres, vous devez inviter le bot officiel sur votre serveur Discord.
Le bot n'a besoin d'aucune permission particulière. Il sert uniquement à vérifier que les membres possèdent bien le rôle requis. Il ne lit pas les messages, ne modère pas, et n'interagit pas avec votre serveur.
Sans le bot, seul le propriétaire pourra se connecter au dashboard. Le bot est nécessaire pour la vérification des rôles.
3. Configurer les rôles Discord
Connectez-vous à votre dashboard en tant que propriétaire, puis allez dans Administration > Extensions > Discord Authentication :
| Champ | Description |
|---|---|
| Guild ID | L'ID de votre serveur Discord (pour restreindre l'accès aux membres) |
| Required Role ID | L'ID du rôle requis pour accéder au dashboard |
| Admin Role ID | L'ID du rôle admin (bypass des restrictions par extension) |
Voir Rôles et permissions pour la configuration complète.
4. Installer le plugin sur votre serveur de jeux
Selon votre jeu, installez le plugin correspondant :
| Jeu | Guide d'installation |
|---|---|
| Garry's Mod (Lua) | Guide GMod |
| Garry's Mod (DLL) | Guide GMod DLL |
| Roblox | Guide Roblox |
| Rust | Guide Rust |
| Autres jeux | API REST générique |
5. Activer les extensions
Rendez-vous dans Administration > Extensions pour activer les modules dont vous avez besoin :
- Analytics, Alerting, GameDig, Loading Screen, etc.
Voir Gérer les extensions pour plus de détails.
Vérification
Une fois la configuration terminée, vérifiez que :
- Vous pouvez vous connecter au dashboard via Discord
- Le bot QuantumLogs est présent sur votre serveur Discord
- Votre serveur de jeux envoie des logs (vérifiez dans la page Logs)
- Les membres de votre staff peuvent se connecter avec le bon rôle
- Les extensions souhaitées sont activées