Points forts

Un bot utile sur un serveur, avec une base de code propre et une organisation qui tient la route.

Code modulaire

Chaque domaine est isolé dans un module : admin, fun, rôles, vocal. Le noyau se limite à créer le bot, charger les modules, et synchroniser les slash commands.

  • Extensions chargées automatiquement
  • Responsabilités bien séparées
  • Ajout de commandes sans toucher au cœur

Comportements robustes

Les entrées utilisateur sont bornées, les permissions sont vérifiées, et les logs facilitent le diagnostic en cas de problème.

  • purge borné à 200 messages
  • roll borné à 1000 faces
  • Logs formatés (date, niveau, module, message)

Fonctionnalités actuelles

Cette liste correspond exactement aux fonctionnalités présentes dans le code du projet.

Administration

Diagnostic et nettoyage de salon.

  • !ping et /ping
  • !purge et /purge (admin)

Divertissement

Commande simple pour animer un serveur.

  • !roll et /roll

Rôles

Ajout/retrait de rôle à l’auteur (admin).

  • !addrole (admin)
  • !removerole (admin)

Vocal

Connexion/déconnexion en salon vocal.

  • !join
  • !leave

Installer et lancer

Prérequis

  • Python 3.10+ recommandé
  • Dépendances installées via requirements.txt
  • Bot Discord créé via le portail développeur

Démarrage

  1. Installer : pip install -r requirements.txt
  2. Configurer : renseigner le token dans config.json
  3. Lancer : python -m bot

Organisation

bot/
  bot.py            noyau (création, modules, sync slash)
  admin.py          ping, purge (+ slash)
  fun.py            roll (+ slash)
  roles.py          addrole, removerole
  music.py          join, leave
  config.py         lecture/validation config.json
  logging_config.py logs console
  checks.py         check admin réutilisable