Asterobot runs in a terminal window and opens Asteroboard in your browser as it starts. You need the program unpacked as described in Download Asterobot.
Start Asterobot
On Windows
Double-click asterobot.exe. A terminal window opens, and Asterobot runs inside it.
Tip
If Asterobot stops right after starting, its window closes before you can read why. Start it from PowerShell instead, in the folder where you put it, and the messages stay on screen:
.\asterobot.exeOn macOS and Linux
Open a terminal in the folder where you put Asterobot and run:
./asterobotCommands and version
Running Asterobot without a command starts it normally, exactly like ./asterobot server. The program also has commands for other jobs, such as downloading a game version or resetting the settings, all listed in Command line.
To see which version you have without starting it, run ./asterobot --version (.\asterobot.exe --version on Windows). The last line it prints reads Asterobot version followed by the version number.
What the terminal shows
Asterobot writes what it's doing to the terminal, one line at a time, starting with a line that gives its version and the website's address. On a first launch, these are the lines worth looking for:
| Line | What it means |
|---|---|
Bots restored from config |
Asterobot loaded your saved bots. On a first launch, there are none. |
Server listening |
Asterobot is ready at the address that follows: 127.0.0.1:8080 by default. |
Website sign-in required. Please visit this link to authorize access to your account; the app will continue automatically once authorized. |
Asterobot isn't signed in to asterobot.net. The next line is the link to open. |
Website sign-in completed |
You confirmed the sign-in on asterobot.net. |
An Asterobot update is available |
A newer version is published on asterobot.net. The line ends with its version number and its link. |
Failed to open frontend |
Asterobot couldn't open your browser. Open Asteroboard yourself, as explained below. |
Asterobot prints other lines as well. Status and console explains how much it prints and how to change that.
Asteroboard opens
Once it's ready, Asterobot opens your browser at http://127.0.0.1:8080. That address sends the browser on to https://asteroboard.asterobot.net with Asterobot's address attached, which is how Asteroboard knows where to connect. Asteroboard saves the address as its Server URL, removes it from the address bar, and shows Server connected once it has reached Asterobot.
If no browser window opens, go to http://127.0.0.1:8080 in your browser yourself. If you'd rather Asterobot never opens the browser when it starts, turn on the server.skipOpenFrontend setting on Server > Config.
On a first launch, a second tab opens on asterobot.net at the same time. That's Asterobot asking you to sign in: Sign in with asterobot.net explains what to do there.
What Asterobot creates on your computer
On its first launch, Asterobot creates its folders in your user profile, for its settings (a config.toml file, empty for now), its data and its cache. On Linux, those are three separate folders. On Windows, the data and the cache share one folder, and on macOS, the settings and the data do. They stay when Asterobot stops, and it finds everything in them the next time it starts. Files and folders shows where they are on each system.
Keep it running
Asterobot only works while it runs. Leave its terminal window open for as long as you use your bots: you can minimize it, but closing it ends Asterobot. Closing Asteroboard, on the other hand, doesn't stop anything, as The three parts explains.
Stop Asterobot
Stop Asterobot from its terminal or from Asteroboard. Both ways let it close things properly: it disconnects your bots, and puts back the line it may have changed in your Dofus folder for MITM mode, where a bot joins the game you play.
From the terminal
Press Ctrl+C in Asterobot's terminal window. Asterobot prints Shutting down server, closes everything and exits.
From Asteroboard
- In the sidebar, click Server. The Status tab opens.
- In the Shutdown card, click Shutdown server.
- In the Shutdown the server? dialog, click Yes, shutdown.
Asteroboard shows Shutdown requested, and Asterobot stops about two seconds later. Asteroboard then shows Server disconnected.
Important
Asteroboard can't start Asterobot again. After a shutdown, you need access to the computer Asterobot runs on to start it.
Closing the terminal window also ends Asterobot, but it may not get the chance to close things properly. If it left your Dofus folder changed, it puts it back the next time it starts.
Start it again
Start Asterobot the same way as the first time. What you set up is still there:
- Asterobot is still signed in to asterobot.net, so you don't need a new code.
- Your bots come back, disconnected. Nothing reconnects or starts playing on its own: you bring each bot online again from Asteroboard. See Disconnect, delete and restart.
- Your browser opens Asteroboard again, unless you turned on
server.skipOpenFrontend.
If Asterobot stops right away with An error occurred during the server's initialization process, it couldn't use its address, for example because another copy of Asterobot is already running. Asteroboard can't connect helps you sort it out.