Age of HTML

les balises HTML

Lorsque vous souhaitez mettre en forme du texte dans un script pour Age of Conan, l'utilisation de balises HTML est nécessaire.

qu'est-ce qu'une « balise » ?

Rien de mieux qu'une portion de code pour bien comprendre !

On distingue trois types de balises :

1. Les balises d'ouverture : Elles commencent une portion de code, comme à la ligne 1 et 2. Elles délimitent le début d'un élément et contiennent souvent du texte ou d'autres balises.
2. Les balises de fermeture : Elles terminent une portion de code, comme à la ligne 2 et 4. Elles marquent la fin d'un élément et doivent être placées dans l'ordre inverse des balises d'ouverture.
3. Les balises auto-fermantes : Elles n'ont pas de contenu interne, comme à la ligne 3. Elles sont utilisées pour insérer des éléments qui ne nécessitent pas de contenu supplémentaire, comme les images.

En copiant le bout de script et en le collant dans un fichier *html puis en glissant le fichier dans votre navigateur préféré vous obtiendrez l'affichage qui suit :

My first HTML script !

Dans cet exemple, le fichier possède l'extension de fichier *.html, cette extension n'est pas utilisable pour les scripts dans Age of Conan! Nous utiliserons donc des fichiers dont l'extension est *.txt pour tous les exemples suivants.

Les balises HTML peuvent être accompagnées d'« attributs », qui contrôlent le comportement de la balise ou de ses éléments enfants. Certains attributs sont universels et peuvent être utilisés avec n'importe quelle balise, tandis que d'autres sont spécifiques à certaines balises.

quelles sont les balises autorisées dans Age of Conan ?

L'HTML dans Age of Conan est assez basique. Nous allons le répertorier et le comprendre.

la balise <a>

Elle est utilisée pour créer des liens cliquables permettant d'ouvrir une fenêtre ou d'exécuter une action.

les attributs autorisés sont :

• href : qui aura pour valeur :
  • Une fenêtre avec la valeur text:// LE_TEXTE_OU_LA_FENETRE_ICI.
  • Une commande avec la valeur chatcmd:///L_EMOTE_ICI (à noter qu’il y a 3 /, 2 pour chatcmd:// et 1 pour l’emote). Les commandes fonctionnent uniquement dans une fenêtre.
• style : sert à changer l'apparence visuelle d'un élément HTML en lui appliquant des règles de style comme la couleur, etc. directement dans la balise. Cela permet de personnaliser l'apparence de chaque élément individuellement.

exemple de balise <a> ouvrant une fenêtre :

exemple de balise <a> pour une emote :

On peut noter que dans le dernièr exemple, le premier attribut href encapsule sa valeur par des " (guillement), le second attribut href, qui lui fait partie de la valeur du premier encapsule sa valeur dans ' (apostrophe). c'est normal est obligatoire ! Si on utilisait le même caractère d'encapsulation pour les deux attributs, le moteur de script comprendrait que le premier guillemet du second attribut href est le guillemet fermant du premier attribut href.

Il existe néanmoins une solution, utiliser le caractère d'échapement qui est \ avant le premier guillement du second attribut href.

par l'enfer, j'ai rien compris à l'encapsulation !

Rien de mieux qu'un exemple pour bien comprendre 👼.

Décryptage du script

1. - Text with good encapsulation : <font face='chat'>abc</font>, affichera « abc ».
2. - Text with escaped encapsulation : <font face=\"chat\">abc</font>, affichera « abc » bien que la valeur de l'attribut href englobant soit encaspulée par des guillemets.
3. - Text with bad encapsulation : <font face="chat">abc</font>, la valeur de l'attribut face étant simplement encaspulée par des guillements, le moteur de script considère que la balise <font> n'est rien d'autre que du texte et n'affiche pas la suite du scripts.

En jeu, on obtiendra :

La balise <br>

La balise <br> en HTML est utilisée pour insérer un saut de ligne, ce qui signifie que le texte ou le contenu qui suit sera affiché sur une nouvelle ligne. C'est comme appuyer sur la touche « Entrée » dans un traitement de texte. La balise <br> ne nécessite pas de balise de fermeture et est auto-fermante.

Petite précision concernant l'aspect auto-fermant de la balise : vous rencontrerez probablement cette balise sous la forme <br />, qui est sa forme moderne. Ce n'est pas une erreur, et dans les deux cas, elle fonctionnera comme prévu dans un script. Toutefois, il est préférable d'utiliser la forme <br> car elle économise deux caractères à chaque utilisation de cette balise dans un script.

exemple de balise <br> :

la balise <div>

La balise <div> en HTML est comme une boîte qui vous permet d'organiser votre contenu. Vous pouvez penser à <div> comme à un conteneur qui regroupe d'autres éléments HTML ensemble. Dans le contexte des scripts pour Age of Conan il n’est pas possible de lui donner une bordure visible ou encore un fond coloré, tout juste gérer l’alignement du texte contenu à l’aide de l’attribut :

• align : qui peut avoir pour valeur right, center ou left. Cette dernière étant la valeur par défaut.
• style : sert à changer l'apparence visuelle d'un élément HTML en lui appliquant des règles de style comme la couleur, etc. directement dans la balise. Cela permet de personnaliser l'apparence de chaque élément individuellement.

Pour le HTML moderne, <div> est sûrement l'une des plus utilisées pour structurer une page. En revanche, elle offre trés peu d'avantages, voir aucun, pour un script AoC. Donc personne ne vous en voudra, si vous ne l'utilisez pas 😉.

la balise <font>

Elle est utilisée pour changer la police, la taille et la couleur du texte à l'intérieur de cette balise.

ses attributs sont :

• color : Cet attribut permet de changer la couleur du texte. Il accepte un nom de couleur, mais le rendu peut varier selon l'interface utilisateur du joueur, qui peut avoir été personnalisée. De plus, certaines couleurs peuvent utiliser le même code couleur qu'une autre déjà existante. Consultez la page dédié aux couleurs dans les scripts pour AoC
• face : Cet attribut permet de personnaliser la police de caractère. Connaître les différentes polices de caractère.

exemple de balise <font> avec les différentes police de caractère :

la balise <img>

La balise <img> est utilisée pour afficher des images dans un script.

son attribut est :

• src : Ce champ contient le nom de l’image.
  • Le protocole ne peut être que rdb://, ce qui signifie qu’il n’est pas possible d’utiliser un protocole internet tel que http://, ou encore ftp://, ni même un protocole local de type file://. En d'autres termes, l’image doit provenir obligatoirement du jeu. De plus, cette balise fonctionne uniquement dans les fenêtres.

exemple de balise IMG :

Le bug des images à la première ouverture d'un script

On a tous à un moment ou un autre ouvert un script proposé par un joueur qui aura recommandé d'ouvrir le script deux fois pour voir les images qu'il contient. Il existe une technique pour éviter ce problème !

Pour afficher une image dès l'ouverture de la fenêtre, il faut la placer à côté du lien d'ouverture de la fenêtre dans le chat. Cela permet d'appeler l'image dès le début pour la rendre visible dans la fenêtre. Cependant, si l'on change de zone avec la fenêtre contenant l'image ouverte, il faudra alors la recharger 😢.

Cette méthode a un inconvénient : il faut utiliser deux fois la balise <img> pour une même image, ce qui peut alourdir le script et risquer de ne pas pouvoir l'afficher dans certains chats.

Mais pourquoi cette technique fonctionne ???

Je n'ai pas de certitude, mais étant donné qu'il faut ouvrir un script deux fois, il faut d'abord que le jeu charge l'image dans un cache temporaire, ce qui est fait par l'ouverture du script la première fois, pour l'afficher lors de la seconde ouverture.

Le débogage proposé fait cela automatiquement puisque l'image est d'abord chargée dans le chat, puis affichée lors de la première ouverture du script. En revanche, le cache semble temporaire puisque l'image n'est plus visible après un changement d'instance ou autre téléportations.

obtenir la liste des images du jeu

Pour trouver savoir se trouvent les images et leurs noms, c’est assez simple, le protocole rdb:// l'indique lui-même. Il faut regarder dans les fichiers portant l’extension *.rdb. Malheureusement, ces fichiers ne sont pas ouvrables à moins d’utiliser un logiciel de type RDB Extractor.

la balise <u>

Souligne une portion de texte.

exemple de balise <u> :

les cas de la mise en gras et de l’italique

Aucune balise autorisée dans AoC ne permet de mettre une portion de texte en gras ou en italique… Cela est implémenté directement sous forme de police de caractères qui est déjà en gras et/ou en italique.

Maintenant que l'on en a appris un peu plus sur les balises HTML, il est temps de passer à la suite :

• Les couleurs
• Les commandes
• Les emotes
• Les variables