Description

Notre module de notification Twitch est conçu pour offrir aux membres de votre communauté une expérience de suivi de stream avancée, interactive et automatisée sur Discord !

🔄 Fonctionnement en trois étapes

1. Détection du lancement du live

Dès que le live commence, le module crée automatiquement une notification dans le serveur Discord en récupérant l’image de début de live configurée au préalable et en créant un ping vers le rôle configuré, affichant un aperçu dynamique et toutes les informations utiles du stream (nombre de viewers 👀 & heure de début ⏰).


2. Mise à jour automatique des données

Chaque minute ⏱️, le module analyse en temps réel l’évolution du live : il met à jour le message Discord avec les nouvelles statistiques 📈 (nombre de viewers 🎉 & une capture d’écran du stream 📸).

Les membres disposent ainsi d’informations fraîches s’ils viennent plus tard voir la notification. Cela permet d’être sur que le streamer est toujours en live si la lecture de la notification se fait plus tard !


3. Gestion des coupures et fin de live

Si le live subit une coupure 🔌, le module vérifie durant 10 minutes ⏳ si la coupure est temporaire (perte de connexion, redémarrage…).

• 🟢 Si le live redémarre, la notification repasse en vert (live actif) ✅
• 🔴 Sinon, après ce délai, le message passe en rouge, considéré comme une fin de live, et toutes les statistiques finales sont affichées : heure de début, heure de fin, la durée du stream, le pic de viewer & le nombre de nouveaux followers (L’image de fin de live configurée au préalable sera affichée) 📋

• 🟠 Pendant la coupure, le statut est signalé en orange sur le message afin de prévenir toute anomalie ⚠️

✨ Avantages du système

• 👁️ Visibilité en temps réel de l’activité du streamer directement sur Discord
• 🎨 Engagement renforcé de la communauté grâce à des notifications dynamiques et illustrées
• 📚 Historique automatique : tout le fil d’un live (statistiques, évolution) est archivé en un seul message Discord, à chaque stream 🗂️
• 🔄 Mise à jour d’un salon vocal afin d’afficher le nombre de followers de la chaîne Twitch lors du lancement du live et lors de sa fermeture

Avec ce module, chaque live Twitch devient un événement interactif 🎊 parfaitement intégré à votre serveur Discord, sans gestion manuelle 🤖, pour une ambiance plus vivante et un reporting complet à chaque diffusion ! 🎉🔥

❗ Important

• Le module n’est pas fonctionel en téléchargeant uniquement les fichiers, il doit être intégré dans un bot Discord déjà fonctionnel
• Nous utilisons Prisma comme ORM pour la gestion de la base de données, assurez-vous que votre projet utilise également Prisma ou adaptez le code en conséquence

⚠️ Prérequis

• Un bot Discord fonctionnel avec les permissions nécessaires pour enregistrer des commandes slash
• Vous devez avoir des connaissances en développement de bot Discord (Javascript) & en gestion de bases de données pour utiliser ce script afin de pouvoir l’adapter à vos besoins

Fichiers/dossiers

• Dossierimages

  • Dossierscreen-live/ Contient les images du streams temporaires

    • …
  • offline.png
  • online.png
• Dossierprisma

  • schema.prisma Modèle de données pour le module (Prisma)
• Dossierutils

  • Dossiernotification

    • twitch.js Les fonctions utilisées pour gérer les notifications du module
  • environment.js Fonction utilitaire pour l’écriture d’une variable dans le fichier .env
  • utils.js Les fonctions réutilisables
• .env Variables d’environnement nécessaires
• index.js Point d’entrée du script
• package.json Dépendances nécessaires

Dépendances & Versions

Voici les versions utilisées pour le développement et test du script :

• @prisma/client@6.18.0
• discord.js@14.24.0
• dotenv@16.6.1
• moment@2.30.1
• fs@0.0.2
• axios@0.26.1
• uuid-js@0.7.5
• utf8@3.0.0