> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxyde-bots.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Rôles automatique

> [!NOTE]
>
> Cette outils est utilisable avec la commande `op!autorole` ou via `/config panel`

Bienvenue dans le menu de configuration du système de rôles automatiques.\
Grâce à ce système, un ou plusieurs rôles seront automatiquement attribués à chaque nouveau membre dès son arrivée sur votre serveur.

> [!TIP]
>
> Assurez-vous que le bot possède les permissions adéquates pour ajouter le rôle et qu'il est au-dessus des rôles que vous ajoutez

> [!WARNING]
>
> L'accès à ce menu nécessite la permission `Administrateur`sur le serveur.

## Ajouter un rôle

**1. Ouvrir le menu**

Lancez la commande `op!autorole` ou passez par `/config panel`.

![Autorole1](https://mintcdn.com/oxyde-groupe-bots/TKmKA3vhk5jz8FVz/images/protect/utils/autorole1.png?fit=max\&auto=format\&n=TKmKA3vhk5jz8FVz\&q=85\&s=2096e0b207bbf8af2574933de6ca942f)

**2. Cliquer sur Ajouter un rôle**

Un menu déroulant s'affiche avec la liste des rôles de votre serveur.

![Autorole2](https://mintcdn.com/oxyde-groupe-bots/TKmKA3vhk5jz8FVz/images/protect/utils/autorole2.png?fit=max\&auto=format\&n=TKmKA3vhk5jz8FVz\&q=85\&s=1b511069d2c4a5de1b4dbbd3d612717a)

**3. Sélectionner le ou les rôles**

Cochez un ou plusieurs rôles dans la liste.

> [!TIP]
>
> Si le rôle recherché n'apparaît pas directement dans la liste, utilisez la barre de recherche intégrée au menu déroulant de Discord pour le retrouver.

![Autorole3](https://mintcdn.com/oxyde-groupe-bots/TKmKA3vhk5jz8FVz/images/protect/utils/autorole3.png?fit=max\&auto=format\&n=TKmKA3vhk5jz8FVz\&q=85\&s=356a408f77249532e7252b074e67b470)

**4. Confirmation**

Les rôles sélectionnés sont ajoutés à la configuration et s'affichent dans le message de confirmation.

![Autorole4](https://mintcdn.com/oxyde-groupe-bots/r5zFgdyTBQYJVNW-/images/protect/utils/autorole4.png?fit=max\&auto=format\&n=r5zFgdyTBQYJVNW-\&q=85\&s=5aeabea96b8b87c571dde3bf14b95805)

## Supprimer un rôle

Le fonctionnement est identique : cliquez sur **Supprimer un rôle**, sélectionnez le ou les rôles à retirer de la configuration, puis confirmez.

## Messages de retour

Lors de l'ajout d'un rôle, le bot peut retourner différents statuts selon la situation :

<table>
  <colgroup>
    <col width="100" />

    <col width="591" />
  </colgroup>

  <thead>
    <tr>
      <th>Icône</th>
      <th>Signification</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>✅</td>
      <td>Rôle ajouté avec succès à la configuration</td>
    </tr>

    <tr>
      <td>⚠️</td>
      <td>Le rôle est déjà présent dans la configuration</td>
    </tr>

    <tr>
      <td>🤖</td>
      <td>Rôle géré (bot, intégration ou booster) ignoré — ces rôles ne peuvent pas être attribués manuellement</td>
    </tr>

    <tr>
      <td>🚫</td>
      <td>Rôle avec des permissions sensibles ignoré, par sécurité</td>
    </tr>

    <tr>
      <td>❌</td>
      <td>Rôle invalide ou introuvable</td>
    </tr>
  </tbody>
</table>

> [!NOTE]
>
> Les rôles possédant des permissions sensibles (Administrateur, gestion du serveur, etc.) sont automatiquement exclus de l'autorole afin d'éviter toute élévation de privilèges accidentelle.

> [card] [Un problème avec cette fonctionnalité ?](https://discord.gg/uJC8QR9Yky)
>
> Rejoignez notre serveur de [support](https://discord.gg/neU8YJYkzQ), on vous répondra rapidement.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.