Skip to content

Install Guide

Jump to bottom
Vincent Koeman edited this page Sep 29, 2020 · 97 revisions

Requirements

Required: Windows (XP or up)

If you do not have Windows, see VirtualBox installation and then follow the entire procedure below in the virtual machine.

Installation

WARNING: virus scanners like Immunet, Windows Defender and Windows SmartScreen may give warnings and even throw away downloaded files; both StarCraft and the connector might be suspected. You may therefore have to disable virus scanners for this installation.

  1. Install the GOAL plugin for Eclipse
  2. Install StarCraft: Brood War 1.16.1 (warning: installer makes noise...)
  3. Extract the Chaoslauncher directory from BWAPI 3.7.5 to your StarCraft installation folder (C:\Program Files (x86)\Starcraft by default). In the created directory (e.g. C:\Program Files (x86)\Starcraft\Chaoslauncher), remove the five consecutive files ending with a d (e.g. BWAPI_ChaosLauncherInjectord.bwl, BWAPId.dll, etc.).
  4. Extract the contents of the sscai directory from the SSCAIT Map Collection to the Maps directory of your StarCraft installation folder.
  5. Download the Starter_Pack.zip from the latest Connector Release and unzip this somewhere.
  6. Start Eclipse and switch to the GOAL perspective.
  7. Import one of the example projects from the Starter Pack as follows:
  • File > Import
  • GOAL Agent Programming > Existing GOAL project
  • Browse to the directory where you unpacked the Starter_Pack.zip
  • Select a mas2g file from one of the examples (i.e. one of the different races) and click Open
  • Click Finish
  • Open the example mas2g file in your workspace
  1. Run (or debug) the example mas2g file.
  2. You may see an in-game message saying: "Failed to load: AI module = NULL", this can be ignored. You should also uncheck 'Show Tips at Startup' and press OK the very first time you play a game.
  3. For further reading, the environment manual can be found in the starter pack or here. Don't forget about the various GOAL documentation that is available here either.

TIP: if StarCraft hangs on showing the tip box, stop your agent-system in Eclipse, uncheck 'Show Tips at Startup', and cleanly shutdown StarCraft (and the Chaoslauncher afterwards). Now re-run, and everything should be fine!

Clone this wiki locally