TorchCraft

Мост между Torch и StarCraft.

Общий обзор системы (и мотивов использования TorchCraft) можно найти в:

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.

Установка

Пожалуйста, следуйте инструкциям по установке (docs/user/installation.md).

Вам потребуется лицензия StarCraft: Brood War.

Наиболее проверенный и стабильный способ настроить всё — это запустить StarCraft на Windows и Torch на Linux или Mac OS X. Если у вас уже есть StarCraft, вам нужно установить BWAPI, скопировать несколько файлов (docs/user/installation.md#torchcraft-common-prerequisites) и либо запустить AIModule (DLL), либо запустить AIClient (EXE).

Вы также можете запустить StarCraft в Linux через Wine, но это может быть немного сложнее, начните с BWAPI на Linux.

Запуск TorchCraft

См. examples/ для списка скриптов, которые вы можете попробовать. Простейшие примеры представлены в двух вариантах: основанные на DLL/AIModule и основанные на EXE/AIClient. Во всех случаях $server_ip — это IP-адрес машины, на которой запущен StarCraft.

DLL/AIModule TorchCraft

Windows

1. Откройте bwapi.ini и установите ai = PATH\TO\BWEnv.dll (или скопируйте наш из config/bwapi.in).
2. Запустите ChaosLauncher, включите BWAPI DLL Injector [Release].
3. Нажмите Start.

Linux

1. Выполните команду:

$ cd examples
$ th simple_dll.lua -t $server_ip

EXE/AIClient TorchCraft

Windows

1. Запустите BWEnv.exe.

Linux

2. Выполните команду:

$ cd examples
$ th simple_exe.lua -t $server_ip

Цитирование

Если вы используете TorchCraft в своей работе, пожалуйста, цитируйте статью arXiv:

@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}
}

Вклад

Смотрите Contributing.