Download a game version

Download a Dofus version from Ankama with Game Manager, understand every field of the download dialog, and follow the download until the version is installed.

Bots and the Game page work from game versions that Asterobot downloaded from Ankama's download servers. While Keep DOFUS up to date is on, Asterobot downloads and extracts the newest version by itself, with the dialog's default values, as When Dofus updates explains. Download one yourself for an older version, for more files, or with the switch off.

Open the download dialog

1. In the sidebar, open Game Manager.
2. Click Download a game.

The Download a game version dialog opens, already filled in for the Dofus that bots use. The same dialog opens from Add a game, on the Game tab of the Add a bot dialog.

The fields

Download stays greyed out until Version is filled in. Cancel closes the dialog without downloading.

Why the Windows build, on every system

Asterobot downloads the Windows build of Dofus whatever system it runs on, Linux and macOS included, and no other build can be downloaded at all.

Nothing runs the game, so this costs only disk space. The reason is where two of the files a bot reads live: Dofus_Data/StreamingAssets/aa/StandaloneWindows64/, a folder whose name is the build target Unity compiled for. A Linux install ships the same two bundles under StandaloneLinux64 and a macOS one under StandaloneOSX, and Asterobot reads neither. Everything else it needs sits under paths that are the same on all three, which is exactly what makes the mistake easy to make: a Linux download looks right until extraction reaches those two files.

Asking for anything else is refused, in Asteroboard and on the command line alike:

only the dofus/dofus3/windows build can be downloaded: bots read files whose path carries the Windows build target, on every host

A version downloaded for another platform before this refusal existed still shows in the table and can still be removed there. It can't be extracted: the attempt fails with 3.6.11.15 is installed for linux, but bots read the windows build on every host.

Check for updates, at the top of the dialog, fetches Ankama's list again, so the suggestions include what was published since. When Ankama can't be reached, the suggestions come from the lists Asterobot saved earlier. When Asteroboard can't reach Asterobot, it shows Couldn't check for updates, and you can still type the values yourself.

Version

The suggestions include every version found in the lists Asterobot saved, not only the newest one. The cytrus.keepMostRecentIndexes setting decides how many of these lists Asterobot keeps, and cytrus.keepMostRecentGamesManifests how many file lists it keeps for each game (Settings reference).

latest is resolved when you click Download: Asterobot asks Ankama for its current list and takes the newest version for the chosen game, platform and environment. If Ankama can't be reached, Asterobot uses the last list it saved. The table always shows the real version number, never latest.

File filter (regex)

The field starts with the pattern Asterobot uses for the files a bot needs: the game texts, the data tables, the map data, the world travel graph, the version file and a few sets of pictures. Keep it unless you know you need more. An empty field downloads the whole game. To add files to a version later, use Download more files in its menu rather than downloading it again (Manage game versions).

Fragment filter (regex)

Ankama splits each game version into named parts. This filter only keeps the files of the parts whose name matches, on top of the file filter. The field suggests win64 as an example. Leave it empty unless you have a reason to narrow the download.

A filter that isn't a valid regular expression makes the download fail, with a reason that mentions invalid file filter or invalid fragment filter.

Extract data after downloading

When it's checked, Asteroboard starts the extraction the moment the download finishes, exactly as if you clicked Extract data yourself (Extract game data). The box is checked when the dialog first opens. After you start a download, Asteroboard leaves it unchecked the next time you open the dialog, until you leave the page, so check it again when you want it.

Download a version you already have

Download a game doesn't download anything for a version already in the table as Queued, Downloading, Verifying or Installed: the filters are ignored and the version stays as it is. With Extract data after downloading checked, an installed version is extracted again. To add files to it, use Download more files. A version whose status is Failed is downloaded again, with the filters you give.

One download at a time

Downloads and file verifications wait in a single queue, and only one of them runs at a time, whatever the game or the version. The others show Queued until their turn. Extractions and the chunk check don't wait in that queue.

Follow the download

The version appears in the Game Manager table as soon as you click Download.

The counter counts chunks and rebuilt files, not bytes, so it gives an idea of the progress rather than a size. Once the download is done, the Game column shows the game's icon and name. With Extract data after downloading checked, the Extracted column then goes to Extracting and Extracted, and Ready turns to Ready for bot.

Closing Asteroboard doesn't stop a download, since it runs inside Asterobot. Stopping Asterobot does. When Asterobot starts again, a version interrupted that way shows Installed although files are missing, and its Ready column says Not ready. Open its menu, click Download more files and keep the default filter: the finished files are kept and only the rest is downloaded.

Asterobot doesn't check the free space on your disk before downloading. If the disk fills up, the download stops with Failed.

When a download fails

Game download problems covers more cases.

Download needed files for a bot

On the Game tab of the Add a bot dialog, and on a bot's Settings tab, Asteroboard checks the version selected under Game version and shows badges next to it:

• Compatible or Different version (Why Asterobot downloads Dofus);
• "Checking required files...", then Ready when the files a bot needs are on disk, or Missing required files with a Download needed files button;
• the extraction status, such as Not extracted, which you can click to extract the version.

Download needed files downloads only the missing files of that version, in the same queue as other downloads. When it's done, the badge turns to Ready. It doesn't extract the version: click the extraction badge once the download is finished. If the download fails, Asteroboard shows Couldn't download the required files.

As long as the version lacks its files or its game data, the tab says "This version needs both its game files and extracted data before a bot can connect with it". The same check is on the Information tab of the version's Game page, in the Required files card (Game page). Add a bot describes the rest of the dialog.

From the command line

Asterobot's gamemanager download command downloads a version without Asteroboard. Command line lists its options.

Where to go next

• Extract game data
• Manage game versions

Lire cette page en français