TorchCraft - A bridge between Torch and StarCraft

TorchCraft

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 .

Installation

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 installBWAPI,copy a few files, and either launch theAIModule (DLL) OR launch theAIClient (EXE).

You can also run StarCraft on Linux through Wine, but this may be a bit more complicated, start withBWAPI on Linux.

Running TorchCraft

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.

DLL/AIModule TorchCraft Windows Open bwapi.ini and set ai = PATH\TO\BWEnv.dll (or copy ours from config/bwapi.in ) Start ChaosLauncher, enable BWAPI DLL Injector [Release] . Press Start . Linux Run $ cd examples $ th simple_dll.lua EXE/AIClient TorchCraft Windows Start BWEnv.exe . Linux Run $ cd examples $ th simple_exe.lua Citation

Please 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} } Contribution