{"id":3416,"date":"2023-02-04T13:00:00","date_gmt":"2023-02-04T12:00:00","guid":{"rendered":"https:\/\/carnivaloftime.com\/?p=3416"},"modified":"2023-02-18T11:05:28","modified_gmt":"2023-02-18T10:05:28","slug":"les-coulisses-de-ladministration-dhyliahtz","status":"publish","type":"post","link":"https:\/\/carnivaloftime.com\/index.php\/2023\/02\/04\/les-coulisses-de-ladministration-dhyliahtz\/","title":{"rendered":"Les coulisses de l’administration d’Hyliaht’z"},"content":{"rendered":"\n

Mon bot Discord fait maison, Hyliaht’z, a d\u00e9j\u00e0 eu droit \u00e0 2 articles, dans lesquels sont expliqu\u00e9es les commandes pour joueurs<\/a> et pour MJ<\/a>. <\/p>\n\n\n\n

Mais je n’ai pas encore sp\u00e9cialement parl\u00e9 de son d\u00e9veloppement. Or, parmi vous se cachent peut-\u00eatre des curieux qui s’interrogent sur le travail que \u00e7a implique, voire des cr\u00e9ateurs qui aimeraient d\u00e9ployer leur propre bot et se demandent comment s’y prendre.
Alors dans cet article, on va diss\u00e9quer tout \u00e7a !<\/p>\n\n\n\n

Il est temps de se placer de l’autre c\u00f4t\u00e9 de l’interface utilisateur, et de regarder un peu les rouages qui font tourner Hyliaht’z.<\/p>\n\n\n\n

Impl\u00e9mentation <\/h3>\n\n\n\n

Tout commence sur https:\/\/discord.com\/developers\/<\/a>
Ici, n’importe qui peut gratuitement cr\u00e9er son bot en quelques clics, en renseignant son nom, son avatar et sa description. <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

\u00c7a prend moins de 5 minutes, et POUF, le bot est l\u00e0.
Vous pouvez m\u00eame g\u00e9n\u00e9rer un lien d’invitation pour qu’il rejoigne vos serveurs Discord !<\/p>\n\n\n\n

Bon, par contre, il ne fait rien du tout, encore. Mais au moins vous avez r\u00e9cup\u00e9r\u00e9 un identifiant secret qui vous permettra ensuite, en envoyant des requ\u00eates, d’agir au nom du bot. C’est l\u00e0 qu’il va falloir coder ! 
Et vous avez le choix.<\/p>\n\n\n\n

Plusieurs biblioth\u00e8ques ont \u00e9t\u00e9 mises \u00e0 disposition pour communiquer avec l’API Discord, l’une des plus populaires utilisant le langage python.
Le code source d’Hyliath’z, lui, est \u00e9crit en langage C#<\/strong>, avec la biblioth\u00e8que Discord.NET<\/a>. <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Concr\u00e8tement, cette biblioth\u00e8que permet d’obtenir un environnement o\u00f9 chaque commande du bot est impl\u00e9ment\u00e9e par une fonction, comme ceci :<\/p>\n\n\n\n

[SlashCommand(\"hello\", \"Dit bonjour\")]\npublic async Task SayHelloAsync()\n{\n    await RespondAsync(\"Bien le bonjour \u00e0 vous !\");\n}<\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Et toutes les informations sur le serveur, le salon, les utilisateurs et leurs messages sont accessibles dans la limite des permissions accord\u00e9es \u00e0 votre bot. <\/p>\n\n\n\n
ISocketMessageChannel channel = Context.Channel;    \/\/ Salon de jeu d'o\u00f9 vient la commande\nSocketGuild guild = Context.Guild;                  \/\/ Serveur Discord d'o\u00f9 vient la commande\nSocketUser user = Context.User;                     \/\/ Utilisateur ayant rentr\u00e9 la commande<\/pre>\n\n\n\n
\u00c0 partir de l\u00e0, \u00e0 vous de programmer la logique que vous d\u00e9sirez.<\/p>\n\n\n\n
H\u00e9bergement<\/h3>\n\n\n\n
Le programme que vous allez coder pour envoyer des requ\u00eates au nom de votre bot, il faut qu’un ordinateur l’ex\u00e9cute. Sinon, le bot appara\u00eetra hors ligne, et il ne se passera \u00e9videmment jamais rien.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Vous pouvez utiliser votre ordinateur personnel, \u00e9ventuellement. Mais vous ne pourrez plus l’\u00e9teindre ou le red\u00e9marrer sans rendre le bot indisponible.  Une solution plus commune est donc de passer par un serveur externe. 
C’est plus compliqu\u00e9. Il faut savoir comment le configurer, installer Dotnet dessus, et en plus \u00e7a n’est pas gratuit. Mais au moins c’est une plate-forme qui pourra faire fonctionner le bot en continu. <\/p>\n\n\n\n
Hyliaht’z est h\u00e9berg\u00e9 sur un VPS (serveur priv\u00e9 virtuel) qui me co\u00fbte moins de 5\u20ac par mois, chez OVH<\/strong>. Rien de tr\u00e8s cher, donc. 
https:\/\/www.ovhcloud.com\/fr\/vps\/<\/a><\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
\n
Lorsque le datacenter d’OVH a pris feu \u00e0 Strasbourg, le PC qui faisait fonctionner Hyliaht’z a \u00e9t\u00e9 arr\u00eat\u00e9, et le bot est devenu indisponible. Une belle occasion de rappeler que si ce n’est pas votre ordinateur personnel qui h\u00e9berge votre bot, c’en est un autre quelque part dans le monde, et il peut toujours lui arriver des bricoles.<\/p>\n<\/blockquote>\n\n\n\n
Environnement de test<\/h3>\n\n\n\n
En r\u00e8gle g\u00e9n\u00e9rale, mieux vaut \u00e9viter de d\u00e9ployer une fonctionnalit\u00e9 qui n’a pas \u00e9t\u00e9 test\u00e9e.
Il est plus sage de tester votre code dans l’ombre, et de ne mettre \u00e0 jour le bot que lorsque vous \u00eates s\u00fbr de votre coup. <\/p>\n\n\n\n
Personnellement, j’ai cr\u00e9\u00e9 un bot de test qui s’appelle Hyliaht’z B\u00eata<\/strong> et que je peux tester librement sur un serveur Discord d\u00e9di\u00e9. Au moins, comme \u00e7a, je suis tranquille.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
J’ai aussi cr\u00e9\u00e9 des commandes utilisateur sp\u00e9ciales pour debugger le bot, ou ex\u00e9cuter des actions d’administration. 
Elles sont li\u00e9es \u00e0 mon compte Discord et au r\u00f4le Sage<\/strong>. Donc m\u00eame les MJ ne peuvent pas y acc\u00e9der.<\/p>\n\n\n\n
\/nayru<\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Le bot a besoin d’un certain nombre de r\u00f4les sur le serveur Discord, pour fonctionner. Et la commande \/nayru<\/code> a pour but de les cr\u00e9er automatiquement. Gr\u00e2ce \u00e0 \u00e7a, je peux tr\u00e8s rapidement int\u00e9grer le bot \u00e0 un nouveau serveur. <\/p>\n\n\n\n
\/farore<\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Cette commande permet tout b\u00eatement d’afficher l’\u00e9tat de la m\u00e9moire d’Hyliath’z. C’est-\u00e0-dire qu’elle affiche les serveurs, les salons et les joueurs connus du bot.<\/p>\n\n\n\n
\/din @User<\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Des fois, pour reproduire les conditions d’un bug, ou juste pour afficher un exemple, il est utile de contr\u00f4ler le r\u00e9sultat d’un jet.  Dans cet esprit, \/din<\/code> fournit une interface pour modifier la valeur des d\u00e9s et leur sauvegarde, pour un joueur sp\u00e9cifique. M\u00eame le nombre de relances restantes peut \u00eatre directement \u00e9dit\u00e9 ! <\/p>\n\n\n\n
Mais ce n’est pas tout.
Utilis\u00e9e sans param\u00e8tre, la commande permet aussi de contr\u00f4ler la valeur obligatoire et la valeur maudite du Vice au rang 2.<\/p>\n\n\n\n
\/din<\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Limitations<\/h3>\n\n\n\n
Il faut savoir, tout de m\u00eame, que le syst\u00e8me d’interactions de Discord est assez neuf. Et comme tout ce qui est trop r\u00e9cent, c’est un peu lacunaire. 
J’ai donc d\u00fb composer avec des contraintes dont je me serais bien pass\u00e9, comme :<\/p>\n\n\n\n
    \n
  • Le maximum de 5 commandes utilisateur<\/li>\n\n\n\n
  • Le maximum de 25 boutons apr\u00e8s une interaction<\/li>\n\n\n\n
  • L’impossibilit\u00e9 d’utiliser des emojis en taille large avec du texte<\/li>\n\n\n\n
  • Le syst\u00e8me de permissions d\u00e9finies par r\u00f4les qui ne fonctionne pas<\/li>\n\n\n\n
  • Le d\u00e9lai de 3 secondes pour r\u00e9pondre \u00e0 une requ\u00eate<\/li>\n\n\n\n
  • Les param\u00e8tres d’int\u00e9gration d’application qui sont inaccessibles sur mobile<\/li>\n<\/ul>\n\n\n\n
    Et si vous faites votre propre bot, des contraintes, vous en trouverez d’autres ! Ce n’est pas ce qui manque. <\/p>\n\n\n\n
    Heureusement, ce qui est cool, c’est que Discord \u00e9volue vite. Des corrections et de nouvelles fonctionnalit\u00e9s sont soumises r\u00e9guli\u00e8rement.  Il est donc possible que ces limites sautent et que d’autres standards \u00e9mergent. C’est pourquoi je vais continuer de veiller au grain et maintenir Hyliaht’z \u00e0 jour. <\/p>\n\n\n\n
    Ce genre de travail n’est jamais vraiment termin\u00e9 !<\/p>\n","protected":false},"excerpt":{"rendered":"
    Mon bot Discord fait maison, Hyliaht’z, a d\u00e9j\u00e0 eu droit \u00e0 2 articles, dans lesquels sont expliqu\u00e9es les commandes pour joueurs et pour MJ.  Mais je n’ai pas encore sp\u00e9cialement parl\u00e9 de son d\u00e9veloppement. Or, parmi vous se cachent peut-\u00eatre des curieux qui s’interrogent sur le travail que \u00e7a implique, voire des cr\u00e9ateurs qui aimeraient d\u00e9ployer leur propre bot et se demandent comment s’y prendre.Alors dans cet article, on va diss\u00e9quer tout \u00e7a ! Il est temps de se placer de l’autre c\u00f4t\u00e9 de l’interface utilisateur, et de regarder un peu les rouages qui font tourner Hyliaht’z. Impl\u00e9mentation  Tout commence sur https:\/\/discord.com\/developers\/Ici, n’importe qui peut gratuitement cr\u00e9er son bot en quelques clics, en renseignant son nom, son avatar et sa description.  \u00c7a prend moins de 5 minutes, et POUF, le bot est l\u00e0.Vous pouvez m\u00eame g\u00e9n\u00e9rer un lien d’invitation pour qu’il rejoigne vos serveurs Discord ! Bon, par contre, il ne fait rien du tout, encore. Mais au moins vous avez r\u00e9cup\u00e9r\u00e9 un identifiant secret qui vous permettra ensuite, en envoyant des requ\u00eates, d’agir au nom du bot. C’est l\u00e0 qu’il va falloir coder ! Et vous avez le choix. Plusieurs biblioth\u00e8ques ont \u00e9t\u00e9 mises \u00e0 disposition pour communiquer avec l’API Discord, l’une des plus populaires utilisant le langage python.Le code source d’Hyliath’z, lui, est \u00e9crit en langage C#, avec la biblioth\u00e8que Discord.NET.  Concr\u00e8tement, cette biblioth\u00e8que permet d’obtenir un environnement o\u00f9 chaque commande du bot est impl\u00e9ment\u00e9e par une fonction, comme ceci : [SlashCommand(\u00ab\u00a0hello\u00a0\u00bb, \u00ab\u00a0Dit bonjour\u00a0\u00bb)] public async Task SayHelloAsync() { await RespondAsync(\u00ab\u00a0Bien le bonjour \u00e0 vous !\u00a0\u00bb); } Et toutes les informations sur le serveur, le salon, les utilisateurs et leurs messages sont accessibles dans la limite des permissions accord\u00e9es \u00e0 votre bot.  ISocketMessageChannel channel = Context.Channel; \/\/ Salon de jeu d’o\u00f9 vient la commande SocketGuild guild = Context.Guild; \/\/ Serveur Discord d’o\u00f9 vient la commande SocketUser user = Context.User; \/\/ Utilisateur ayant rentr\u00e9 la commande \u00c0 partir de l\u00e0, \u00e0 vous de programmer la logique que vous d\u00e9sirez. H\u00e9bergement Le programme que vous allez coder pour envoyer des requ\u00eates au nom de votre bot, il faut qu’un ordinateur l’ex\u00e9cute. Sinon, le bot appara\u00eetra hors ligne, et il ne se passera \u00e9videmment jamais rien. Vous pouvez utiliser votre ordinateur personnel, \u00e9ventuellement. Mais vous ne pourrez plus l’\u00e9teindre ou le red\u00e9marrer sans rendre le bot indisponible.  Une solution plus commune est donc de passer par un serveur externe. C’est plus compliqu\u00e9. Il faut savoir comment le configurer, installer Dotnet dessus, et en plus \u00e7a n’est pas gratuit. Mais au moins c’est une plate-forme qui pourra faire fonctionner le bot en continu.  Hyliaht’z est h\u00e9berg\u00e9 sur un VPS (serveur priv\u00e9 virtuel) qui me co\u00fbte moins de 5\u20ac par mois, chez OVH. Rien de tr\u00e8s cher, donc. https:\/\/www.ovhcloud.com\/fr\/vps\/ Lorsque le datacenter d’OVH a pris feu \u00e0 Strasbourg, le PC qui faisait fonctionner Hyliaht’z a \u00e9t\u00e9 arr\u00eat\u00e9, et le bot est devenu indisponible. Une belle occasion de rappeler que si ce n’est pas votre ordinateur personnel qui h\u00e9berge votre bot, c’en est un autre quelque part dans le monde, et il peut toujours lui arriver des bricoles. Environnement de test En r\u00e8gle g\u00e9n\u00e9rale, mieux vaut \u00e9viter de d\u00e9ployer une fonctionnalit\u00e9 qui n’a pas \u00e9t\u00e9 test\u00e9e.Il est plus sage de tester votre code dans l’ombre, et de ne mettre \u00e0 jour le bot que lorsque vous \u00eates s\u00fbr de votre coup.  Personnellement, j’ai cr\u00e9\u00e9 un bot de test qui s’appelle Hyliaht’z B\u00eata et que je peux tester librement sur un serveur Discord d\u00e9di\u00e9. Au moins, comme \u00e7a, je suis tranquille. J’ai aussi cr\u00e9\u00e9 des commandes utilisateur sp\u00e9ciales pour debugger le bot, ou ex\u00e9cuter des actions d’administration. Elles sont li\u00e9es \u00e0 mon compte Discord et au r\u00f4le Sage. Donc m\u00eame les MJ ne peuvent pas y acc\u00e9der. \/nayru Le bot a besoin d’un certain nombre de r\u00f4les sur le serveur Discord, pour fonctionner. Et la commande \/nayru a pour but de les cr\u00e9er automatiquement. Gr\u00e2ce \u00e0 \u00e7a, je peux tr\u00e8s rapidement int\u00e9grer le bot \u00e0 un nouveau serveur.  \/farore Cette commande permet tout b\u00eatement d’afficher l’\u00e9tat de la m\u00e9moire d’Hyliath’z. C’est-\u00e0-dire qu’elle affiche les serveurs, les salons et les joueurs connus du bot. \/din @User Des fois, pour reproduire les conditions d’un bug, ou juste pour afficher un exemple, il est utile de contr\u00f4ler le r\u00e9sultat d’un jet.  Dans cet esprit, \/din fournit une interface pour modifier la valeur des d\u00e9s et leur sauvegarde, pour un joueur sp\u00e9cifique. M\u00eame le nombre de relances restantes peut \u00eatre directement \u00e9dit\u00e9 !  Mais ce n’est pas tout.Utilis\u00e9e sans param\u00e8tre, la commande permet aussi de contr\u00f4ler la valeur obligatoire et la valeur maudite du Vice au rang 2. \/din Limitations Il faut savoir, tout de m\u00eame, que le syst\u00e8me d’interactions de Discord est assez neuf. Et comme tout ce qui est trop r\u00e9cent, c’est un peu lacunaire. J’ai donc d\u00fb composer avec des contraintes dont je me serais bien pass\u00e9, comme : Et si vous faites votre propre bot, des contraintes, vous en trouverez d’autres ! Ce n’est pas ce qui manque.  Heureusement, ce qui est cool, c’est que Discord \u00e9volue vite. Des corrections et de nouvelles fonctionnalit\u00e9s sont soumises r\u00e9guli\u00e8rement.  Il est donc possible que ces limites sautent et que d’autres standards \u00e9mergent. C’est pourquoi je vais continuer de veiller au grain et maintenir Hyliaht’z \u00e0 jour.  Ce genre de travail n’est jamais vraiment termin\u00e9 !<\/p>\n","protected":false},"author":1,"featured_media":4435,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[],"class_list":["post-3416","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-hyliahtz"],"_links":{"self":[{"href":"https:\/\/carnivaloftime.com\/index.php\/wp-json\/wp\/v2\/posts\/3416","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/carnivaloftime.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/carnivaloftime.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/carnivaloftime.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/carnivaloftime.com\/index.php\/wp-json\/wp\/v2\/comments?post=3416"}],"version-history":[{"count":6,"href":"https:\/\/carnivaloftime.com\/index.php\/wp-json\/wp\/v2\/posts\/3416\/revisions"}],"predecessor-version":[{"id":4411,"href":"https:\/\/carnivaloftime.com\/index.php\/wp-json\/wp\/v2\/posts\/3416\/revisions\/4411"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/carnivaloftime.com\/index.php\/wp-json\/wp\/v2\/media\/4435"}],"wp:attachment":[{"href":"https:\/\/carnivaloftime.com\/index.php\/wp-json\/wp\/v2\/media?parent=3416"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/carnivaloftime.com\/index.php\/wp-json\/wp\/v2\/categories?post=3416"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/carnivaloftime.com\/index.php\/wp-json\/wp\/v2\/tags?post=3416"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}