~~Barré~~ : fautes
Italique : simple modification pour rendre plus sympa à lire la phrase, ou modif facultative
- En tête
Dans ce premier chapitre nous allons ~~déja~~ déjà mettre en place notre ~~environement~~ environnement de développement, nous allons installer les outils nécessaires pour le développement de notre bot (→ "développer notre bot" (pour éviter la redondance de "développement")) ~~ainci~~ ainsi que le créer et l'inviter sur notre serveur.
- Avant de commencer
-
Ce tutoriel s'adresse à toutes les personnes qui ont ~~déja~~ déjà quelques bases avec le javascript.
-
Tout au long de ce tutoriel**,** je vais vous montrer des exemples de code, vous pourrez les retrouver sur le github de ce tutoriel. Le github contient dans chaque ~~dossiers~~ dossier le code source de chaque chapitre, alors si vous ne comprenez pas quelque chose n'hésitez pas à aller y faire un tour.
- Mise en place de l'environnement
a. Installation de l'IDE
L'ide est un logiciel qui va nous permettre d'écrire des lignes de code. Il en existe différents et il faut choisir celui qui vous convient le mieux. Certains sont payants mais dans ce tutoriel j'utiliserai Visual Studio Code. Vous allez donc pouvoir installer le logiciel depuis le site web code.visualstudio.com. Le bouton d'installation se situe en haut ~~a~~ à droite de l'écran. Ensuite c'est une installation classique, une fois finie vous pouvez le lancer pour vérifier que tous ~~c'est~~ s'est bien passé puis passer ~~a~~ à l'étape suivante.
b. Installation de Nodejs
Nodejs est ce que l'on ~~appel~~ appelle un ~~runetime~~ runtime ?, c'est lui qui va traduire votre code en un langage que la machine pourra comprendre. Vous allez donc pouvoir installer node depuis leur site web officiel nodejs.org. Au milieu**,** de l'écran vous pourrez voir 2 boutons d'installation. Choisissez la version LTS (Long Term Support) qui correspond à la version stable du logiciel (~~assurez vous~~ assurez-vous que c'est au moins 16.6.x). Ensuite vous procéderez ~~a~~ à l'installation, cela peut prendre quelques minutes, si vous ~~appercevez~~ apercevrez des fenêtres ~~apparaitre~~ apparaître ne les fermez pas à la main. Attendez ~~que elles~~ qu'elles se ferment toutes seules. Une fois l'installation finie, vérifiez que tout c'est bien passé en ouvrant un terminal (si vous ne savez pas ce que c'est tapez "powershell" dans la recherche des applications) et tapez "node -v" dans le terminal. Vous devriez voir la version de Nodejs que vous avez installé. Si vous avez une erreur**,** assurez**-**vous de bien fermer le terminal puis de le ~~réouvrir~~ rouvrir.
- Création du bot
[...] si ~~nécésaire~~ nécessaire connectez vous avec votre compte discord. Vous ~~devriz~~ devriez arriver sur une page comme celle-ci :
Une fois sur cette page vous allez voir un bouton "Nouvelle Application" en haut ~~a~~ à droite qui vous permettra de créer votre bot. ~~Choissisez~~ Choisissez un nom qui vous plait et ~~appoyez~~ appuyez sur le bouton "Créer". Vous devriez arriver sur une page comme celle-ci :
Une fois sur cette page vous allez pouvoir changer l'avatar, la description et le nom du bot. Vous pouvez également ajouter des "tags" mais nous aurons l'occasions d'en reparler plus tard. Une fois vos modifications faites, sur le côté gauche allez dans l'onglet "Bot" et cliquez sur le bouton "Créer le bot". Vous devriez voir ~~apparaitre~~ apparaître une page comme celle-ci :
Cliquez sur "Oui" pour confirmer la création de votre bot (avant nous étions sur l'application et une application n'est pas forcément un bot). Vous devriez voir ~~apparaitre~~ apparaître une page comme celle-ci :
En ~~dessendant~~ descendant un peu, vous pouvez ~~appercevoir~~ apercevoir le titre "Intentions de passerelle privilégiée" ("Privileged Gateway Intents" en anglais) avec 3 sous-titres en dessous ("PRESENCE INTENT", "SERVER MEMBERS INTENT", "MESSAGE CONTENT INTENT") en dessous vous trouverez des boutons ~~a~~ à cocher, il faut tous les activer. Je ne vais pas expliquer ici ce que sont les "gateway intents" car nous aurons l'occasion d'en parler dans les prochains chapitres. ~~A~~ À côté de l'avatar de votre bot vous pouvez voir le token avec un bouton "Copier". Gardez bien ~~ca~~ ça en ~~tete~~ tête nous en aurons besoins dans le prochain chapitre.
Et voila ! Notre bot vient d'être ~~crée~~ créé avec toutes les options ~~nécéssaires~~ nécessaires.
- Invitation du bot
Dans cette section j'admets (peut-être plutôt "je pars du principe", même si j'admets est correct dans ce cas, c'est pas courant) que vous avez ~~déja~~ déjà ~~créer~~ créé votre serveur discord. Si vous ne savez pas comment faire je vous laisse ~~conculter~~ consulter ce lien.
Sur la page du panel de ~~gstion~~ gestion de votre bot [...]
Sur le tableau "Scopes" il faut ~~séléctionner~~ sélectionner "bot" et "application.commands" comme ci-dessous :
Notez que a ce moment vous pouvez également ~~séléctionner~~ sélectionner les permissions qui seront demandées lors de l'invitation du bot. Même si ce n'est pas une bonne chose , pour les besoins du tutoriel je vais demander la permission "Administrateur" comme ~~ca~~ ça nous n'aurons jamais de problème avec les permissions.
[...] Vous serez invité ~~a~~ à valider un captcha puis le bot sera sur votre serveur. Une fois cela fait le bot devrait apparaitre dans la liste des membres du serveur avec le statut "offline". Comme sur l'image ci-dessous :
documentation good first issue