Mon Bot Discord – Guide d’installation complet

📌 À qui s'adresse ce guide ?
Ce guide est conçu pour une installation locale via Docker sur NAS Synology avec Portainer Community Edition. Une connexion internet est requise uniquement pour le téléchargement de l'image Docker et des dépendances Python lors du premier démarrage.

Dans un précédent article, je vous présentais mon bot, ce compagnon au caractère bien trempé (et un peu déprimé) qui gère mon serveur Discord. Vous avez été nombreux à me demander comment l’installer chez vous pour profiter de ses fonctions de modération, de son système d’XP et de son dashboard local.

Comme je vous l’expliquais, la force de ce projet est qu’il tourne entièrement en local sur mon NAS Synology via Docker. Pas de frais mensuels, pas de données qui partent chez des tiers : c’est votre bot, sur votre machine.

Voici donc le guide complet pour déployer mon bot (que j’appelle affectueusement Marvin OS) sur votre propre infrastructure. »

1.1 Fonctionnalités incluses

🎮 Système XP et niveaux

• Attribution automatique d’XP à chaque message (5 à 10 points, cooldown 40 secondes)
• Montée de niveau automatique avec attribution du rôle Discord correspondant
• Classement mensuel publié le 1er du mois à 9h avec bonus XP pour le podium
• Commande !rang pour consulter son niveau et !top pour le classement

🛡️ Modération automatique

• Filtrage des mots interdits avec suppression automatique du message
• Détection du spam en majuscules et emojis excessifs
• Système d’avertissements progressifs avec logs détaillés
• Anti-raid : ban automatique en cas de spam sur plusieurs salons simultanément
• Nettoyage quotidien des données des membres ayant quitté le serveur

📅 Événements programmés

• Planification de messages automatiques avec date, heure et image optionnelle
• Gestion complète depuis le dashboard sans toucher au code

🎙️ Salons vocaux temporaires

• Création automatique d’un atelier vocal privé en rejoignant le salon Hub
• Suppression automatique du salon quand il est vide

📺 Intégration YouTube

• Surveillance de la chaîne YouTube configurée (vérification toutes les 30 minutes)
• Annonce automatique des nouvelles vidéos dans le salon principal

🏆 Hall of Fame

• Surveillance des réactions sur les créations postées dans le salon dédié
• Publication automatique dans le salon Hall of Fame au dépassement du seuil configuré

⏰ Minuteurs personnels

• Commande !timer pour recevoir un rappel privé après X minutes
• Possibilité d’envoyer un rappel à un autre membre

📢 Messages promotionnels automatiques

• Message personnalisé envoyé automatiquement dans le salon principal
• Planification par jours de la semaine, fréquence et nombre de messages minimum
• Plage horaire restreinte (10h–21h) pour ne pas perturber le serveur

🔐 Dashboard d’administration

• Interface web sécurisée accessible depuis le réseau local
• Système de comptes avec rôles Admin et Modérateur
• Gestion complète de la configuration sans redémarrage
• Sauvegardes automatiques quotidiennes et restauration en un clic
• Wizard de premier démarrage pour une configuration guidée

🤖 Personnalité Marvin (secrets H2G2)

• Réponses automatiques à des mots-clés cachés liés au roman H2G2
• Phrases philosophiques et pessimistes dans son style caractéristique

1.2 Ce dont vous avez besoin

Prérequis	Description
NAS Synology	Avec Docker installé (DSM 7.0+ recommandé)
Portainer CE	Portainer Community Edition installé sur le NAS
Compte Discord	Avec droits administrateur sur votre serveur
Accès réseau local	Pour accéder au dashboard (port 5050)
Connexion internet	Pour le téléchargement initial uniquement

💡 Note sur l'hébergement Marvin OS tourne entièrement en local sur votre NAS. Aucune donnée n'est envoyée vers des serveurs externes hormis les communications nécessaires avec l'API Discord.