A bridge between Torch and StarCraft.
A general overview of the system (and motivations for using TorchCraft) can be found in:
Synnaeve, G., Nardelli, N., Auvolat, A., Chintala, S., Lacroix, T., Lin, Z., Richoux, F. and Usunier, N., 2016. TorchCraft: a Library for Machine Learning Research on Real-Time Strategy Games - arXiv:1611.00625.
Please follow the installation instructions.
You will need to have a license of StarCraft: Brood War.
The most tested and stable way to set it up is to have StarCraft running on Windows and Torch running in Linux or Mac OS X. If you already have StarCraft, you need to install BWAPI, copy a few files, and either launch the AIModule (DLL) OR launch the AIClient (EXE).
You can also run StarCraft on Linux through Wine, but this may be a bit more complicated, start with BWAPI on Linux.
See examples/ for a list of scripts that you can try.
The simplest examples come in two flavors: DLL/AIModule based and EXE/AIClient
based. In all cases, the $server_ip is the ip address of the machine running
StarCraft.
- Open
bwapi.iniand setai = PATH\TO\BWEnv.dll(or copy ours fromconfig/bwapi.in) - Start ChaosLauncher, enable
BWAPI DLL Injector [Release]. - Press
Start.
- Run
$ cd examples
$ th simple_dll.lua -t $server_ip- Start
BWEnv.exe.
- Run
$ cd examples
$ th simple_exe.lua -t $server_ipPlease cite the arXiv paper if you use TorchCraft in your work:
@article{synnaeve2016torchcraft,
title={TorchCraft: a Library for Machine Learning Research on Real-Time Strategy Games},
author={Synnaeve, Gabriel and Nardelli, Nantas and Auvolat, Alex and Chintala, Soumith and Lacroix, Timoth{\'e}e and Lin, Zeming and Richoux, Florian and Usunier, Nicolas},
journal={arXiv preprint arXiv:1611.00625},
year={2016}
}
See Contributing