Installation de plugins

LeelaBot possède un système de plugins assez évolué, qui se trouve au coeur du bot et de ses préoccupations, car le bot repose sur le principe que toutes les commandes et les “facultés” du bot fassent partie d'un plugin (excepté les fonctions essentielles telles que celles permettant le maniement des plugins ou la définition des droits). Il est donc indispensable de savoir les installer, les configurer et les utiliser pour pouvoir profiter pleinement des capacités du bot.

Pour télécharger les plugins, il suffit de vous rendre sur la page de téléchargement des plugins.

Sélectionnez le plugin qui vous intéresse, puis téléchargez le dossier compressé (en tar.gz) dans le dossier de votre bot. Une fois ceci fait, extrayez-le avec le programme de votre choix dans le dossier racine du bot (attention, ne créez pas de sous-dossier, vous devez le faire fusionner avec les dossiers déjà présents) et vérifiez que tous les fichiers sont bien présents (comparez-les avec les fichiers présents dans l'archive).

Pour configurer le plugin, allez dans le dossier conf/plugins et modifiez le fichier .ini correspondant à votre plugin. Les indications de configuration sont normalement assez claires pour être compréhensibles par tout le monde.

Note : si vous souhaitez lancer le plugin au démarrage du bot, pensez à le rajouter dans le fichier de plugins au lancement (configuré dans conf/leelabot.ini, par défaut plugins_default.conf).

Ensuite pour le lancer (si vous ne l'avez pas mis dans les plugins de démarrage), il suffit d'exécuter la fonction !loadplugin <nom_du_plugin>, et ainsi votre plugin se chargera.

L'utilisation de chaque plugin dépend de lui-même, néanmoins quelques conseils marchent pour tous les plugins :

• Lisez la page de documentation (si elle existe) du plugin.

• Si elle n'existe pas, consultez l'aide in-game des commandes du plugin (commande !help <commande>)

• Dans les autres cas, n'hésitez pas à demander de l'aide aux personnes sur IRC (#LeelaBot sur Quakenet) ou sur le forum.

Si vous arrivez à vous servir d'un plugin mais qu'il n'y a pas de page de documentation sur celui-ci, pensez à remercier la communauté en créant sa page de documentation (pensez à être précis, clair et à ne pas faire de fautes, il y a des gens qui vous liront).