Modifier les messages du bot

Tous les textes du bot sont rangés dans un fichier de langue. Vous pouvez le télécharger, modifier les phrases que vous voulez, et le renvoyer au bot : il parlera alors avec vos mots.

Exemple typique : ajouter le lien de votre serveur de débannissement au message qu'un membre reçoit quand il est banni.

Changer la langue du bot

+set lang english passe le bot en anglais, +set lang français le remet en français.

Modifier un message, étape par étape

1. Télécharger le fichier

Tapez +get lang. Le bot vous envoie le fichier de sa langue actuelle. Si vous avez déjà un fichier personnalisé, il envoie aussi celui-là : c'est lui qu'il faut modifier.

2. Trouver la phrase

Ouvrez le fichier avec un éditeur de texte : le Bloc-notes de Windows suffit, un éditeur de code comme Visual Studio Code est plus confortable.

Cherchez la phrase avec Ctrl + F, en tapant un morceau du message actuel. Pour le message de bannissement, cherchez Vous avez été **ban**. Vous trouvez :

ban:
  message_no_reason: 'Vous avez été **ban** de {SERVER}'

3. Modifier la phrase

Changez le texte entre les apostrophes, par exemple :

  message_no_reason: 'Vous avez été **ban** de {SERVER}. Pour demander un débannissement : discord.gg/deban'

Les règles à respecter :

• Les mots en MAJUSCULES entre accolades sont des variables : {SERVER} devient le nom du serveur. Gardez-les telles quelles ; vous pouvez les déplacer dans la phrase.
• Une apostrophe dans le texte s'écrit en double : l''aide.
• Pour un message sur plusieurs lignes, utilisez |- puis une ligne par ligne de texte, décalées de deux espaces :

  message_no_reason: |-
    Vous avez été **ban** de {SERVER}.
    Pour demander un débannissement : discord.gg/deban

4. Renvoyer le fichier

Enregistrez le fichier, puis envoyez-le au bot en pièce jointe du message +lang custom (ou répondez au message qui contient le fichier avec +lang custom).

Le bot vérifie le fichier avant de l'installer : clé inconnue, variable qui n'existe pas, texte vide ou mal formé… S'il trouve une erreur, il vous dit où, et rien n'est changé.

• +lang custom off revient aux textes d'origine ;
• +lang custom on remet vos textes.

Trouver le bon message

Vous ne trouvez pas la phrase ? Elle contient sans doute une variable ou une mise en forme. Passez le bot en mode développeur avec +set lang dev : à la place de ses textes, il affiche le nom de chaque message.

Faites alors l'action dont vous voulez changer le message. Par exemple, après un ban, le membre reçoit ban.message_no_reason : c'est la clé message_no_reason, dans la partie ban du fichier.

Les phrases spéciales

Certaines phrases changent selon un nombre ou un mot. Elles ont une forme particulière à respecter.

Les pluriels

Il y a {NUM, plural,
    =1 {un rôle}
    other {# rôles}
} sur le serveur

NUM est la variable qui contient le nombre, et plural ne doit pas être modifié. Chaque ligne donne le texte pour un nombre : =1 pour 1, =2 pour 2… other est obligatoire : il sert pour tous les autres nombres. Dans le texte, # est remplacé par le nombre.

Les choix selon un mot

{TEXT, select,
    option1 {première option}
    option2 {deuxième option}
    other {autre}
}

Même principe, avec des mots à la place des nombres : le texte affiché dépend de la valeur de TEXT. other est là aussi obligatoire.

Plusieurs versions au hasard

Donnez une liste au lieu d'une phrase, et le bot en choisira une au hasard à chaque fois :

  message_no_reason:
    - Vous avez été **ban** de {SERVER}
    - '{SERVER} ne veut plus de vous : vous avez été **ban**'

Une ligne qui commence par une accolade doit être entourée d'apostrophes, comme la seconde ci-dessus.

Si ça ne marche pas

• Le bot refuse le fichier : lisez son message, il indique la ligne et la clé en cause. Le plus souvent : une apostrophe non doublée, ou une variable renommée.
• Le bot n'a pas réagi au fichier : il doit être joint au même message que +lang custom.
• Mon changement n'apparaît pas : vérifiez que les textes personnalisés sont actifs avec +lang custom on.

Toutes les commandes

Chaque commande de ce guide, avec ses arguments, son niveau par défaut et des exemples : Langue.