Passer au contenu principal
Trois outils suffisent pour écrire un bot : Node.js pour exécuter votre code, un gestionnaire de paquets pour installer ChapterJS, et un éditeur. Cette page s’assure que vous les avez, et montre les quelques commandes de terminal dont le reste du tutoriel se sert.

Le terminal

Tout ce qui fait tourner votre bot se lance depuis un terminal : une fenêtre où vous tapez une commande et lisez sa réponse. Sur macOS, c’est l’app Terminal ; sur Windows, Windows Terminal ou PowerShell ; sur Linux, ce que votre système appelle ainsi. Votre éditeur en a aussi un intégré, et c’est l’endroit le plus pratique. Deux choses à savoir :
  • Un terminal est toujours « dans » un dossier. cd my-bot entre dans le dossier my-bot ; les commandes de ce tutoriel se lancent depuis le dossier de votre projet.
  • Un programme qui continue de tourner (comme votre bot) occupe le terminal. Ctrl+C l’arrête.

Node.js

Node.js est ce qui exécute JavaScript en dehors d’un navigateur. ChapterJS a besoin de la version 24 ou plus récente : il s’appuie sur la capacité de Node à exécuter directement des fichiers TypeScript, et il suit les versions récentes de Node. Avec une version plus ancienne, ChapterJS s’arrête tout de suite et dit quoi installer. Installez-le depuis nodejs.org (la version LTS convient si elle est en 24 ou plus), puis vérifiez dans un terminal :
Il affiche quelque chose comme v24.11.1. S’il affiche une version plus basse, ou « command not found », réinstallez-le et ouvrez un nouveau terminal : un terminal ouvert avant l’installation ne le voit pas.

Un gestionnaire de paquets

Un gestionnaire de paquets télécharge les paquets dont dépend votre projet (ici, chapterjs) et lance les scripts de votre projet (dev, build, start). Node est fourni avec npm. Les autres, pnpm, yarn et bun, font la même chose avec de petites différences de vitesse et de façon de stocker les paquets. Choisissez-en un ; pnpm est celui qu’utilise l’équipe de ChapterJS. Vérifiez celui que vous avez choisi :
Si pnpm n’est pas installé, corepack enable pnpm l’active, puisqu’il est fourni avec Node ; ou suivez pnpm.io.
Tenez-vous à un seul gestionnaire de paquets par projet. Chacun garde son propre fichier de verrouillage (pnpm-lock.yaml, package-lock.json…), et en utiliser deux à tour de rôle les laisse en désaccord, avec des erreurs difficiles à comprendre.

Un éditeur

N’importe quel éditeur qui comprend TypeScript fait l’affaire, et Visual Studio Code le fait sans rien installer de plus. L’éditeur compte plus que d’habitude avec ChapterJS : le framework génère les types de votre projet, et l’éditeur les lit pour compléter ce que vous tapez et souligner une erreur avant que vous n’exécutiez quoi que ce soit. C’est de là que vient une grande partie de l’aide, alors prenez le temps d’ouvrir votre projet dedans plutôt que dans un éditeur de texte simple.

Un compte Discord et un serveur pour tester

Il vous faut un compte Discord et un serveur où vous avez le droit d’ajouter un bot (n’importe quel serveur que vous avez créé convient). Créez-en un pour votre bot si vous n’en avez pas : un serveur de test est un terrain de jeu où les erreurs ne dérangent personne. Dans Discord, cliquez sur le + en bas de la liste des serveurs et choisissez Créer le mien.

Récapitulatif

  • node --version affiche 24 ou plus.
  • Un gestionnaire de paquets, vérifié avec --version, et gardé pour tout le projet.
  • Un éditeur qui comprend TypeScript, Visual Studio Code par exemple.
  • Un compte Discord et un serveur de test que vous gérez.

Votre application Discord

Créer le compte bot dans le Developer Portal.

Créer le projet

Une commande, deux valeurs, et votre bot est en ligne.