Установка TorchCraft

TorchCraft состоит из двух частей:

• Сервер — процесс, который выполняется вместе со StarCraft (здесь мы создаём экземпляр ZMQ-сервера).
• Клиент — объект TorchCraft на Lua / C++ / Python, который потребляет данные (состояние) с сервера и отправляет команды (действия).

Установка TorchCraft зависит от вашей платформы и от того, используете ли вы AIClient или AIModule.

NOTA BENE: В настоящее время не поддерживается StarCraft 1.18 — см. bwapi/bwapi#710.

Windows Server

Системные требования

• Windows 7 (XP и 8.1 не поддерживаются, но должны работать, 10 не работала в нашем последнем тесте).
• Visual Studio 2013 (для разработчиков / участников достаточно версии Community).
• Starcraft (см. ниже инструкции по установке).
• BWAPI (см. ниже инструкции по установке).

Установка

StarCraft (1.16.1)

• Зарегистрируйтесь на http://battle.net/.
• Купите лицензию на https://battle.net/shop/en-us/product/starcraft.
• Загрузите игру на странице https://battle.net/account/management/.
• Запустите setup.exe и установите игру в какую-либо папку.
  • Теперь $STARCRAFT будет каталогом установки.
• Скачайте патч 1.16.1 на странице https://battle.net/support/en/article/classic-game-patches.
  • Убедитесь, что вы скачали патч Brood War.
• Установите патч.

  Патч должен быть обнаружен автоматически, но если это не так, убедитесь, что указали правильную папку.

• Войдите в игру и создайте персонажа.
  • Одиночная игра → Расширение, И
  • Многопользовательская игра → Расширение → Локальный ПК
• Наслаждайтесь игрой :)

BWAPI

• Скачайте последнюю версию на странице https://github.com/bwapi/bwapi/releases.
• Установите её в $STARCRAFT\BWAPI.

TorchCraft, общие предварительные условия:

• Скопируйте $STARCRAFT/TorchCraft/config/bwapi.ini в $STARCRAFT/bwapi-data/bwapi.ini.
• Скопируйте $STARCRAFT/TorchCraft/config/torchcraft.ini в $STARCRAFT/bwapi-data/torchcraft.ini.
• Скопируйте файлы $STARCRAFT/TorchCraft/BWEnv/bin/*.dll в каталог $STARCRAFT.
• Скопируйте файлы из каталога $STARCRAFT/TorchCraft/maps/* в каталог $STARCRAFT/Maps/BroodWar.

Теперь вам нужен только один из следующих двух методов: AIModule (DLL) или AIClient (EXE).

TorchCraft AIModule (DLL) для пользователей:

• Извлеките файл BWEnv.dll из последнего архива на странице релизов и поместите его в $STARCRAFT.
• Запустите файл $STARCRAFT/BWAPI/ChaosLauncher/Chaoslauncher - MultiInstance.exe от имени администратора.
• Отметьте флажок «RELEASE» в BWAPI.
• Нажмите кнопку «Пуск».
• Перейдите к разделу Установка клиента Torch (Linux).

TorchCraft AIClient (EXE) для пользователей:

• Извлеките файл BWEnv.exe из последнего архива на странице релизов и поместите его в $STARCRAFT.
• Запустите файл $STARCRAFT/BWEnv.exe.
• Перейдите к разделу Установка клиента Torch (Linux).

TorchCraft для разработчиков:

• Установите Visual Studio 2013. Версия Community/Express для Visual Studio подойдёт.
  • Следуйте тем же требованиям, что и для BWAPI (https://github.com/bwapi/bwapi/wiki/Compile-BWAPI).
• Клонируйте TorchCraft в каталог $STARCRAFT/TorchCraft.

  Мы рекомендуем использовать Git Bash для Windows: https://git-for-windows.github.io/).

• Задайте переменную среды BWAPI_DIR:
  • Щёлкните правой кнопкой мыши на «Мой компьютер» → «Свойства» → «Дополнительные параметры системы» → «Переменные среды». Добавьте BWAPI_DIR туда, где вы его установили, скорее всего, это будет что-то вроде C:\StarCraft\BWAPI.
  • Перезагрузите ОС, чтобы применить переменную к системе.
• Откройте файл $STARCRAFT/TorchCraft/BWEnv/VisualStudio/BWEnv.sln и приступайте к работе.
• Скомпилируйте в режиме Release для AIClient (вы получите файл BWEnv.exe) и в режиме DLL-Release для AIModule (вы получите файл BWEnv.dll).

Linux Server Пожалуйста, смотрите BWAPI на Linux.

Установка клиента Torch (Linux)

Torch (С сайта http://torch.ch/docs/getting-started.html)

В терминале или CLI введите:

$ curl -s ```

https://raw.githubusercontent.com/torch/ezinstall/master/install-deps | bash $ git clone https://github.com/torch/distro.git ~/torch --recursive $ cd ~/torch; ./install.sh

### TorchCraft

    $ git clone git@github.com:torchcraft/torchcraft.git --recursive
    $ cd torchcraft
    $ luarocks make *.rockspec
    $ cd examples/
    $ th simple_{exe|dll}.lua -t $server_ip # в зависимости от того, запустили вы exe или dll

*Примечание: предоставленный текст представляет собой набор команд для установки программного обеспечения и не содержит законченной мысли или смысловых фрагментов.*