Étape 3 : Récupérer le Client ID et générer le Client Secret
Une fois l'application créée, récupérez le Client ID.
Cliquez sur New Secret pour générer le Client Secret.
Étape 4 : Utiliser le Client ID et le Client Secret dans le bot Discord
Dans Discord, tapez les commandes :
!set_api_key twitch_id VOTRE_CLIENT_ID
!set_api_key twitch_secret VOTRE_CLIENT_SECRET
Vous recevrez une confirmation : ✅ Clés API Twitch enregistrées avec succès !
🛡️ Gestion des administrateurs du bot Discord
Qui peut gérer les administrateurs ?
Seul le propriétaire du serveur Discord peut ajouter ou retirer des administrateurs secondaires via les commandes.
Les administrateurs secondaires peuvent ensuite utiliser les commandes du bot réservées aux admins (comme !ask, !search, !youtube, !twitch, etc.).
⚠️ Pour accéder aux outils de gestion du dashboard (interface web), le propriétaire du serveur doit s’enregistrer une seule fois en tant que super admin avec la commande suivante : !superadmin PseudoDiscord
✅ Une fois superadmin, il pourra gérer les autres admins (ajout/retrait) directement depuis le dashboard sans passer par les commandes Discord.
Ajouter un administrateur secondaire
Depuis Discord, tapez la commande suivante :
!addadmin PseudoDeLUtilisateur
Exemple :
!addadmin David
✅ Le membre mentionné sera désormais administrateur et pourra utiliser les commandes admin du bot.
🖥️ Cette action peut également être effectuée via le dashboard (si vous êtes super admin).
Retirer un administrateur secondaire
Depuis Discord, tapez la commande suivante :
!removeadmin PseudoDeLUtilisateur
Exemple :
!removeadmin David
✅ Le membre ne pourra plus utiliser les commandes réservées aux admins.
Afficher la liste des administrateurs secondaires
Depuis Discord, tapez :
!listadmins
📋 Le bot affichera tous les administrateurs secondaires enregistrés pour ce serveur.
Envoyer un message privé à tous les membres (admin only)
Depuis Discord, tapez la commande suivante :
!mpall Votre message ici...
Le bot tentera d’envoyer un message privé à chaque membre du serveur (sauf bots et vous-même) avec 1 seconde de délai entre chaque envoi pour éviter le flood.
Seuls les administrateurs du bot (ajoutés via !addadmin ou !superadmin) peuvent utiliser cette commande.
⚠️ Utilisation à risque :
— N’abusez pas de cette commande : elle peut être considérée comme du spam par Discord et certains membres peuvent avoir bloqué la réception des MP de bots.
— Cette commande est à réserver aux annonces vraiment importantes pour la communauté.
— Discord peut limiter ou bloquer le bot s’il envoie trop de messages privés à la chaîne.
🎮 Créer un Looking For Group (LFG)
Que fait la commande !lfg ?
Elle permet de créer une annonce pour rechercher des joueurs sur un jeu.
Les autres membres peuvent rejoindre le groupe en cliquant sur la réaction ✅.
Le LFG se ferme automatiquement une fois le temps écoulé ou si l'organisateur l'annule.
ModeDeJeu : Le mode spécifique (Exemple : Classé, Ranked, etc. Ce champ peur rester vide mais placer quand meme les " ").
JoueursRecherchés : Le nombre de joueurs que tu recherches (hors toi).
Durée (optionnel) : Combien de temps le LFG reste actif. Format : 2h (heures) ou 30m (minutes). Par défaut : 24 heures.
Exemple :
!lfg "Apex Legends" "Battle Royale" "2" "1h"
Ce qu’il se passe après :
Le bot crée un message interactif dans le salon avec un bouton et la réaction ✅.
Les membres cliquent pour rejoindre. Le message est mis à jour automatiquement.
Le LFG se ferme automatiquement après la durée choisie ou si l'organisateur l'annule.
⚠️ Rappel :
Commande accessible uniquement aux super admin et admin secondaires.
📅 Créer et gérer un Événement
Que fait la commande !event ?
Elle permet d’organiser des événements à une date et heure précise.
Les membres peuvent s’inscrire à l’événement en cliquant sur la réaction ✅.
L’organisateur peut annuler l’événement avec le bouton ❌.
Le bot envoie un rappel automatique 30 minutes avant le début de l’événement à chaque participant.
Une fois terminé, l’événement expire automatiquement et est archivé.
C’est idéal pour organiser des rendez-vous, des tournois, ou des activités communautaires programmées.
🔔 L’heure de l’événement est automatiquement affichée dans le fuseau horaire local de chaque utilisateur grâce à Discord.
Créer un Événement
Commande de base :
!event create "Titre de l'événement" "Description" "YYYY-MM-DD HH:MM" ParticipantsMax
Exemple :
!event create "Tournoi Valorant" "Un tournoi intense en 5v5 pour les meilleurs tireurs !" "2025-04-25 20:00" 10
Explications des paramètres :
Titre de l'événement : Le nom affiché dans l'annonce.
Description : Un résumé ou message expliquant l'événement.
YYYY-MM-DD HH:MM : La date et l’heure de début de l’événement (heure locale du créateur, format 24h).
ParticipantsMax : Le nombre maximum de participants à inscrire.
Affichage intelligent de la date dans Discord :
Le bot utilise le système <t:TIMESTAMP:F> de Discord.
➡️ Chaque utilisateur voit l’heure de l’événement dans son propre fuseau horaire.
Exemple : un événement programmé à 20:00 en France apparaîtra à 14:00 au Québec.
Ce qu’il se passe après :
Le bot publie un message interactif dans le salon où tu exécutes la commande.
Les membres peuvent cliquer sur ✅ pour s’inscrire à l’événement.
L’organisateur (admin) peut annuler l’événement en cliquant sur le bouton ❌.
Fonctionnement de l’Événement :
✅ Chaque participant s’inscrit avec la réaction ✅.
📋 Le bot affiche la liste des participants en temps réel.
🔔 30 minutes avant le début, le bot envoie un message de rappel privé à chaque participant et un message dans le salon.
⏰ 48 heures après la date prévue, l’événement est automatiquement supprimé de la base de données.
⚠️ Rappel :
✅ Seuls les administrateurs peuvent créer des événements avec !event create.
📌 Respecte le format de date/heure : YYYY-MM-DD HH:MM (exemple : 2025-04-25 20:00).
📌 Le nombre de participants est limité par ParticipantsMax ➔ Au-delà, l'inscription est bloquée.
📋 Fonctionnement des Rosters
Qu’est-ce qu’un roster ?
Un roster est une fiche d’organisation d’un groupe (ex : raid MMO, tournoi, etc.).
Chaque roster contient des classes/roles personnalisés définis par l’admin.
Les joueurs s’inscrivent eux-mêmes via un lien public, sans devoir être admin.
Qui peut créer un roster ?
Seuls les administrateurs ou superadmins peuvent créer, déployer ou valider des rosters.
Mais tout le monde peut s'y inscrire une fois le roster actif.
Comment ça fonctionne ?
L’admin crée un modèle de roster dans le dashboard admin (avec ses classes, description, etc.).
Une fois activé, il génère un lien public du style : /dashboard/roster.html?roster_id=...
Les utilisateurs peuvent consulter le lien et cliquer sur une classe pour s’y inscrire.
L’admin peut valider les pré-inscriptions depuis l’interface, ou les retirer.
Quand le roster est finalisé (par l’admin), les inscrits sont définitivement enregistrés.
✉️ Une fois le roster finalisé, chaque participant validé recevra automatiquement un message privé (DM) contenant les détails.
🔒 Assurez-vous d’avoir autorisés les messages privés depuis les membres du serveur pour pouvoir le recevoir.
💸 Transférer des NexusCoins à un autre utilisateur
Utilise la commande !give @pseudo 100 pour transférer des NexusCoins à un autre membre du même serveur Discord.
Le membre doit être présent sur le serveur (en ligne ou non) : il recevra les coins même s’il n’a jamais utilisé le bot.
Le transfert est immédiat et irréversible : vérifie toujours la mention et le montant avant d’envoyer !
Aucun historique de transaction n’est conservé : ces transferts sont anonymes et non traçables après coup.
Si tu tentes d’envoyer plus de coins que tu n’en possèdes, le transfert sera refusé.
Impossible d’envoyer à soi-même ou à un bot.
Exemple : !give @David 500
🎲 Lancer de dés (D&D, jeux de rôle, etc.)
Le bot permet de lancer des dés pour tes parties de jeu de rôle, concours, ou simples décisions aléatoires.
Commande de base : !roll (lance 1d20)
Tu peux personnaliser le lancer :
!roll d6 (lance 1 dé à 6 faces)
!roll d100 (lance 1 dé à 100 faces)
!roll 3d10 (lance 3 dés à 10 faces et affiche la somme)
Jusqu’à 20 dés en une commande (!roll 20d6), chaque dé de 2 à 100 faces.
Résultat affiché à tous dans le salon : pratique pour Donjons & Dragons, Neverwinter Nights, ou simplement se départager au hasard !
Accessible à tous les membres, aucune permission spéciale requise.
🎯 Tirage au sort entre joueurs (!draw)
Le bot permet de tirer au sort un ou plusieurs gagnants parmi les joueurs d’un salon Discord, pour un loot, un giveaway ou toute situation à départager au hasard.
Commande de base : !draw
Tire 1 gagnant aléatoire parmi tous les membres du salon (hors bots).
Tu peux tirer plusieurs gagnants d’un coup :
!draw 3 → 3 gagnants aléatoires dans le salon
Tu peux faire un tirage uniquement entre certains joueurs :
!draw @Pseudo1 @Pseudo2 @Pseudo3 → tire au sort un gagnant parmi ces personnes
!draw 2 @Pseudo1 @Pseudo2 @Pseudo3 → tire au sort 2 gagnants parmi la liste
Limite : 25 participants par tirage.
Les bots ne sont jamais inclus dans le tirage.
Affichage stylé : le bot crée un suspense "3... 2... 1..." avant d’annoncer le résultat dans un embed avec la/les mention(s) du ou des gagnants 🎉
Pratique pour :
Désigner qui reçoit un loot dans un donjon, un event, un jeu de société...
Organiser des giveaways ou des mini-lotteries sur ton serveur Discord.
Départager les joueurs de façon 100% transparente et équitable.
Accessible à tous les membres, aucune permission spéciale requise.
🔐 Qui peut faire quoi ? (Utilisateurs, Admins, Superadmins)
Utilisateur normal
Peut s’inscrire à un roster actif.
Peut participer à un sondage, LFG ou événement.
✅ Est automatiquement enregistré dans la base de données lors de la première interaction.
✅ Peut accéder au dashboard utilisateur pour suivre ses NexusCoins, ses rosters, etc.
Peut utiliser la commande !roll pour lancer des dés (D&D, jeux de rôle, etc.).
Peut transférer des NexusCoins à d'autres utilisateurs présents sur le même serveur Discord grâce à la commande !give.
Administrateur (ajouté via !addadmin)
Peut créer des sondages, LFG et événements.
Peut créer des modèles de roster.
Peut valider des pré-inscrits dans les rosters qu’il gère.
Superadmin (ajouté via !superadmin)
Bénéficie des droits d’admin + accès complet au dashboard admin.
Peut ajouter ou retirer d’autres administrateurs pour un serveur.
Cas particulier : l’utilisateur devient admin
✅ Lorsqu’un membre est promu admin/superadmin, il est automatiquement enregistré en tant qu’utilisateur si ce n’est pas déjà fait.
En résumé : Tout utilisateur qui participe à quelque chose (LFG, sondage, roster...) est enregistré automatiquement dans la base de données, et peut être récompensé !
🔧 Configuration des Permissions du Bot NexusIA
Pour garantir le bon fonctionnement du bot NexusIA sur votre serveur Discord, il est essentiel de lui accorder certaines permissions. Sans ces droits, le bot risque de ne pas pouvoir répondre correctement à vos commandes, gérer les événements ou les sondages.
✅ Permissions Recommandées lors de l’ajout du bot :
📌 Lire les messages
📌 Envoyer des messages
📌 Ajouter des réactions ➔ pour les sondages, LFG et événements
📌 Gérer les messages ➔ pour nettoyer les réactions en double ou supprimer certains messages
📌 Lire l’historique des messages ➔ pour pouvoir modifier les messages envoyés par le bot (ex : LFG / Events)
📌 Intégrer des liens (Embed Links) ➔ pour afficher les messages enrichis (embeds)
📌 Utiliser des emojis externes (facultatif) ➔ si vous souhaitez intégrer des emojis personnalisés dans les réactions
✅ Où donner ces permissions ?
Rendez-vous dans les paramètres de votre serveur ➔ Rôles
Sélectionnez le rôle attribué à NexusIA ou créez-en un dédié pour lui
Vérifiez que ce rôle est positionné assez haut dans la hiérarchie pour s'appliquer correctement
Activez toutes les permissions listées ci-dessus
✅ Permissions par salon (channels) :
Accédez aux Paramètres du canal ➔ Permissions
Ajoutez le bot NexusIA ou son rôle dans la liste des membres avec accès
Donnez-lui au minimum les droits suivants :
Voir les salons
Lire les messages
Envoyer des messages
Ajouter des réactions
Lire l’historique des messages
Gérer les messages
⚠️ Important :
Si le bot ne répond pas dans un salon, pensez à vérifier :
Que le bot a bien le droit d'**envoyer des messages** et **d'ajouter des réactions** dans ce salon
Que les rôles sont bien positionnés dans la hiérarchie
❓ **À noter** :
Si le bot n’a pas la permission d’envoyer des messages dans un salon, **aucun message d’erreur ne s’affichera**.
Pour les utilisateurs, cela donne simplement l’impression que le bot ne fonctionne pas.
Vérifiez toujours les permissions si le bot reste silencieux !
💡 Conseil : Créez un salon dédié aux commandes admin pour les actions comme !lfg et !event.