egg-shen-bot

Egg Shen Bot est un bot Discord auto-hébergeable riche en fonctionnalités, axé sur la découverte de divertissements et les activités communautaires. Il recherche dans sept types de médias — films, séries télévisées, épisodes, jeux vidéo, jeux de société et livres — renvoyant des embeds riches avec des synopsis et des notes agrégés de plusieurs sources, ainsi que des liens vers la page de chaque service pour le média. Les sources de notes/liens nommées incluent IMDb, Letterboxd, Trakt, Rotten Tomatoes et JustWatch, avec la disponibilité du streaming gérée via l'intégration TMDB et Watchmode. Au-delà de la recherche, le bot propose un système de tournoi à élimination directe prenant en charge des phases de groupes de 4 à 12 groupes, des repêchages et des tours à élimination directe. Les outils de soirée de visionnage incluent des minuteurs, un historique de visionnage et des statistiques de serveur, ainsi qu'une commande d'annonce. Les fonctionnalités sociales incluent des sondages interactifs, une recherche de bande sonore, une commande « potion magique » et une génération d'images IA optionnelle. Une fonctionnalité optionnelle de demandes d'événements permet aux membres de la communauté de soumettre des demandes de soirée de visionnage via un formulaire web utilisant Discord OAuth ; les modérateurs les approuvent ou les refusent, et les événements approuvés sont créés en tant qu'événements planifiés Discord. La gestion du serveur couvre des permissions configurables, l'activation/désactivation des services de notation, les préférences régionales et les emojis personnalisés via une commande de configuration, ainsi que des commandes de modération pour le redémarrage et les statistiques. Le projet documente la limitation de débit intégrée comme protection des coûts, les notifications/rappels et les statistiques d'utilisation. Le déploiement est auto-hébergé : chaque instance est indépendante, utilisant sa propre application Discord, son propre serveur et ses propres fichiers de données locaux pour les paramètres, les minuteurs et les tournois, sans backend partagé ni compte central. Les prérequis sont Node.js 20 ou supérieur, un jeton de bot Discord et une clé API TMDB, avec des clés optionnelles pour Watchmode, OMDb, Trakt, RAWG, Google Books et OpenAI. La configuration implique de cloner le dépôt, d'installer les dépendances, de configurer un fichier .env, de déployer les commandes slash et de démarrer le bot. La base de code est organisée pour l'extension sous src/commands, src/services, src/utils, public (formulaire web de demande d'événement) et docs (documentation VitePress), et est publiée sous la licence MIT.