Il est possible de modifier tous les messages envoyés par votre bot, que ce soit pour les commandes, les erreurs, les logs, les messages d'aide, etc...

Exemple : Modifier le message de ban

Nous allons voir comment il est possible de modifier le message privé reçu par un membre qui se fait bannir, par exemple pour y ajouter le lien vers un serveur de deban.
Dans un premier temps, nous allons récupérer le fichier de configuration de langue actuel. Pour cela, il faut faire la commande +get lang. Le bot vous envoie alors un fichier contenant tous ses messages (si le bot vous envoie deux fichiers, le premier correspond à la version par défaut, et le second à une version modifiée que vous avez déjà créée). Une fois le fichier téléchargé, vous pouvez l'ouvrir avec n'importe quel éditeur de texte ou éditeur de code, comme par exemple le bloc-notes de Windows. Dans cet exemple, nous utiliserons Visual Studio Code.

Pour trouver l'endroit correspondant au message de ban, le plus simple est de faire une recherche dans le fichier avec le raccourci Ctrl + F et de chercher le contenu du message de ban actuel (en l'occurrence "Vous avez été **ban**"). Une fois que vous avez trouvé la ligne qui vous intéresse, vous pouvez la modifier directement dans le fichier. Les variables sont tout en majuscules et entre accolades, par exemple {SERVER} pour le serveur.
Par exemple, vous pouvez mettre "Vous avez été **ban** de {SERVER}. Pour être débanni, faites une demande sur discord.gg/deban".

Si vous souhaitez mettre des retours à la ligne, vous pouvez utiliser le format suivant :

|-
    Texte de la première ligne
    Texte de la deuxième ligne
    Texte de la troisième ligne

et n'oubliez pas les premier |- qui indique que c'est un texte multiligne.

Après avoir modifié votre message, il vous suffit de l'enregistrer et de le renvoyer au bot avec la commande +lang custom.

Et voilà, le message de ban est modifié !

Trouver le message à modifier

Si vous ne parvenez pas à trouver le message que vous voulez modifier, c'est qu'il contient probablement des caractères spéciaux ou des variables. Pour résoudre ce problème, vous pouvez passer votre bot en mode développeur en faisant la commande +set lang dev. Cela va faire en sorte que le bot vous envoie le nom de la variable à la place du contenu du message. Il vous suffit maintenant de faire la commande dont vous souhaitez modifier le message, puis d'aller à l'endroit correspondant dans le fichier.
Par exemple, si vous faites +ban @membre, celui-ci recevra "ban.message_no_reason" en message privé. Vous savez donc que pour modifier le message reçu lors d'un ban, il faut modifier la clé message_no_reason dans la catégorie ban.
Et n'oubliez pas de repasser votre bot en mode normal avec la commande +set lang fr après avoir fini !

Traduire des phrases complexes

Si vous souhaitez créer votre propre traductions du bot, vous allez rencontrer certaines phrases contenant des pluriels, ou d'autres variables spéciales. Voici comment elles fonctionnent :

Les pluriels

Pour qu'une variable dénote un pluriel, on le note de la manière suivante

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

Ici NUM est la variable qui contient le nombre, et plural indique que c'est un pluriel et ne doit pas être modifié. Ensuite, on indique les différentes options, avec le nombre, et le contenu de l'option pour ce nombre. Vous pouvez mettre autant d'option que vous voulez, mais vous devez toujours mettre une option other qui sera utilisée si la variable ne correspond à aucun des cas précédents. Dans ces options, vous pouvez utiliser un # qui sera remplacé par la valeur de la variable.

Sélecteur

Les sélecteurs fonctionnent comme les pluriels, mais avec du texte à la place des nombres.

{TEXT, select,
    option1 {première option}
    option2 {deuxième option}
    other {autre}
}

Ici TEXT est la variable qui contient le texte, et select indique que c'est un sélecteur et ne doit pas être modifié. Le text affichera donc "première option" si la variable est égale à "option1", "deuxième option" si la variable est égale à "option2", et "autre" si la variable est égale à autre chose.

Listes aléatoires

Enfin, il est possible d'assigner plusieurs valeurs différentes à un même message, le bot en choisira alors une au hasard. Par exemple, pour reprendre l'exemple du message de ban :

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

Et voilà, vous avez maintenant toutes les cartes en main pour modifier les messages de votre bot, créer des traductions, ou même cacher des easter eggs ! N'hésitez pas à partager vos meilleures créations avec les autres utilisateurs.

CrowBots

Comment modifier les messages de mon bot ?