🛡️ Arès Bot - Bot Discord Modération

Arès est un bot Discord complet et personnalisable spécialement conçu pour les serveurs discord de Faction. Nommé d'après le dieu grec de la guerre, ce bot offre toutes les fonctionnalités nécessaires pour gérer efficacement votre faction.

🚀 Fonctionnalités

📝 Messages de Bienvenue

• Messages de bienvenue personnalisables avec embeds élégants
• Support des mentions et variables dynamiques
• Configuration du salon de bienvenue
• Activation/désactivation facile

🎭 Auto-Rôles

• Attribution automatique de rôles aux nouveaux membres
• Gestion facile des rôles via commandes
• Liste des rôles configurés
• Support de multiples rôles

🎫 Système de Tickets Avancé

• 4 catégories de tickets préconfigurées :
  • ❓ Support - Pour l'aide et le support
  • ⚠️ Report - Pour signaler des problèmes
  • 👥 Recrutement - Pour postuler à la faction
  • 📝 Autre - Pour diverses demandes
• Interface interactive avec boutons
• Limitation du nombre de tickets par utilisateur
• Logs automatiques des tickets créés
• Permissions personnalisées pour les rôles de support

🎮 Gestion du Statut

• Changement automatique du statut toutes les 5 minutes
• Plusieurs types de statuts : playing, watching, listening
• Messages de statut personnalisables
• Rotation automatique des messages

⚙️ Commandes d'Administration

• Commande de shutdown sécurisée
• Permissions basées sur les rôles
• Interface de configuration intuitive
• Vérification des permissions administrateur

📋 Commandes Disponibles

Configuration du Bot

/config                         - Affiche le menu de configuration
/config_welcome #salon           - Configure le salon de bienvenue
/config_welcome true/false       - Active/désactive les messages de bienvenue
/config_autoroles add @rôle      - Ajoute un rôle aux auto-rôles
/config_autoroles remove @rôle   - Retire un rôle des auto-rôles
/config_autoroles list           - Liste les auto-rôles configurés
/config_tickets category #catégorie - Configure la catégorie des tickets
/config_tickets logs #salon      - Configure le salon des logs
/config_tickets support          - Configure le rôle de support
/config_status playing/watching/listening - Change le type de statut
/config_status "message"         - Change le message de statut

Commandes Utilisateurs

/ticket                         - Crée un nouveau ticket
/close                          - Ferme le ticket actuel
/shutdown                       - Arrête le bot (admin uniquement)

🛠️ Installation

Prérequis

• Python 3.8 ou supérieur
• Un token Discord bot

Étapes d'installation

1. Créez un bot Discord

   • Allez sur Discord Developer Portal
   • Créez une nouvelle application
   • Créez un bot dans l'onglet "Bot"
   • Activez les "Privileged Gateway Intents" :
     • SERVER MEMBERS INTENT
     • MESSAGE CONTENT INTENT
   • Copiez le token du bot

2. Invitez le bot sur votre serveur

   • Allez dans "OAuth2" → "URL Generator"
   • Sélectionnez les scopes : bot et applications.commands
   • Sélectionnez les permissions :
     • Administrator
     • Manage Channels
     • Manage Roles
     • Send Messages
     • Embed Links
     • Read Message History
     • Mention Everyone
   • Copiez l'URL générée et invitez le bot

3. Configurez le bot

   • Ouvrez le fichier ares_bot.py
   • Remplacez "VOTRE_TOKEN_ICI" par votre token Discord
   • Personnalisez la configuration si nécessaire

4. Installez les dépendances

   pip install -r requirements.txt

5. Lancez le bot

   python ares_bot.py

⚙️ Configuration Initiale

Une fois le bot démarré, suivez ces étapes pour le configurer :

1. Messages de Bienvenue

/config_welcome #bienvenue        # Configure le salon de bienvenue
/config_welcome true              # Active les messages de bienvenue

2. Auto-Rôles

/config_autoroles add @Membre     # Ajoute un rôle à attribuer automatiquement
/config_autoroles list            # Vérifie les rôles configurés

3. Système de Tickets

/config_tickets category #tickets  # Configure la catégorie pour les tickets
/config_tickets logs #ticket-logs # Configure le salon des logs
/config_tickets support            # Configure le rôle de support

4. Statut du Bot

/config_status playing             # Configure le type de statut
/config_status "Protège Savage"   # Configure le message de statut

🎨 Personnalisation

Messages de Bienvenue

Vous pouvez personnaliser le message de bienvenue en modifiant la section welcome dans la configuration du code :

"message": "🎉 Bienvenue {user} dans la faction **Savage** ! 🎉\n\nNous sommes ravis de t'accueillir parmi nous !"

Variables disponibles :

• {user} - Mention de l'utilisateur
• {username} - Nom d'utilisateur
• {server} - Nom du serveur

Catégories de Tickets

Vous pouvez modifier les catégories de tickets dans la section tickets.categories :

"categories": {
    "support": {
        "name": "Support",
        "emoji": "❓",
        "description": "Besoin d'aide ou de support",
        "color": "#3498DB"
    }
}

Messages de Statut

Personnalisez les messages de statut dans la liste status_messages :

self.status_messages = [
    "Minecraft avec la faction Savage",
    "Protéger la faction Savage ⚔️",
    "Garder le serveur en ordre 🛡️"
]

Configuration via Interface Interactive

Le bot propose désormais des interfaces interactives avec boutons pour faciliter la configuration :

• Utilisez /config pour accéder au menu principal
• Chaque section de configuration propose des boutons pour les actions courantes
• Les modals permettent de saisir des informations complexes comme les rôles ou messages

🔒 Permissions

Permissions Requises pour le Bot

• Administrator - Pour la gestion complète du serveur
• Manage Channels - Pour créer les canaux de tickets
• Manage Roles - Pour gérer les auto-rôles
• Send Messages - Pour envoyer des messages
• Embed Links - Pour les embeds élégants
• Read Message History - Pour la gestion des tickets
• Mention Everyone - Pour les mentions dans les messages de bienvenue

Permissions d'Administration

Les commandes de configuration sont réservées aux utilisateurs ayant :

• Le rôle "Admin", "Modérateur" ou "Fondateur"
• Ou la permission "Administrator" sur Discord

🐛 Dépannage

Problèmes Courants

Le bot ne démarre pas

• Vérifiez que votre token est correct
• Assurez-vous d'avoir installé les dépendances avec pip install -r requirements.txt
• Vérifiez que vous utilisez Python 3.8 ou supérieur

Les commandes ne fonctionnent pas

• Vérifiez que le bot a les permissions nécessaires
• Assurez-vous que les intents sont activés dans le Discord Developer Portal
• Redémarrez le bot après avoir modifié la configuration
• Les commandes slash peuvent prendre quelques minutes pour apparaître après le démarrage du bot
• Si les commandes n'apparaissent pas, essayez de redémarrer le bot ou de synchroniser manuellement les commandes

Le système de tickets ne crée pas de canaux

• Vérifiez que la catégorie des tickets est configurée
• Assurez-vous que le bot a la permission "Manage Channels"
• Vérifiez que la catégorie existe toujours

Les messages de bienvenue ne s'envoient pas

• Vérifiez que le salon de bienvenue est configuré
• Assurez-vous que le bot a la permission "Send Messages" dans ce salon
• Vérifiez que les messages de bienvenue sont activés

📝 Notes

• Le bot est conçu pour être entièrement configurable via les commandes Discord slash (/)
• Toutes les configurations sont stockées en mémoire et seront réinitialisées au redémarrage
• Pour une configuration persistante, vous pouvez modifier directement le code
• Le bot supporte désormais uniquement les commandes slash pour une meilleure expérience utilisateur
• Les tickets sont automatiquement nettoyés lors de la fermeture
• Les commandes slash sont synchronisées automatiquement au démarrage du bot
• Les interfaces interactives avec boutons et modals facilitent la configuration

🤝 Support

Pour obtenir de l'aide ou signaler un bug :

• Créez un ticket sur votre serveur avec le bot
• Contactez le développeur du bot
• Consultez la documentation officielle de discord.py

---

Développé par Roroz
Version 1.5