Catégorie:Addons

Les Addons sont des parties de code permettant de créer de nouvelles interfaces dans le jeu, pour simplifier certaines fonctions, ou pour créer de nouvelles fonctions qui peuvent être utiles à une guilde par exemple. Si vous souhaitez uniquement automatiser deux trois compétences en un bouton, reportez-vous à la page sur les Macros.

Généralités

Tout comme pour les Addons installés, vous devez placer vos créations dans le dossier interface/AddOns de Runes of Magic. Ce dossier est à créer s'il n'existe pas. Votre Addon sera lui-même placé dans un sous-dossier dans ce répertoire.

Un Addon contient trois types principaux de fichiers. Les fichiers toc, les fichiers lua, et les fichiers xml. Tout Addon fonctionnant doit au minimum posséder un fichier toc, et un fichier lua.

Fichiers Toc

Le fichier toc devra porter le même nom que le dossier de votre Addon. Par exemple, si votre Addon se trouve dans un dossier TestAlpha, le fichier toc sera TestAlpha.toc.

Ce fichier sert à spécifier quels sont les autres fichiers employés par l'addon, et donc à les charger. Il est également possible de mettre en commentaire des choses comme le nom de l'auteur, le numéro de version, etc.

Le contenu d'un fichier Toc ressemble à ceci :

## Title: TestAlpha
## Version: 0.1
## Notes: Exemple simple de fichier Toc
## Author: Agenusha

TestAlpha.xml
TestAlpha.lua
TestAlpha2.xml
TestAlpha2.lua

Les instructions précédées de deux dièses sont des commentaires, tandis que les noms de fichier en-dessous sous les fichiers chargés. Le minimum requis étant un fichier lua, il faut donc avoir au moins une ligne après les commentaires.

Fichiers Lua

Les fichiers Lua sont les fichiers contenant le code, qui est similaire aux instructions inscrites après la commande /run dans les macros. Pour plus d'informations sur le fonctionnement du Lua, consultez la page Syntaxe du Lua.

Ce sont ces fichiers qui contiendront vos fonctions, qui seront appelées dans le jeu. Un fichier pourrait ressembler à ceci :

function ExempleA(msg)
  DEFAULT_CHAT_FRAME:AddMessage(msg)
end

function ExempleB(msg)
  SendChatMessage(msg, "guild")
end

Le fonctionnement des fonctions et des événements sera détaillé plus bas.

Fichiers XML

Ces derniers fichiers servent à définir l'interface utilisateur, à savoir les fenêtres qui permettent d'interagir avec l'addon. Le XML prenant beaucoup de place, aucun exemple ne sera donné pour le moment. Pour comprendre le fonctionnement du XML, consulter la page Syntaxe du XML pour apprendre les bases, ainsi que la page Éléments XML pour connaître en détail le fonctionnement de chaque élément.

Appeler un Addon dans le jeu

Une fois vos fonctions créées, vous pourrez simplement les appeler en tapant /run XXXX, où XXXX correspondra à la fonction créée.

Actualisation des Addons

Il est tout à fait possible de réactualiser les addons chargés après une modification, sans avoir à redémarrer le jeu. Il suffit pour cela d'utiliser la commande /run ReloadUI(). Un écran de chargement apparaîtra, et vous resterez au même endroit, avec les addons rechargés. Cependant, notez que vous serez déconnecté de tous vos canaux privés. Il peut être utile de créer une macro vous permettant de les rejoindre en un clic.