Configuration de Red Discord Bot

Ce guide vous explique comment configurer Red Discord Bot sur ServerPrism, de la création du bot dans le portail des développeurs de Discord à la revendication de la propriété et au chargement de vos premiers cogs.

Avant de commencer

Vous aurez besoin d'un compte Discord et d'un serveur où vous avez la permission Gérer le serveur.

1. Créez votre bot dans le portail des développeurs Discord

1. Allez sur discord.com/developers/applications et cliquez sur New Application.
2. Donnez-lui un nom (c'est l'identité de votre bot — choisissez quelque chose qui vous plaît), acceptez les conditions et cliquez sur Create.
3. Dans la barre latérale gauche, cliquez sur Bot.
4. Sous le nom d'utilisateur du bot, cliquez sur Reset Token et copiez le token dans un endroit sûr. Vous le collerez dans ServerPrism dans un instant. Traitez ceci comme un mot de passe — toute personne le possédant peut contrôler votre bot.

2. Activez les Privileged Gateway Intents

Cette étape est critique — Red refusera de démarrer sans que les trois intents soient activés, se terminant par CONFIGURATION_ERROR (code de sortie 78).

Toujours sur la page Bot, faites défiler jusqu'à Privileged Gateway Intents et activez :

• Presence Intent
• Server Members Intent
• Message Content Intent

Cliquez sur Save Changes en bas.

3. Invitez le bot sur votre serveur Discord

1. Dans la barre latérale gauche, cliquez sur OAuth2 → URL Generator.
2. Sous Scopes, cochez bot et applications.commands.
3. Sous Bot Permissions, cochez les permissions que vous souhaitez lui accorder. Pour la plupart des configurations, Administrator est le point de départ le plus simple — vous pourrez le restreindre plus tard.
4. Copiez l'URL générée en bas, ouvrez-la dans un nouvel onglet, choisissez votre serveur Discord et autorisez.

Le bot rejoindra votre serveur mais apparaîtra comme hors ligne jusqu'à ce que vous le démarriez sur ServerPrism.

4. Commandez Red Discord Bot sur ServerPrism

1. Rendez-vous dans la catégorie Discord Bots sur notre site et choisissez le produit Red Discord Bot.
2. Choisissez un plan (1 Go de RAM est suffisant pour la plupart des configurations), choisissez une région proche de vous et passez à la caisse.
3. Lors de la commande, il vous sera demandé :
   • Discord Bot Token — collez le token de l'étape 1.
   • Command Prefix — le caractère que les utilisateurs tapent avant les commandes, par exemple ! ou <. Vous pouvez le modifier plus tard dans Discord.
4. Une fois provisionné, le panel installera Red et démarrera le bot. La première installation prend quelques minutes (installations pip + dépendances).

5. Revendiquez la propriété dans Discord

Lorsque le bot est en ligne, vous devez indiquer à Red qui est son propriétaire afin de pouvoir exécuter les commandes d'administration.

1. Dans Discord, envoyez un message privé à votre bot avec la commande <set owner (remplacez < par votre préfixe).

2. Red affichera un token de confirmation unique dans la console du panel — vous verrez quelque chose comme :

   Use the command [p]set owner XXXXXX in DM to confirm
   

3. Copiez ce token de confirmation depuis la console, puis envoyez un message privé au bot :

   <set owner XXXXXX
   

4. Red répondra "I now recognise you as my owner." C'est fait — les commandes d'administration fonctionnent pour vous maintenant.

6. Chargez vos premiers cogs

Les cogs sont les plugins de Red. Pour activer leur téléchargement et leur installation :

<load downloader
<repo add aikaterna-cogs https://github.com/aikaterna/aikaterna-cogs
<cog install aikaterna-cogs trivia
<load trivia

Parcourez l'index Red Cogs pour des centaines d'autres cogs. Chacun a des instructions d'installation sur sa page.

Problèmes courants

"redbot: command not found" au premier démarrage

L'installateur n'a pas terminé. C'était un bug connu dans notre egg Red qui est maintenant corrigé — si vous le rencontrez lors d'une nouvelle installation, ouvrez un ticket de support et nous réinstallerons l'egg sur votre serveur.

"You need to configure the bot instance using redbot-setup prior to running the bot"

Le fichier de configuration de l'instance est manquant. Même chose que ci-dessus — ouvrez un ticket et nous le corrigerons. La réinstallation du serveur depuis le panel le corrigera également sur les eggs fraîchement déployés.

Code de sortie 78 / "Red requires all Privileged Intents to be enabled"

Retournez à l'étape 2 ci-dessus et activez les trois intents privilégiés dans le Discord Developer Portal. Ils sont désactivés par défaut.

Le bot est en ligne mais ne répond pas aux commandes

Deux causes courantes :

1. Message Content Intent est désactivé — vérifiez à nouveau l'étape 2. Sans cela, le bot ne peut pas voir le texte des messages.
2. Vous utilisez le mauvais préfixe — vérifiez la console de votre panel pour le préfixe avec lequel le bot a démarré, ou utilisez @YourBot prefix dans Discord (mentionner le bot fonctionne toujours quel que soit le préfixe).

Changer le préfixe du bot

<set prefix !

Le nouveau préfixe prend effet immédiatement.

Obtenir de l'aide

Pour les questions spécifiques à Red, la documentation officielle de Red est la meilleure ressource. Pour les questions d'hébergement ServerPrism — facturation, changements de plan, performances — ouvrez un ticket de support et nous vous répondrons.