Ce tutoriel mène un paquet du marché d'asterobot.net jusqu'à votre bot, puis le lance pendant que vous suivez ce qu'il fait. Il utilise le bot MITM (« homme du milieu », de l'anglais man-in-the-middle) de Votre premier bot : mettez-le en place d'abord si ce n'est pas encore fait.
Caution
Un paquet agit comme votre personnage : il peut envoyer n'importe quel message au serveur de jeu en votre nom. Lisez Faire confiance à un paquet avant d'en lancer un, et gardez en tête qu'utiliser des bots enfreint les conditions d'utilisation d'Ankama (Comptes et sécurité).
1. Choisir un paquet
- Ouvrez le marché, https://asterobot.net/files/category/10-library/.
- Ouvrez la page d'un paquet qui vous intéresse, et lisez ce qu'il fait, ce dont il a besoin selon son auteur, et qui l'a publié.
- Copiez l'adresse de la page depuis votre navigateur.
2. L'installer
- Dans Asteroboard, ouvrez le Gestionnaire de bibliothèque et cliquez sur Télécharger un paquet.
- Collez l'adresse dans ID ou URL du fichier, puis cliquez sur Prévisualiser.
- Vérifiez la carte. Officiel ou Communautaire indique si asterobot.net marque le fichier comme officiel, et S'installera sous donne le nom et la version que le paquet aura dans votre bibliothèque.
- Cliquez sur Installer.
Paquet installé apparaît, et le paquet obtient une ligne dans le Gestionnaire de bibliothèque, avec ses dépendances s'il en a. Si un message apparaît à la place, Installer depuis le marché l'explique.
3. Le confier à votre bot
- Mettez votre bot en ligne : sur sa page, cliquez sur Commencer l'attente, puis lancez Dofus, connectez-vous et entrez en jeu avec votre personnage. L'état passe à Connecté au serveur de jeu.
- Ouvrez l'onglet Réglages du bot. Il s'ouvre sur Configuration du bot.
- Sous Paquet, choisissez le paquet que vous avez installé, listé sous la forme
name@version. - Cliquez sur Enregistrer. Asteroboard affiche Réglages enregistrés, et l'en-tête du bot affiche maintenant le paquet.
Le bot garde désormais ce paquet, même après un redémarrage. Lancer un paquet montre les autres façons d'en choisir un.
4. Modifier ses réglages
- Toujours dans Réglages, cliquez sur Réglages du paquet, à côté de Configuration du bot.
- La première carte appartient à votre paquet, et elle est ouverte. Ses champs et leurs descriptions viennent du paquet.
- Modifiez une valeur. Non appliqué apparaît sur le titre de la carte.
- Cliquez sur Appliquer. Une notification confirme que les réglages du paquet sont appliqués.
Si la section indique « Ce comportement ne déclare ni réglage ni action. », le paquet n'a rien à ajuster : passez à l'étape suivante. Réglages et actions d'un paquet couvre tous les types de champ, et ce qui se passe quand une valeur est refusée.
5. Lancer et suivre
- Dans l'en-tête du bot, cliquez sur Lancer. Le bouton devient Arrêter : le script du paquet tourne.
- Ouvrez l'onglet Console. Les lignes des sources Asterobot et Script apparaissent au fur et à mesure qu'elles sont écrites. Pour ne suivre que le script, ne gardez que Script coché sous Sources.
- Jouez comme d'habitude, ou laissez le paquet faire son travail, et suivez la console.
Les réglages que vous appliquez pendant que le script tourne lui parviennent immédiatement, sans redémarrage. Qu'il en tienne compte tout de suite dépend de la façon dont le paquet est écrit.
Si Lancer reste grisé, le bot n'est pas encore connecté à une partie. Si Impossible de démarrer le comportement apparaît, ou si l'alerte Le comportement s'est arrêté sur une erreur s'affiche en haut de la page, voir Lancer un paquet.
Quand vous quittez Dofus, la session relayée prend fin et le script s'arrête avec elle, avec Le comportement s'est arrêté sur une erreur. Cliquez de nouveau sur Lancer la prochaine fois que vous êtes en jeu.
6. Arrêter
- Cliquez sur Arrêter dans l'en-tête du bot. Le script se termine et le bot reste connecté : votre partie continue normalement.
- Quand vous avez fini de jouer, quittez Dofus. Le bot revient à En attente de votre client de jeu. Pour qu'il cesse d'attendre, cliquez sur Déconnecter.
La prochaine fois, cliquez sur Commencer l'attente, entrez en jeu et cliquez sur Lancer : le bot a toujours le paquet et ses réglages.
Pour aller plus loin
- Mettre à jour les paquets, quand l'auteur publie une nouvelle version.
- Console, pour tout ce que la console permet de filtrer et de copier.
- Documentation développeur, pour écrire votre propre paquet.