📖 Wiki & Guide d'Utilisation

Tout ce que vous devez savoir pour maîtriser VirtuBot

🚀 Guide de Démarrage Rapide

1. Configuration Initiale du Bot

  • Inviter le bot : Utilisez le lien d'invitation fourni sur le Discord
  • Permissions requises : Administrateur recommandé (ou Gérer serveur, Bannir, Expulser, Gérer messages, Gérer rôles)
  • Intents activés : Membres, Présences, Contenu des messages (déjà configuré)

2. Configuration du Système de Tickets

  • Créez une catégorie "Tickets" pour les tickets actifs
  • Créez une catégorie "Archives" pour les tickets fermés (optionnel)
  • Créez un salon texte où les utilisateurs créeront les tickets
  • Utilisez /setup_ticket #salon @catégorie [#archives]
  • Ajoutez des rôles de support avec /ticket_support_roles add @rôle

3. Accéder au Panel Web

  • Cliquez sur le bouton "Se connecter" ou "Connexion au Panel"
  • Authentifiez-vous avec votre compte Discord
  • Accédez au dashboard avec statistiques, logs et configurations
  • Gérez tous vos serveurs depuis une interface unique

4. Utiliser les Commandes

  • Tapez / dans Discord pour voir toutes les commandes disponibles
  • Les commandes de modération nécessitent les permissions appropriées
  • Les jeux sont accessibles à tous les membres
  • Consultez la page Commandes pour plus de détails

❓ Questions Fréquentes (FAQ)

Q : Comment fonctionne la blacklist persistante ?

R : Lorsque vous blacklistez un utilisateur avec /blacklist <user_id>, il est automatiquement banni. Même si un administrateur le débannit manuellement, il sera instantanément rebanni dès qu'il essaiera de rejoindre le serveur à nouveau. Cela protège contre les raids persistants.

Q : Comment gérer les tickets avec plusieurs staffs ?

R : Utilisez les boutons Claim pour revendiquer un ticket, Join pour qu'un autre staff rejoigne, et Transfer pour transférer à quelqu'un d'autre. Le canal staff séparé permet à l'équipe de coordonner sans que l'utilisateur voie.

Q : Que faire si j'obtiens un code d'erreur ?

R :Contactez le support Discord.

Q : Le bot peut-il fonctionner 24/7 ?

R : Oui, VirtuBot est conçu pour rester en ligne et limiter les pannes. Il dispose d'une reconnexion automatique en cas de coupure Discord, d'une gestion d'erreurs robuste et d'un monitoring continu. L'hébergeur du bot est sur.

Q : Puis-je personnaliser les couleurs des embeds ?

R : Oui ! Utilisez /sayembed <titre> <description> <couleur> avec un code hexadécimal (ex: #5865F2) ou un nom de couleur (red, blue, green, etc.). Les embeds du bot peuvent être personnalisés via le fichier de configuration JSON.

💡 Bonnes Pratiques & Conseils

Modération

  • Toujours fournir une raison claire lors d'un kick/ban pour la traçabilité
  • Utiliser la blacklist uniquement pour les raiders/spammeurs persistants
  • Préférer timeout pour les infractions mineures avant un ban définitif
  • Vérifier les logs régulièrement dans le panel pour surveiller l'activité

Système de Tickets

  • Configurer au moins 2-3 rôles de support pour éviter la surcharge
  • Utiliser les priorités pour traiter les tickets urgents en premier
  • Activer l'archivage automatique pour garder l'historique propre
  • Former les staffs à utiliser Claim avant de répondre pour éviter les doublons

Utilisation du Panel

  • Consulter le dashboard quotidiennement pour suivre l'activité
  • Exporter les logs en CSV mensuellement pour archivage
  • Vérifier les codes d'erreur pour identifier les problèmes récurrents
  • Utiliser les graphiques pour analyser les pics d'utilisation

Configuration Optimale

  • Créer des catégories dédiées pour tickets et archives séparées
  • Limiter les permissions des commandes sensibles aux modérateurs+
  • Sauvegarder les fichiers JSON de configuration régulièrement
  • Tester les commandes en salon privé avant déploiement public

🔧 Dépannage & Résolution de Problèmes

Le bot ne répond pas aux commandes

Solutions :

  • Vérifiez que le bot est en ligne (pastille verte sur Discord)
  • Assurez-vous d'utiliser / pour les Slash Commands, pas !
  • Vérifiez les permissions du bot sur le serveur et dans le salon
  • Consultez le panel pour voir s'il y a des erreurs récentes

Erreur "Permissions insuffisantes" (ERR_PERMS)

Solutions :

  • Vérifiez que votre rôle a les permissions requises pour la commande
  • Vérifiez que le rôle du bot est au-dessus des rôles qu'il doit gérer
  • Donnez au bot les permissions : Gérer messages, Bannir, Expulser, Gérer rôles
  • Essayez de réinviter le bot avec le bon lien d'invitation

Les tickets ne se créent pas

Solutions :

  • Vérifiez que vous avez exécuté /setup_ticket correctement
  • Assurez-vous que le bot peut créer des salons dans la catégorie
  • Vérifiez les permissions du bot sur la catégorie (Gérer salons, Voir salon)
  • Essayez de reconfigurer le système avec une nouvelle catégorie

Besoin d'aide supplémentaire ?

Notre équipe de support est là pour vous aider sur Discord