When something doesn't work and these docs don't solve it, other players and the Asterobot team can help. Tell them what you did and what you saw, and keep a few files and values to yourself.
Where to ask
| Where | Address | What it's for |
|---|---|---|
| Help | https://asterobot.net/help | Guides and answers for using Asterobot. |
| The forum | https://asterobot.net/forums/ | Asking for help and talking with other players, in threads others can find later. |
| Discord | https://discord.asterobot.net | Joining the community to ask questions and chat. |
| The status page | https://status.asterobot.net | Checking whether asterobot.net has an outage before you report one. |
Asteroboard's About page has a card for Help, Discord and the status page. When Asteroboard shows Page not found or Something went wrong, its Get help button opens that page too.
Before you ask
- Check the status page. A sign-in code that won't go through or a marketplace preview that fails is often an outage on asterobot.net.
- Look for the exact message you got in the troubleshooting pages and in the FAQ.
- Make sure you run the latest Asterobot. When a newer version is out, Asterobot says so as it starts (Messages and updates).
What to put in your message
The more of this you give, the faster someone can help:
- Your Asterobot version. It's on Server > Status, in the Version row, and on the first line Asterobot prints when it starts, right after the word
Asterobot. - Your Asteroboard version: the number at the top of the sidebar, also written on the About page after "Asteroboard version".
- Your system and processor: the name of the archive you downloaded, such as
Asterobot_1.4.0_windows_amd64.7z, or the OS and Architecture values on Server > Status. - The game version of the bot, as Game Manager shows it, and whether its Compatibility column says Compatible or Different version.
- How the bot connects: Full socket mode or MITM mode, and the package it plays with its version, if any.
- What you did, what you expected, and what happened instead, step by step.
- The exact error text, copied rather than retyped. A screenshot of the notification or the dialog helps too.
- The log lines around the problem, from the terminal or from Server > Console. If someone asks for more detail, set the log level to
DEBUG, do the same thing again and copy the new lines. Status and console shows how. - The bot's console, when the problem is about one bot: Copy what's shown on its Console tab copies the lines you see (Console).
If Asteroboard showed Page not found or Something went wrong, open its Technical details panel and include the Status and the Requested address.
What you must never share
Caution
Nobody helping you needs any of the following, whatever they say. Anyone who gets one of them can use your accounts.
| Never share | Why |
|---|---|
| Your Ankama password and your asterobot.net password | They give full access to those accounts. |
config.toml |
It holds website.token, the sign-in Asterobot uses on asterobot.net, and the logins and passwords of server.basicAuth in plain text. |
The value of website.token |
It gives access to your asterobot.net account without your password. |
accounts.toml |
It holds your Ankama Login IDs, the passwords you stored in plain text, and the tokens Ankama gave Asterobot. |
The zaapmanager/browser-profiles folder |
Each profile holds a live Ankama session. |
| Asterobot's data folder, or a copy of it | It contains accounts.toml, the browser profiles and your bots. |
| The link you copy during a manual Ankama sign-in | It carries a one-time code that Asterobot trades for the account's sign-in. |
A session's game ticket, session.gameToken, if a script prints it |
It's what a stranger would need to take over the game session. |
Files and folders shows where these files are.
A few habits keep screenshots and pasted logs safe:
- On Server > Config, the values of
website.tokenandserver.basicAuthare hidden. Don't click the eye button next towebsite.token, or Edit as JSON onserver.basicAuth, while you take a screenshot: both show the real values. - Read log lines before you post them, and remove anything that looks like a password, a token or a link carrying a code.