Événements

import { event } from 'chapterjs';

export default event({
  name: 'memberJoin',
  async run({ member, guild }) {
    await member.send(`Bienvenue sur ${guild.name}, ${member.displayName} !`);
  },
});

Le nom est l’événement

• name est l’événement. C’est l’un des événements, et votre éditeur les propose pendant que vous tapez ; un autre mot est souligné, et signalé avec le nom d’événement le plus proche quand le fichier se charge.
• Une déclaration est une réaction. L’endroit du fichier et son nom sont à vous : src/events/welcome.ts, ou src/welcome/welcome.ts, ou src/welcome.ts, ou à côté de la commande qu’il accompagne, comme le fait le modèle tickets. Déclarez-en autant que vous voulez, dans un fichier ou plusieurs : elles tournent toutes.
• L’import est le même partout. name est ce qui dit à event ce que reçoit votre fonction : un membre pour 'memberJoin', un rôle pour 'roleDelete'. La même ligne, import { event } from 'chapterjs', fonctionne dans chaque fichier.

Plusieurs réactions à un événement

import { event } from 'chapterjs';

export default event({
  name: 'memberJoin',
  async run({ member, guild }) {
    const role = [...guild.roles.values()].find(role => role.name === 'Newcomer');
    if (!role) return;
    await member.addRole(role, 'Vient d’arriver');
    await member.send(`Vous avez maintenant le rôle ${role.name}.`);
  },
});

Ce qui ne manque jamais

• member.guild, role.guild, channel.guild pour un salon de serveur, member.highestRole ;
• guild.me (votre bot en tant que membre du serveur), guild.everyoneRole ;
• message.guild, message.member et message.channel dans les événements sur les messages.

Ce qui a été supprimé

• roleDelete : role est toujours là, le bot connaît chaque rôle de ses serveurs.
• channelDelete : channel est le salon ou le fil tel qu’il était.
• guildLeave : guild est le serveur tel qu’il était.
• memberLeave : user est le compte de la personne partie, toujours là.

import { event } from 'chapterjs';

export default event({
  name: 'memberLeave',
  async run({ user, guild }) {
    const channel = guild.systemChannelId ? guild.channels.get(guild.systemChannelId) : undefined;
    if (!channel || !channel.isTextBased()) return;
    const name = user.displayName;
    await channel.send(`${name} a quitté ${guild.name}.`);
  },
});

L’événement ready

import { event } from 'chapterjs';

export default event({
  name: 'ready',
  run({ user, guilds }) {
    console.log(`${user.username} est en ligne sur ${guilds.size} serveur(s)`);
  },
});

Options

import { event } from 'chapterjs';

export default event({
  name: 'messageCreate',
  bots: true,
  run({ message }) {
    console.log(`${message.author.username}: ${message.content}`);
  },
});

Intents : rien à lister

ℹ Intents computed from your files: GUILDS, GUILD_MEMBERS

↻ Your files now need more from Discord (GUILD_MESSAGES, MESSAGE_CONTENT): reconnecting...

⚠ Your files need an option that is not enabled for your bot:
  - Server Members Intent, needed by src/events/welcome.ts
  Enable it under "Privileged Gateway Intents", then save:
  https://discord.com/developers/applications/123456789012345678/bot
  Waiting for you to enable it...
✓ Privileged intents enabled

Quand votre fonction échoue

✗ src/events/welcome.ts:4 Discord refused POST /channels/{channel.id}/messages: Cannot send messages to this user (50007)

En dev, seulement votre serveur de test

Toutes les sortes d’événements

• Aux messages : envoyés, modifiés, supprimés. Voir Messages.
• Aux réactions, aux sondages et à la saisie : une réaction ajoutée ou retirée, un vote, quelqu’un qui écrit. Voir Réactions, sondages et saisie.
• Au vocal : quelqu’un qui rejoint, quitte, change de salon, coupe son micro ou lance un stream. Voir Vocal.
• À la modération et au serveur : bannissements, journal d’audit, invitations, emojis, événements programmés, qui est dans un fil, présences. Voir Modération et serveur.