Ce que vous recevez

L’objet que reçoit run

Lire ne coûte rien

import { command } from 'chapterjs';

export default command({
  name: 'whois',
  description: 'Vous parle de quelqu’un',
  options: {
    who: { type: 'user', description: 'Qui regarder', required: true },
  },
  async run({ interaction, options, guild }) {
    const user = options.who;
    const member = await guild.fetchMember(user);
    const roles = member.roles.map(role => role.name).join(', ') || 'aucun';
    await interaction.reply(
      `${member.displayName} a rejoint ${guild.name} le ${member.joinedAt?.toDateString() ?? 'une date inconnue'}. ` +
        `Rôles : ${roles}. Le plus haut : ${member.highestRole.name}.`
    );
  },
});

• Les propriétés lisent ce que le bot sait déjà. guild.name, member.roles, member.highestRole : aucune requête à Discord, la réponse est immédiate. Le bot se souvient de ses serveurs, de leurs salons et de leurs rôles, parce que Discord les lui a décrits à la connexion et lui envoie chaque changement.
• Les méthodes fetch…() demandent à Discord. guild.fetchMember(user) récupère un membre que le bot ne connaît peut-être pas encore, et await est nécessaire. Le bot répond depuis sa mémoire quand il peut, et demande à Discord sinon.

Les actions : demander à Discord de faire quelque chose

import { command, DiscordApiError } from 'chapterjs';

export default command({
  name: 'warn',
  description: 'Avertit un membre avec une courte exclusion',
  permissions: ['ModerateMembers'],
  options: {
    who: { type: 'user', description: 'Qui avertir', required: true },
    reason: { type: 'string', description: 'Pourquoi', required: true, maxLength: 200 },
  },
  async run({ interaction, options, guild, member }) {
    const target = await guild.fetchMember(options.who);
    if (!member.isHigherThan(target)) {
      await interaction.reply({ content: 'Vous ne pouvez avertir que les membres en dessous de vous.', ephemeral: true });
      return;
    }
    await target.timeout(10 * 60 * 1000, options.reason);
    let told = 'et il a été prévenu en privé';
    try {
      await target.send(`Vous avez reçu un avertissement sur ${guild.name} : ${options.reason}`);
    } catch (error) {
      // 50007 : cette personne n’accepte pas les messages privés.
      if (!(error instanceof DiscordApiError && error.code === 50007)) throw error;
      told = 'mais ses messages privés sont fermés';
    }
    await interaction.reply(`${target.displayName} a reçu un avertissement de 10 minutes, ${told}.`);
  },
});

• permissions: ['ModerateMembers'] dit qui peut utiliser la commande. Discord la cache aux autres, et le framework vérifie à nouveau quand elle est utilisée : quelqu’un sans la permission lit « You need the Moderate Members permission to use this command. » et run ne démarre jamais. Les permissions s’écrivent par leur nom, et l’éditeur les complète.
• member.isHigherThan(target) compare les rôles : Discord refuse de modérer quelqu’un dont le rôle le plus haut est au-dessus du vôtre, alors vérifier d’abord donne une meilleure réponse que de laisser Discord refuser.
• timeout(duration, reason) prend des millisecondes, et une raison qui va dans le journal d’audit du serveur. Les actions qui apparaissent dans le journal d’audit prennent toutes une reason.
• try / catch autour de send(). Certaines personnes ferment leurs messages privés ; Discord refuse alors avec le code 50007. L’erreur est une DiscordApiError, et son code est ce qu’il faut tester : le texte peut changer, le code jamais. Tout le reste est relancé, pour qu’un vrai problème soit signalé.

Les structures que vous rencontrerez

import type { Guild } from 'chapterjs';

async function announce(guild: Guild, text: string) {
  const general = [...guild.channels.values()].find(channel => channel.name === 'general');
  if (general?.isTextBased()) await general.send(text);
}

Les mentions dans un texte

Récapitulatif

• user est le compte, member la personne dans ce serveur, guild le serveur, channel le salon ; sur un serveur, aucun ne manque jamais.
• Une propriété lit ce que le bot sait, immédiatement ; un fetch…() demande à Discord.
• Les actions sont awaitées et peuvent échouer ; DiscordApiError.code dit pourquoi.
• permissions sur une commande décide qui peut l’utiliser, avant run.