# Installer le bot sur ton serveur Discord

> Canal public — documentation de l’application 3.6.3. Respecter les mentions de disponibilité propres à chaque service.

Source : [Installer le bot sur ton serveur Discord](/services/discord-du-jeu/installer-le-bot/)

Bientôt

L’autorisation se donne sur Discord, puis se confirme sur une page VibeStarter.

L’installation part de l’application, passe par Discord, sur l’écran de consentement habituel des applications, et se termine sur une page de confirmation VibeStarter. Ce parcours dans l’application ne conserve pas les jetons OAuth de ton compte Discord. La connexion au futur tableau de bord web utilisera une session distincte, limitée à une heure, avec un jeton Discord conservé chiffré pour vérifier tes droits. L’association entre ton jeu et ton serveur, les réglages et les informations nécessaires au fonctionnement du bot sont conservés selon sa politique de confidentialité.

## Liens du bot

Le lien permanent [Installer le bot sur votre serveur](https://vibestarter.pro/discord/installation) présente les deux accès au bot — le bot seul, par le tableau de bord web, et Community, par l’application. Il ne remplace pas l’autorisation Discord et ne donne aucun droit supplémentaire. Avant l’ouverture client, cette page indique que le bot n’est pas encore ouvert.

Les [conditions du bot](https://vibestarter.pro/discord/conditions) et sa [politique de confidentialité](https://vibestarter.pro/discord/confidentialite) sont consultables sans compte VibeStarter, y compris par les membres de ton serveur. La politique précise les données traitées, leur conservation et comment demander leur suppression. Une dissociation n’efface pas toutes les données du jeu.

## Avant de commencer

-   **C’est toi qui installes**, en tant que titulaire de Community sur ce jeu. Le serveur Discord doit être le tien, ou tu dois pouvoir y ajouter une application : sur Discord, c’est réservé aux membres qui ont la permission **Gérer le serveur**.
-   **Ton compte Discord doit être lié à ton compte VibeStarter.** La liaison se fait par le bouton Rejoindre Discord, sur l’accueil de ton espace compte (vibestarter.pro/account) : voir [Obtenir l’accès membre](/communaute/discord/#obtenir-lacc%C3%A8s-membre-apr%C3%A8s-lachat). Sans compte Discord lié, l’installation ne démarre pas.
-   **Le compte Discord qui autorise doit être ce compte lié.** Un autre compte Discord est refusé, même s’il administre le serveur. Personne ne peut donc installer le bot à ta place, et un lien d’installation transmis à quelqu’un d’autre n’associe rien.
-   **Ce compte Discord doit continuer à gérer le serveur.** S’il n’en est plus propriétaire ou administrateur et n’a plus la permission **Gérer le serveur**, le bot cesse d’agir : voir [Renouveler l’autorisation](/services/discord-du-jeu/installer-le-bot/#renouveler-lautorisation).
-   **Un serveur ne peut être associé qu’à un seul jeu**, et un jeu à un seul serveur. Si le serveur sert déjà à un autre jeu, l’installation est refusée : voir [Si l’installation est refusée](/services/discord-du-jeu/installer-le-bot/#si-linstallation-est-refus%C3%A9e).

## Installer

1.  Ouvre ton projet, l’onglet Communauté, puis la section Discord. L’écran affiche « Trois étapes, puis l’agent s’occupe du reste », et l’étape 1,
    
    Installer le bot sur ton serveur Discord, dit « Aucun serveur associé ».
    
2.  Clique Installer le bot, à droite de l’étape. Ton navigateur s’ouvre sur Discord, et l’app écrit : « Discord est ouvert dans ton navigateur. Termine l’installation là-bas, puis reviens ici. »
    
3.  Sur Discord, connecté avec le compte lié à ton compte VibeStarter, choisis le serveur dans la liste, relis les permissions demandées, puis autorise.
    
4.  Une page VibeStarter s’ouvre dans le même navigateur : « Donner à ce jeu le contrôle du bot sur votre serveur ? » Elle nomme le serveur Discord, le jeu (le nom de ton projet et l’identifiant du jeu sur Roblox), le compte VibeStarter du jeu, en partie masqué, et le compte Discord avec lequel tu es connecté. Vérifie-les, puis clique Confirmer l’association. Refuser n’associe rien et fait quitter le serveur au bot. Sans réponse dans les dix minutes, rien n’est associé non plus.
    
5.  La page affiche « Serveur Discord associé. Revenir dans VibeStarter pour vérifier le bot et configurer les salons. » Reviens dans l’application.
    
6.  L’étape 1 affiche « En attente du bot : aucun signe depuis 3 minutes. », y compris dans les premières secondes, puis, dès que le bot s’est signalé, « Bot connecté · N salons visibles ». Restent l’étape 2, la clé API Roblox, et l’étape 3, le lancement de l’agent. Une fois le jeu raccordé, les trois étapes se replient en une ligne qui dit « Bot connecté · N salons visibles », « Jeu raccordé » et l’heure du dernier rapport du bot.
    

Si l’app reste sur « En attente du bot : aucun signe depuis 3 minutes. », c’est que le bot ne s’est pas encore annoncé. Laisse-lui une minute avant de t’inquiéter.

## Si l’installation est refusée

Un refus après Discord s’affiche dans le navigateur, pas dans l’application, sous le titre « Installation interrompue. », suivi de sa cause. Dans l’app, l’étape 1 reste sur « Aucun serveur associé ». Si Discord avait déjà ajouté le bot au serveur, la page ajoute « Rien n’a été associé : le bot quitte le serveur dans les minutes qui viennent. »

| La page commence par | Ce que tu fais |
| --- | --- |
| « Le compte Discord qui vient d’autoriser n’est pas celui lié au compte VibeStarter de ce jeu. » | Connecte-toi à Discord avec le compte lié, ou change-le sur l’accueil de ton espace compte : Délier, puis Rejoindre Discord. |
| « Le compte VibeStarter de ce jeu n’a pas de compte Discord lié. » | Lie ton compte Discord : bouton Rejoindre Discord, sur l’accueil de ton espace compte. |
| « Discord n’a pas confirmé le compte qui autorise. » | Relance : Discord n’a pas répondu. |
| « Ce serveur est déjà associé à un autre jeu. » | Choisis un autre serveur, ou dissocie-le depuis l’autre jeu. |
| « Ce jeu est déjà associé à un autre serveur. » | [Dissocie-le](/services/discord-du-jeu/dissocier/) avant d’en choisir un nouveau. |
| « Le bot Discord des jeux est complet pour le moment : aucune nouvelle installation n’est possible. » | Toutes les places du bot sont prises. Écris à **[support@vibestarter.pro](mailto:support@vibestarter.pro)** pour être prévenu. |
| « Ce lien est expiré ou déjà utilisé. » | Tu as trop attendu, ou rouvert un ancien lien. |
| « Cette confirmation est expirée, déjà utilisée, ou ouverte dans un autre navigateur que celui qui a autorisé Discord. » | Refais tout le parcours dans un seul navigateur, sans dépasser dix minutes sur la confirmation. |
| « L’association de ce jeu a changé pendant l’installation. » | Une autre installation a abouti entre-temps : vérifie la section Discord. |
| « Community n’est pas actif sur ce jeu. » | Community s’est arrêté pendant l’installation. |
| « Installation refusée, expirée ou indisponible. Relancer depuis le jeu dans VibeStarter. » | La cause n’est pas précisée : autorisation annulée sur Discord, ou service momentanément indisponible. |

Si tu as cliqué Refuser, la page dit « Association refusée. » et le bot quitte le serveur dans les minutes qui viennent.

Une fois la cause levée, relance Installer le bot depuis l’application.

## Les permissions demandées, une par une

L’écran de consentement Discord liste les permissions nécessaires. Voici pourquoi chacune est demandée :

| Permission Discord | À quoi elle sert |
| --- | --- |
| **Voir les salons** | Dresser la liste des salons où le bot peut écrire. |
| **Envoyer des messages** | Publier les annonces de ton jeu. |
| **Intégrer des liens** | Que les liens de tes annonces s’affichent correctement. |
| **Joindre des fichiers** | Joindre une image à une annonce. |
| **Voir l’historique des messages** | Retrouver **ses propres** messages pour les modifier ou les retirer. |
| **Gérer les salons** | Créer, renommer ou supprimer un salon **quand tu le demandes**. |
| **Gérer les rôles** | Créer un rôle et régler les accès d’un salon **quand tu le demandes**. |
| **Ajouter des réactions** | Poser une réaction sur un message qu’il a publié. |
| **Gérer le serveur** | Lire et configurer les règles AutoMod natives de Discord. |
| **Exclure temporairement des membres** | Permettre une exclusion temporaire dans une règle AutoMod, uniquement à ta demande. |

Et voici ce qui **n’est pas demandé**, et ne peut donc pas être fait : **Administrateur**, **Expulser** et **Bannir des membres**, **Gérer les messages** des autres, **Gérer les webhooks**, **Gérer les pseudos**.

Le bot ne peut pas se donner plus de droits

Un rôle qui détient une permission d’administration ou de modération est intouchable pour lui, tout comme le rôle `@everyone`, les rôles placés au-dessus du sien et son propre rôle. Chaque action qu’il exécute laisse une trace lisible dans le journal d’audit de ton serveur, sous la forme « VibeStarter action … ».

Si le bot était déjà installé, utilise **Réinstaller le bot** pour renouveler ces permissions. Il ne reçoit jamais le droit Administrateur. La permission « Gérer le serveur » est imposée par Discord pour AutoMod ; les outils de l’agent restent limités aux actions prévues.

## Ce que VibeStarter voit de ton serveur

Le bot rapporte **la liste des salons et des rôles** de ton serveur : c’est ce qui permet de te proposer un salon où écrire, et de vérifier qu’il a le droit d’y publier. L’état « Bot connecté · N salons visibles » affiche ce nombre.

Il **ne rapporte pas** le contenu des messages de tes joueurs, la liste de tes membres, leurs présences, ni leurs messages privés. Il n’en reçoit tout simplement pas le flux.

## Renouveler l’autorisation

Le bouton Réinstaller le bot apparaît, sur l’étape 1 ou sur la ligne du serveur, quand le bot n’est plus en état de travailler, ou quand il lui manque des droits pour gérer les salons et les rôles. Il rejoue l’autorisation **sur le même serveur**, en conservant tes réglages et tes règles d’annonce ; les actions en attente au moment du renouvellement sont annulées. Il repasse par la page de confirmation.

Le bot vérifie régulièrement que le compte Discord qui l’a installé gère toujours le serveur. Si ce compte a quitté le serveur ou n’y a plus les droits, le bot cesse d’agir sans rien effacer. Réinstalle-le depuis ton compte Discord lié, une fois qu’il gère à nouveau le serveur ; sans réinstallation dans les 30 jours, le bot quitte le serveur et l’association est libérée.

C’est différent de la dissociation, qui coupe le lien. Voir [Dissocier ton serveur](/services/discord-du-jeu/dissocier/).

## Questions fréquentes

**Puis-je installer le bot sur un serveur que je ne possède pas ?** Seulement si ton compte Discord lié y a le droit d’ajouter une application : la permission **Gérer le serveur**, que Discord accorde ou non.

**Mon community manager peut-il installer le bot à ma place ?** Non. Le compte Discord qui autorise doit être celui lié à ton compte VibeStarter. Donne à ton propre compte Discord la permission **Gérer le serveur** sur ce serveur, puis installe toi-même.

**Quelqu’un m’a envoyé un lien pour « ajouter le bot » à mon serveur.** N’autorise pas. Un lien d’installation ne vaut que pour le compte qui l’a demandé depuis son jeu. Si tu arrives sur la page de confirmation d’un jeu qui n’est pas le tien, clique Refuser : rien n’est associé et le bot quitte ton serveur.

**Est-ce que ça crée des salons tout de suite ?** Non. L’installation ne touche à rien sur ton serveur. Les salons et les rôles ne bougent que si tu le demandes à l’agent.

**Le navigateur dit « Installation interrompue. »** L’installation n’a pas abouti. La phrase qui suit donne la cause : voir [Si l’installation est refusée](/services/discord-du-jeu/installer-le-bot/#si-linstallation-est-refus%C3%A9e).

**L’app dit « Associe d’abord ce jeu au projet. »** Ton projet n’est pas encore relié à un jeu Roblox. Le lien se crée dans l’application, quand tu lies une place Roblox Studio au projet : voir [Lier une place à ton projet](/application/studio/lier-une-place/).

## Pour aller plus loin

-   [Les annonces de ton jeu](/services/discord-du-jeu/annonces/)
-   [Dissocier ton serveur](/services/discord-du-jeu/dissocier/)
-   [Limites et questions fréquentes](/services/discord-du-jeu/limites/)
-   [Le Discord de ton jeu](/services/discord-du-jeu/)