Setting up Hax

Here are some instructions on how to get started and try out Hax.

If any step or term is not clear, try to search the internet  for it or ask in the comments.

Download

1. Go to the Hax download page, the link is on the right side of this page.
2. There, carefully read the disclaimer containing the license terms. 
3. Be sure to understand and agree with the terms. 
4. Download the zip file containing the Hax binaries and tutorial.
5. To make sure you have the correct file, you can verify its MD5 checksum against the one contained in the published MD5 file. Search on the internet if you do not know how to do this.

Install

1. Make sure you have Java version 1.7 or higher installed on your system and the Java executable on your system path. Simply open up a system console and type "java -version". If the command succeeds and displays a version of 1.7 or higher, you are good to go.
2. Unpack the downloaded zip file to a directory/folder of your choice. You have to create the directory/folder first. Be sure to choose to preserve the directory structure upon unpacking.
3. For convenience, you can add the Hax executable to your path (bin/hax.sh or bin/hax.bat, depending on your operating system). Otherwise you will have to always type the whole path to the Hax executable when starting a custom datacenter. If you only want to use the built in datacenters (e.g. tutorial or Dark Signs campaign), you do not need to do this. For these, there are specific executables in the main directory/folder which can be used to start them.

Run

1. Open up the directory/folder where you unpacked Hax and read the README file. It gives you some instructions and tells you what to start with.
2. Simply start one of the Hax datacenter executables (one of the .sh or .bat files, depending on your operating system) from the directory/folder where you unpacked Hax. No arguments are needed, Hax reads all configuration from the directory/folder where the datacenter resides.
3. If all goes well, you should see a user interface window containing one or more tabs with consoles. Each of the tabs is a terminal console of a machine inside the launched datacenter. Now you can start typing commands to the consoles.

Help and Bugs

If you need any help with Hax or find a bug, feel free to join the Hax discussion group and post a question or bug report. You can find the link to the discussion group on the right side of this page.