AOO
github_fill

Rechercher dans la documentation

Rechercher des pages et des titres dans la documentation

/settings — Configurer le bot

La commande /settings configure le comportement du bot sur votre serveur. Elle régit aujourd’hui les annonces de version, c’est-à-dire les messages publiés par le bot à chaque nouvelle version.

Les réglages sont propres à chaque serveur. Les modifier sur l’un n’affecte jamais les autres.

/settings show | announcement-channel channel:<channel> | announcements [enabled:<bool>] [mention-everyone:<bool>]

Parameters

showsubcommandAfficher la configuration actuelle
announcement-channelsubcommandChoisir le salon des annonces
announcementssubcommandActiver ou désactiver les annonces

Permissions

/settings exige la permission Gérer le serveur. Les membres qui n’en disposent pas ne voient pas du tout la commande dans l’interface Discord : elle est masquée, et non refusée.

Cela diffère de /add, /edit et /remove, utilisables par tout membre.

Sous-commandes

/settings show

Affiche la configuration actuelle :

**Announcement channel:** #bot-news
**Announcements:** enabled
**Mention `@everyone`:** disabled

Lorsqu’aucun salon n’a été choisi, la première ligne devient :

**Announcement channel:** not set, announcements fall back to the last channel the bot was used in

/settings announcement-channel

Choisit le salon où les annonces de version sont publiées.

ParamètreTypeObligatoireDescription
channelSalonOuiSalon textuel où publier les annonces

Seuls les salons textuels apparaissent dans le sélecteur. Le bot vérifie qu’il peut réellement y écrire avant d’enregistrer :

Announcements will now be posted in #bot-news.

Sinon, rien n’est enregistré et le bot nomme la permission manquante :

I cannot post in that channel: the **View Channel** permission is missing. Grant it there, then run the command again.

Le même message apparaît avec Send Messages lorsque c’est cette permission qui manque. Accordez-la sur le salon, puis relancez la commande.

/settings announcements

Active ou désactive les annonces, et contrôle la mention @everyone.

ParamètreTypeObligatoireDescription
enabledBooléenNonRecevoir les annonces de version sur ce serveur
mention-everyoneBooléenNonMentionner @everyone lors d’une annonce

Les deux paramètres sont facultatifs et indépendants : ne fournissez que celui que vous souhaitez modifier. Le bot répond avec la configuration complète après application.

Lancer la sous-commande sans aucun paramètre affiche la configuration actuelle sans rien modifier, exactement comme /settings show.

Valeurs par défaut

RéglageDéfaut
AnnoncesActivées
Mention @everyoneDésactivée
Salon d’annoncesNon défini — repli sur le dernier salon où le bot a été utilisé

Où atterrissent les annonces

Sans salon d’annonces défini, le bot se replie sur le dernier salon où une commande a été utilisée sur votre serveur. Ce message porte alors une notice expliquant le repli et renvoyant vers /settings announcement-channel.

Si le bot n’a jamais été utilisé dans aucun salon, il cherche un salon contenant un objectif encore actif. À défaut des deux, votre serveur est ignoré pour cette annonce : rien n’est publié.

Définir un salon explicitement supprime cette part de devinette, et la notice de repli disparaît.

Comportement

Permission @everyone manquante

Si votre serveur a autorisé la mention @everyone mais que le bot ne dispose pas de la permission Mentionner @everyone dans le salon visé, l’annonce est tout de même publiée, sans la mention. Rien n’est bloqué.

Annonces déjà reçues

Chaque annonce n’est envoyée qu’une fois par serveur. Relancer /settings ne renvoie jamais une annonce déjà reçue.

Un serveur qui installe le bot après la publication d’une version ne reçoit pas cette annonce rétroactivement : il démarre à la version suivante.

Désactiver les annonces

Avec enabled à false, votre serveur est intégralement ignoré pour les annonces futures. Le réglage persiste jusqu’à ce qu’un administrateur le réactive.

Commandes associées

  • /about affiche la version du bot et les documents légaux
  • /add rapporte un nouvel objectif
  • /list affiche les objectifs suivis