Modération
unBanID
$unBanID
La fonction $unBanID[] permet de débannir un utilisateur par son ID. Contrairement à $unBan, qui recherche par nom d’utilisateur, elle travaille à partir de l’ID brut.
Syntaxe
$unBanID[(userID)]
Paramètres
| Paramètre | Description |
|---|---|
userID |
Facultatif - L’ID Discord de l’utilisateur à débannir. S’il est omis, le dernier mot du message est utilisé (vide s’il n’y en a pas). S’il est vide ou n’est pas un nombre positif, l’erreur Missing or invalid user ID. est levée. |
Valeur de retour
- Type : chaîne (vide)
- Chaîne vide si le débannissement réussit.
- Une erreur est levée en cas d’échec (ID invalide, permissions insuffisantes, ou échec de l’appel à Discord, par exemple parce que l’utilisateur n’est pas banni).
Comportement
- Contrairement à
$unBan, qui recherche le nom d’utilisateur dans la liste des bannissements, elle débannit l’ID donné. - Le bot doit avoir la permission
Ban Members. - Il n’y a pas d’argument de raison : le débannissement est effectué sans raison dans le journal d’audit.
Exemples
Débannir à partir d’un ID
$unBanID[$message[1]]
$sendMessage[✅ **$message[1]** was unbanned.]
Débannissement programmé
$var[target;$noMentionMessage]
$if[$isBanned[$var[target]]==true]
$unBanID[$var[target]]
$channelSendMessage[$channelID[mod-logs];User **$var[target]** was unbanned (end of ban duration).]
$endif
Remarques
- Utilisez
$unBanpour débannir par nom d’utilisateur. - Utile pour les scripts internes où seul l’ID est connu.
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.