Passer au contenu principal
Il vous faut Node.js 24 ou plus récent, une application Discord avec un bot, et un serveur pour tester. Si vous n’avez pas encore l’application, Votre application Discord montre comment en créer une : cela prend deux minutes et vous donne les deux valeurs de l’étape 2.
1

Créer le projet

Lancez la commande de votre gestionnaire de paquets :
Elle vous pose jusqu’à trois questions :
  1. Où créer le projet : un nom de dossier comme my-bot, ou . pour le dossier courant. Le dossier doit être nouveau ou vide.
  2. Quel gestionnaire de paquets utiliser : seuls ceux installés sur votre ordinateur peuvent être choisis, et celui avec lequel vous avez lancé la commande est sélectionné par défaut.
  3. Quel modèle utiliser : minimal, une présence et rien d’autre, est présélectionné. Les autres sont des bots complets : voir Modèles.
Une question qui n’a qu’une réponse possible est sautée : avec un seul gestionnaire de paquets installé, il est utilisé et on vous le dit.Le modèle est copié, les dépendances sont installées, et la suite est affichée.
Passez le nom du dossier pour sauter la première question : pnpm create chapterjs my-bot. pnpm create chapter fait la même chose : c’est un alias court de la même commande.
2

Lui donner votre bot

Dans le nouveau dossier, copiez .env.example vers .env et remplissez les deux valeurs :
.env
  • BOT_TOKEN : le token de votre bot, depuis la page Bot de votre application dans le Developer Portal. Utilisez une application de dev, pas celle qui sera en ligne pour tout le monde : voir Votre application Discord.
  • DEV_GUILD_ID : l’identifiant de votre serveur de test.
Où trouver les deux est expliqué dans Votre application Discord.
Votre token est un mot de passe : ne le partagez jamais, et ne commitez jamais .env. Le projet l’ignore déjà dans git.
3

Le lancer

Votre bot se connecte à votre serveur de test :
La présence est le seul fichier du modèle, src/presence.ts : ce que Discord affiche sous le nom de votre bot.Si le bot n’est pas encore dans votre serveur de test, la commande affiche un lien qui l’y ajoute et vous attend. Si un de vos fichiers a besoin d’une option qui n’est pas activée pour votre bot, elle dit laquelle et où l’activer, et attend aussi. Chaque message dit quoi faire : voir chapterjs dev.
4

Essayer votre première commande

Créez un fichier pour votre première commande, src/commands/ping.ts :
src/commands/ping.ts
Enregistrez-le : le fichier est chargé, et la commande envoyée à votre serveur de test :
Tapez /ping sur votre serveur de test : le bot répond « Pong ! ». Changez la réponse, enregistrez, et utilisez à nouveau /ping : elle répond avec le nouveau texte.
C’est tout. name est le nom de la commande, 'ping' est /ping, et rien ne l’enregistre. ChapterJS trouve la déclaration dans vos fichiers, présente la commande à Discord et lance run quand quelqu’un l’utilise. Pour ajouter une commande, déclarez-en une avec command() et exportez-la, dans n’importe quel fichier de src/. Pour réagir à quelque chose qui se passe sur Discord, déclarez un event() de la même façon. Comment le framework les trouve est dans Structure du projet. Quand votre bot est prêt pour tout le monde, mettez-le sur une machine qui reste allumée : voir Déployer.
Tout ce que fait la commande chapterjs est dans la référence du CLI.

Structure du projet

À quoi sert chaque dossier et fichier de votre projet.

Commandes

Une commande slash, options typées pour vous.