Modération
takeRole
$takeRole
La fonction $takeRole retire un rôle à un utilisateur sur le serveur Discord. Le bot doit avoir la permission ManageRoles.
Syntaxe
$takeRole[userID;roleID]
$takeRole[roleID]
Paramètres
| Paramètre | Description |
|---|---|
userID |
Optionnel. L’ID de l’utilisateur cible. Si un seul argument est fourni, il est lu comme l’ID du rôle et le rôle est retiré aux utilisateurs mentionnés dans le message ; une erreur est levée s’il n’y a aucune mention (l’auteur n’est jamais utilisé comme valeur de repli). |
roleID |
L’ID du rôle à retirer (un nombre positif). Obligatoire. |
Valeur de retour
Aucune (chaîne vide). Une erreur est levée si l’ID de l’utilisateur ou du rôle est invalide.
Exemples
Retrait simple
$takeRole[$mentioned[1];$roleID[Muted]]
$sendMessage[🔊 <@$mentioned[1]> is no longer muted!]
Retrait après vérification
$if[$checkContains[$userRoles[$mentioned[1]];$roleID[Muted]]==true]
$takeRole[$mentioned[1];$roleID[Muted]]
$sendMessage[Muted role removed.]
$else
$sendMessage[This user does not have the Muted role.]
$endif
Commande de retrait avec confirmation
$takeRole[$mentioned[1];$roleID[$message[2]]]
$sendMessage[✅ Role removed from <@$mentioned[1]>.]
Remarques
- Le bot doit avoir la permission
ManageRoles. - Le bot doit avoir
Manage Roles; le rôle doit être situé sous le rôle le plus élevé du bot, et@everyoneainsi que les rôles gérés (bot, intégration, booster) ne peuvent pas être retirés. - Pour retirer plusieurs rôles, utilisez
$takeRoles.
Essayer
Collez un exemple dans le playground pour prévisualiser son message (les fonctions qui agissent sur Discord ne sont pas exécutées), ou construisez la même chose avec des blocs.