Asterobot is a program you run on your own computer to run bots for Dofus 3. It works on Windows, macOS and Linux, and you control it from Asteroboard, a web interface that opens in your browser.
Caution
Using bots breaks Ankama's terms of use, and Ankama can sanction the accounts involved, whichever way the bot connects. Read Accounts and safety before you use Asterobot with an account you care about.
What you can do with it
Run bots without a game client
In Full socket mode, a bot signs in with an Ankama account you stored in Asterobot and talks to Ankama's servers directly, the way the game itself does. No Dofus window is open. One computer can run several of these bots, each with its own Ankama account.
Follow the game you play
In MITM mode, short for man-in-the-middle, you start Dofus from the Ankama Launcher and play as usual, and a bot joins your game session. From Asteroboard you can read your chat and your inventory, watch the messages your game exchanges with the servers, and give the bot a package that reacts to what happens. You don't give Asterobot your Ankama login or password for this.
Run packages
What a bot actually does comes from a package: a small JavaScript program installed in your library. You can download packages other players share on the marketplace at asterobot.net, or write your own in the editor built into Asteroboard.
Explore the game's data
Asterobot downloads Dofus's game files from Ankama and extracts what's inside them: items, monsters, maps, texts and more. The Game page in Asteroboard lets you browse the world map, inspect a map cell by cell, search the game data or query it in SQL, look up the game's texts and listen to its music. None of that needs a bot.
Watch and send messages
Every bot has a network panel. It lists the messages you chose to follow as they arrive, with their fields, and it lets you send a message yourself, either to the server or to the game client.
What it doesn't do on its own
Asterobot gives a bot a connection. It doesn't give it a goal. A bot with no package connects and does nothing more: no fighting, no harvesting, no answering other players. All of that comes from a package, one you install or one you write.
Full socket mode has one more gap you need to know about. Asterobot signs the bot in, picks a game server and opens the connection to it, but it doesn't identify the bot on that server, so the bot never enters the game with a character. That part is the job of a connection script, a package that runs when the bot connects. MITM mode doesn't need one, because the Dofus client you play has already done it.
Note
Coming soon. Ready-made connection scripts are on their way. Until then, use MITM mode, or write your own connection script with the developer docs.
Who it's for
Asterobot is for Dofus players who want to automate part of their game, or who want to see what their game really does. You don't need to write code to use it: running a bot in MITM mode, installing a package from the marketplace and changing its settings all happen in Asteroboard. If you do write JavaScript, the developer docs cover everything a package can do.
You can also use Asterobot without ever running a bot, just to look things up on the world map or in the game data.
Where to go next
- The three parts explains how Asterobot, Asteroboard and asterobot.net fit together.
- Full socket and MITM helps you choose how your bots connect.
- Requirements lists what you need before you download anything.