Installation

Suivez ces étapes pour installer correctement le script sur votre bot.

Attention

Ces instructions supposent que vous avez déjà un bot Discord fonctionnel et que vous savez comment ajouter des scripts à votre bot.

Étapes d’installation

1. Téléchargez le module & décompresser le dossier

   Récupérez le dossier du module (souvent au format .zip ou .rar) depuis la source officielle. Utilisez un outil comme WinRAR ou 7-Zip pour extraire le dossier du script sur votre ordinateur.

2. Configurez les variables d’environnement

   Ouvrez le fichier .env fourni avec le script et ajoutez & modifiez les variables d’environnement nécessaires au votre pour le bon fonctionnement du module.

   • guildID : ID du serveur Discord où le bot est déployé
   • animationRoleWinnerAnimationID : ID du rôle des gagnants d’événements
   • animationChannelEventID : ID du salon où les messages d’animation seront envoyés

3. Copier/déplacer les fichiers/les codes dans votre projet

   Copiez les fichiers suivants dans le(s) dossier(s) approprié(s) de votre projet bot Discord :

   • commands/animation-add.js : dans le dossier de vos commandes slash
   • commands/animation-list.js : dans le dossier de vos commandes slash
   • commands/animation-remove.js : dans le dossier de vos commandes slash
   • commands/animation-message.js : dans le dossier de vos commandes slash
   • events/interactionCreate.js : copier la partie utile du code de ce fichier pour l’encoder dans le vôtre
   • utils/arguments/post-message.js : dans le dossier de vos utilitaires
   • utils/animation.js : dans le dossier de vos utilitaires

   Copiez également le code d’indexation du module dans votre fichier index.js principal. Dans ce fichier, nous avons ajouté prisma directement lié à l’objet “client”, mettez ce code dans le vôtre ou ajuster le selon votre façon d’utiliser prisma.

4. Mettez à jour le schéma de la base de données

   Ajoutez le modèle de données pour les animations dans votre fichier prisma/schema.prisma et exécutez les migrations nécessaires pour appliquer les changements à votre base de données. Exécution de la commande suivante :

   npx prisma generate
   
   npx prisma migrate dev --name add_animation_model

5. Installez les dépendances

   Assurez-vous que les dépendances nécessaires sont installées en vérifiant votre package.json et en exécutant :

   npm install

6. Redémarrez le bot

   Redémarrez votre bot pour que le script soit pris en compte.

Modifier les permissions des commandes

Accédez à votre serveur, puis allez dans Paramètres du serveur > Intégrations. Dans la section Bots et applications, cliquez sur votre bot.

Dans l’onglet Commandes, vous pouvez ajouter des dérogations pour gérer les permissions des différentes commandes ajoutées par notre module.

Si vous ne configurez pas ces permissions, tous les membres de votre serveur auront accès aux commandes du module.

Conseils

• Testez les commandes slash /animation-add, /animation-list, /animation-remove, /animation-message dans un serveur de test avant de la déployer en production.
• Dans le fichier index.js, vous pouvez modifier la planification de la suppression du rôle “Gagnant des événements” selon vos besoins. (Actuellement, elle est configurée pour s’exécuter tous les jours à 23h59).