Un paquet est du code écrit par quelqu'un d'autre, qui s'exécute avec la session de jeu de votre bot. Avant de lancer un paquet que vous n'avez pas écrit, sachez à quoi il a accès.
Ce qu'un paquet peut faire
Quand un bot lance un paquet, son script peut faire tout ce qui suit. Cela vaut aussi pour les paquets dont il dépend, puisque leur code s'exécute dans le même script.
| Il peut | Ce que cela signifie pour vous |
|---|---|
| Envoyer n'importe quel message au serveur de jeu | Il agit à la place de votre personnage : se déplacer, combattre, écrire dans le chat, échanger, vendre, détruire des objets. Tout ce que le client Dofus peut demander au serveur, le script peut le demander aussi. |
| Lire ce que le jeu envoie | Votre chat, votre inventaire, les joueurs et les monstres autour de vous, et tout ce que le serveur envoie d'autre au bot. |
| Modifier ou bloquer des messages sur un bot en mode MITM | En mode MITM, pour « homme du milieu » (man-in-the-middle), le bot se place entre votre client Dofus et le serveur. Le script peut modifier ou supprimer ce que votre client envoie avant que le serveur ne le reçoive, et ce que le serveur envoie avant que votre client ne l'affiche. Il peut aussi envoyer des messages à votre client comme s'ils venaient du serveur. |
| Lire le ticket de jeu de la session | Ce ticket est ce dont un inconnu aurait besoin pour prendre le contrôle de la session de jeu. |
| Fermer la connexion au jeu | Sur un bot en mode MITM, cela déconnecte la partie que vous êtes en train de jouer. |
| Lire les données de jeu | Objets, monstres, cartes et textes de la version de jeu du bot. |
| Écrire dans la console du bot et dans le journal d'Asterobot | Les lignes que vous lisez dans l'onglet Console du bot ou dans Serveur > Console. |
| Ajouter des réglages et des actions | Des champs et des boutons dans l'onglet Réglages du bot. |
Caution
Tout ce qu'un paquet fait en jeu, il le fait avec votre compte Ankama. Ne lancez que des paquets d'auteurs en qui vous avez confiance, et gardez à l'esprit qu'utiliser des bots enfreint les conditions d'utilisation d'Ankama. Voir Comptes et sécurité.
Ce qu'un paquet ne peut pas faire
| Il ne peut pas | Détails |
|---|---|
| Utiliser des fichiers | Un script ne peut rien lire ni écrire sur votre ordinateur : ni vos réglages, ni vos comptes Ankama enregistrés, ni les autres paquets. Le seul code qu'il peut charger est celui de son propre paquet et celui des paquets dont il dépend. |
| Utiliser internet | Aucune requête web et aucune connexion propre. La connexion au jeu du bot est la seule par laquelle il communique. |
| Atteindre les autres bots | Chaque bot exécute sa propre copie du script. Un script ne peut ni voir ni contrôler un autre bot. |
| Lire vos identifiants Ankama | Un script reçoit la session de jeu, pas le compte. Il ne reçoit jamais l'identifiant ni le mot de passe enregistrés dans le Gestionnaire de comptes. |
| Contrôler Asterobot | Il ne peut pas installer de paquets, changer les réglages du bot ni les réglages du paquet, ni connecter ou déconnecter d'autres bots. |
Installer un paquet n'exécute rien de son code. Le paquet s'exécute quand un bot le lance. Son code de premier niveau s'exécute aussi, sans aucun accès au jeu, chaque fois qu'Asterobot lit les réglages du paquet : dans Ajouter un bot, dans l'onglet Réglages d'un bot, et quand un bot le démarre.
Un script s'exécute aussi dans certaines limites. Par exemple, un code qui travaille plus de 250 ms sans marquer de pause met fin au script. Les auteurs trouveront la liste dans Limites et le détail de ce à quoi les scripts ont accès dans Ce que les scripts peuvent faire.
Comment Asterobot vérifie les paquets du marché
Quand Asterobot installe un paquet depuis le marché, il enregistre une empreinte des fichiers du paquet. Ensuite, à chaque chargement du paquet (quand un bot le démarre, quand vous le chargez, quand ses réglages sont lus et quand un paquet qui en dépend est chargé), Asterobot compare les fichiers à cette empreinte. Si quoi que ce soit a changé, il refuse le paquet avec package source integrity mismatch.
Un paquet du marché reste donc sur votre ordinateur exactement tel qu'il a été téléchargé. Modifier ses fichiers à la main le rend inutilisable, et Asteroboard ne vous laisse pas non plus le modifier : Modifier le code et Copier vers une nouvelle version ne sont pas proposés pour lui.
Quand la vérification échoue, Lancer indique seulement Impossible de démarrer le comportement. L'onglet Réglages du bot, sous Réglages du paquet, affiche l'erreur complète. Pour corriger le problème, supprimez le paquet et installez-le à nouveau depuis le marché.
La vérification prouve que les fichiers sont ceux que vous avez téléchargés. Elle ne dit rien de la sûreté du code de l'auteur. Les paquets que vous créez, copiez ou importez depuis un fichier .zip n'ont pas d'empreinte.
Les permissions sont déclarées, pas imposées
Un paquet peut lister des permissions dans son manifeste, comme gamedata. Elles apparaissent sur la page du paquet, sous Permissions dans la fiche Manifeste, ou « Aucune permission déclarée. » quand il n'y en a pas.
Pour l'instant, elles ne sont que la description, faite par l'auteur, de ce que le paquet utilise. Asterobot ne les fait pas respecter : un paquet qui ne liste aucune permission peut quand même faire tout ce que contient le tableau ci-dessus.
Note
Bientôt disponible. Asterobot fera respecter les permissions qu'un paquet liste. D'ici là, ne comptez pas sur elles pour limiter ce que fait un paquet.
Les auteurs peuvent lire Permissions.
Officiel et communautaire
Les paquets marqués Officiel viennent de fichiers du marché qu'asterobot.net marque comme officiels, et s'installent sous un nom qui commence par @asterobot:. Les paquets marqués Communautaire viennent de fichiers publiés par des membres d'asterobot.net, sous un nom formé du nom de l'auteur et du titre du fichier.
Les deux badges viennent du nom du paquet, et un paquet importé depuis un fichier .zip reçoit le nom que vous saisissez. Un tel paquet peut afficher Officiel ou Communautaire sans jamais venir du marché. Pour être sûr de l'origine d'un paquet, ouvrez sa page : seul un paquet installé depuis le marché a une ligne Source, et son bouton Voir sur asterobot.net ouvre le fichier depuis lequel il a été téléchargé.
Avant de lancer un paquet
- Lisez la page du fichier sur asterobot.net : qui l'a publié et ce que le paquet est censé faire.
- Sur la page du paquet dans le Gestionnaire de bibliothèque, regardez ses Dépendances. Leur code s'exécute aussi.
- Lisez le code si vous le pouvez. Modifier le code ouvre un paquet local, et Exporter vous donne les fichiers de n'importe quel paquet sous forme de
.zip. - Lancez-le en le surveillant : gardez la Console du bot ouverte, et cliquez sur Arrêter dès que le bot fait quelque chose d'inattendu.