<div id="readability-page-1" class="page"><time>2021. 6. 17. 21:03</time>
 
 
 <a href="#comment" onclick="Utils.smoothScroll(this);return false">
 
 </a>
 
 
 
 
 
 
 
 <div>
 <h2 data-ke-size="size26">목차</h2>
0. BWAPI는?
1. BWAPI 다운로드
2. StarCraft 1.16.1 다운로드
3. Configuration 세팅
4. 구동 확인
<hr contenteditable="false" data-ke-type="horizontalRule" data-ke-style="style6">
<h2 data-ke-size="size26">0. BWAPI</h2>
BWAPI는 Brood War API의 약자입니다. 스타크래프트의 확장판인 브루드워의 API를 뜻하는 직관적인 의미를 갖고 있습니다. 아쉽게도 블리자드에서 정식으로 제공하는 SDK는 아니며, 1.16.1 버전의 스타크래프트와 코드로 인터랙션을 하기 위해 개발된 오픈소스 프로젝트입니다. BWAPI가 제공하는 API들로 AI 로직을 구현하고 DLL 형태로 컴파일하여 카오스런처를 이용해 플러그인 형식으로 사용하게됩니다. BWAPI는 스타크래프트 1.16.1 버전의 코드를 리버스 엔지니어링으로 분석하여 필요한 메소드들을 후킹함으로써 게임이 진행되고 플레이어의 시야가 있는 부분에 한해 이벤트를 발생시켜 AI 모듈이 동작할 수 있도록 해 줍니다. BWAPI로 무엇을 할 수 있는지 유튜브 영상으로 살펴보겠습니다.

<figure data-ke-type="video" data-ke-style="alignCenter" data-video-host="youtube" data-video-url="https://www.youtube.com/watch?v=KHSMQe5Idc4" data-video-thumbnail="https://scrap.kakaocdn.net/dn/bSbLRL/hyKBKc1x35/BVYDoZrDiKgJQCCVIjAzKk/img.jpg?width=1280&amp;height=720&amp;face=476_342_674_558" data-video-width="860" data-video-height="484" data-video-origin-width="860" data-video-origin-height="484" data-ke-mobilestyle="widthContent"><iframe src="https://www.youtube.com/embed/KHSMQe5Idc4" width="860" height="484" frameborder="" allowfullscreen=""></iframe>
<figcaption></figcaption>
<img src="https://scrap.kakaocdn.net/dn/bSbLRL/hyKBKc1x35/BVYDoZrDiKgJQCCVIjAzKk/img.jpg?width=1280&amp;height=720&amp;face=476_342_674_558"></figure>

흑운장이라는 이름으로 친숙한 전 스타크래프트 프로게이머 이성은 선수가 직접 상대해본 프로토스 ELO 1위 Stardust와 저그 ELO 1위 AI인 Monster입니다. 인간 프로선수에게 대적할 수준은 아니지만 꽤 수준급의 컨트롤과 운영능력을 보여줍니다. 여러차례 게임을 진행하며 점차 무기력하고 공략되는 안타까운 모습을 보여주지만 이 AI들은 대 인간용으로 설계된 AI들이 아니고 AI 대회 승리를 위해 고안된 프로그램들이기 때문에 당연하다고 볼 수 있는 결과입니다. 영상 중간중간에 '딥러닝 인공지능'이라는 언급이 나오지만 사실 이 두 AI는 딥러닝은 커녕 머신러닝의 범주에도 들어가지 않습니다. 단순히 인간에 의해 뼈대가 잡히고 상황에 따라 대응하도록 설계되어있을 뿐입니다.

<h2 data-ke-size="size26">1. BWAPI 설치</h2>
공식 <a href="https://github.com/bwapi/bwapi/releases/tag/v4.4.0" target="_blank" rel="noopener">Github</a>에서 설치할 수 있습니다.
Assets 하위의 BWAPI.7z 압축 파일을 내려받고 압축을 해제합니다.

<figure data-origin-width="1655" data-origin-height="1341" data-ke-mobilestyle="widthOrigin"><img src="https://blog.kakaocdn.net/dn/x1t0i/btq7x5usEm8/rVJmGgG7n19ZmeubV0rxz0/img.png" data-origin-width="1655" data-origin-height="1341" data-ke-mobilestyle="widthOrigin"></figure>

압축을 해제하면 다음과 같은 디렉터리 구조를 확인할 수 있습니다.

<figure data-origin-width="646" data-origin-height="382" data-ke-mobilestyle="widthOrigin"><img src="https://blog.kakaocdn.net/dn/sTJcd/btq7zwEEfJ3/dTZUHnLFkekktbAZgP2jKK/img.png" data-origin-width="646" data-origin-height="382" data-ke-mobilestyle="widthOrigin"></figure>

Visual Studio 2017또는 Visual Studio 2019로 ExampleProject.sln 솔루션을 열어줍니다.
만약 설치되어있지 않다면 Visual Studio 2019를 설치합니다.

일반적으로는 2017 버전으로 개발하지만 2019를 사용하여도 큰 이슈는 발생하지 않았습니다.

솔루션을 열면 여러개의 프로젝트가 포함되어있습니다.

<figure data-origin-width="517" data-origin-height="221" data-ke-mobilestyle="widthOrigin"><img src="https://blog.kakaocdn.net/dn/dvM3qE/btq7wyxbn08/Vi1YOoh5dk9YEvqdjKnstk/img.png" data-origin-width="517" data-origin-height="221" data-ke-mobilestyle="widthOrigin"></figure>

상단의 Build - Build Solution 메뉴를 사용하여 솔루션 빌드를 시도합니다.
높은 확률로 컴파일에 실패할것입니다.
프로젝트의 플랫폼 툴셋이 기본적으로 Visual Studio 2017 + Windows XP 설정으로 되어 있기 때문입니다.

AIModuleLoader 프로젝트에 마우스 우클릭으로 컨텍스트 메뉴를 열고, Properties(속성) 메뉴를 선택합니다.

<figure data-origin-width="817" data-origin-height="1110" data-ke-mobilestyle="widthOrigin"><img src="https://blog.kakaocdn.net/dn/bzNR3u/btq7BE9SYMU/5pNJMYaIkFltifN9Nu28cK/img.png" data-origin-width="817" data-origin-height="1110" data-ke-mobilestyle="widthOrigin"></figure>

Alt + Enter 단축키로도 열 수 있습니다.
대화상자가 열리면 상단 Configuration 드롭다운 메뉴에서 All Configuration 옵션을 선택합니다.

<figure data-origin-width="1069" data-origin-height="566" data-ke-mobilestyle="widthOrigin"><img src="https://blog.kakaocdn.net/dn/c43f8K/btq7zwkmWYr/zru8PAJ0HrozgVSXQVaT90/img.png" data-origin-width="1069" data-origin-height="566" data-ke-mobilestyle="widthOrigin"></figure>

Platform Toolset 옵션을 현재 설치되어있는 Visual Studio의 버전으로 선택합니다.
기존 설정은 (not installed) 라고 써 있을텐데, 적절하게 Visual Studio 2019나 Visual Studio 2017을 선택합니다.

<figure data-origin-width="1051" data-origin-height="564" data-ke-mobilestyle="widthOrigin"><img src="https://blog.kakaocdn.net/dn/b5QBXI/btq7zvZ4F0y/r9NM2XpR3fN2vs0v3F6bu1/img.png" data-origin-width="1051" data-origin-height="564" data-ke-mobilestyle="widthOrigin"></figure>

이렇게 모든 프로젝트를 수정합니다.
AIModuleLoader, BWAPIClient, BWAPILIB, ExampleAIClient, ExampleAIModule, ExampleTournamentModule 총 6개 프로젝트에 대해 이 작업을 해 줍니다.

작업을 마쳤으면 다시 Build - Build Solution 메뉴를 통해 컴파일을 시도합니다.

<figure data-origin-width="702" data-origin-height="268" data-ke-mobilestyle="widthOrigin"><img src="https://blog.kakaocdn.net/dn/edUnMU/btq7AaHYe98/7DqydpHVueio9kT7jNYG61/img.png" data-origin-width="702" data-origin-height="268" data-ke-mobilestyle="widthOrigin"></figure>

컴파일에 성공했습니다.&nbsp;
솔루션 파일이 위치한 디렉터리에는 Debug라는 이름의 폴더가 생겼습니다.
이 안에 ExampleAIModule.dll이 생성되었습니다.

이 DLL 파일이 앞으로 개발할 AI의 결과물이 될 것입니다.

<h2 data-ke-size="size26">2. StarCraft 1.16.1 다운로드</h2>
다운로드 경로나 방법에 대해서는 따로 기술하지 않겠습니다. 
블리자드 앱에서 내려받을 수 있는 리마스터 버전이 아닌, 1.16.1 버전을 사용해야합니다.

경로 설정에 대해서만 알아보겠습니다.
솔루션 파일이 위치한 디렉터리에는 Starcraft라는 폴더가 있습니다.

안에는 bwapi-data 폴더와 SNP_DirectIP.snp 파일이 존재합니다.&nbsp;
이 경로에 스타크래프트 1.16.1 버전 클라이언트를 넣어줍니다.

<figure data-origin-width="750" data-origin-height="758" data-ke-mobilestyle="widthOrigin"><img src="https://blog.kakaocdn.net/dn/dlU4Ew/btq7yaPIcba/QYQaKGnrU83dAnJizwPun1/img.png" data-origin-width="750" data-origin-height="758" data-ke-mobilestyle="widthOrigin"></figure>

<h2 data-ke-size="size26">3. Configuration 세팅</h2>
이제 AI를 구동시키고 테스트하기 위한 환경을 설정합니다.
솔루션 파일이 위치한 디렉터리에는 Chaoslauncher 폴더가 있습니다.

스타크래프트의 구동을 도와주는 도구로서 여러 플러그인의 사용을 가능하게 합니다.
Chaoslauncher.exe를 관리자권한으로 실행합니다.

먼저 Settings 탭으로 이동하여, 스타크래프트 설치 경로를 지정해줍니다.
2에서 확인한 경로와 연결하면 됩니다.

<figure data-origin-width="512" data-origin-height="385" data-ke-mobilestyle="widthOrigin"><img src="https://blog.kakaocdn.net/dn/edLYd8/btq7BfbnGqa/IyhDHKjRT38j1qqgLrYFPk/img.png" data-origin-width="512" data-origin-height="385" data-ke-mobilestyle="widthOrigin"></figure>
저장하고, Plugins 탭으로 돌아와 BWAPI 4.4.0 Injector [DEBUG] 플러그인의 체크박스를 활성화합니다.
Config를 눌러 Configuration 파일을 엽니다.

<figure data-origin-width="512" data-origin-height="385" data-ke-mobilestyle="widthOrigin"><img src="https://blog.kakaocdn.net/dn/MgM2T/btq7ygP92c7/lVNMesseMJtjpLTXK9G8Y1/img.png" data-origin-width="512" data-origin-height="385" data-ke-mobilestyle="widthOrigin"></figure>

메모장 등의 텍스트 에디터로 열립니다.
여기에서 어떤 DLL을 사용할지나 맵, 플레이 모드와 종족 등을 선택합니다.

<figure data-origin-width="782" data-origin-height="845" data-ke-mobilestyle="widthOrigin"><img src="https://blog.kakaocdn.net/dn/cqZDZu/btq7AausVFN/OPLZSkOc2FmQtcJrikxi10/img.png" data-origin-width="782" data-origin-height="845" data-ke-mobilestyle="widthOrigin"></figure>
BWAPI 4.4.0 Injector [RELEASE] 플러그인을 사용하면 ai=... 경로를 사용합니다.
BWAPI 4.4.0 Injector [DEBUG] 플러그인을 사용하면 ai_dbg=... 경로를 사용합니다.

아까 컴파일했던 DLL은 솔루션 파일이 위치한 디렉터리의 DEBUG 폴더에 위치하므로,
ai_dbg=../Debug/ExampleAIModule.dll로 설정했습니다.

auto_menu는 BWAPI가 게임 메뉴를 선택해서 자동으로 입장해줍니다.
OFF, SINGLE_PLAYER, LAN, BATTLE_NET을 선택할 수 있습니다.

맵은 경로를 이용해 지정할 수 있습니다.
map=maps/BroodWar/Fighting_Spirit.scx

<figure data-origin-width="728" data-origin-height="196" data-ke-mobilestyle="widthOrigin"><img src="https://blog.kakaocdn.net/dn/JW4l2/btq7uUmAzK4/yTdhbcx81WYeWIHUoSnbQK/img.png" data-origin-width="728" data-origin-height="196" data-ke-mobilestyle="widthOrigin"></figure>

경로를 참고하여 지정해주었습니다.

내 종족입니다.
race=Terran

상대의 종족입니다.
enemy_race=Protoss

더 아래에 있는 옵션들은 세부적으로 스타크래프트의 창을 어떻게 지정할 것인지나 몇 명의 적을 기다릴 것인지 등을 설정할 수 있습니다. 게임 속도를 조절할 수도 있고, 지속적인 개발을 하다보면 사용하게 되는 옵션들이 있으니 시간을 내어 차근차근 확인해보는것을 권장합니다.


<h2 data-ke-size="size26">4. 구동 확인</h2>
실제로 구동 테스트를 해 보겠습니다.
기본 Config에서 수정한 내용은 다음과 같습니다.

ai_dbg&nbsp;=&nbsp;../Debug/ExampleAIModule.dll auto_menu&nbsp;=&nbsp;SINGLE_PLAYER

카오스 런처에서 Start를 누르면 스타크래프트가 실행되고 싱글플레이로 컴퓨터와 대전합니다.스스로 미네랄을 캐고, 보급고를 건설합니다.

<figure data-origin-width="1290" data-origin-height="997" data-ke-mobilestyle="widthOrigin"><img src="https://blog.kakaocdn.net/dn/b4bDVH/btq7yaoFcxm/sEGybnFRPD3htFgNF6yO1K/img.png" data-origin-width="1290" data-origin-height="997" data-ke-mobilestyle="widthOrigin"></figure>

이 AI의 코드는 ExampleAIClient 프로젝트의 ExampleAIClient.cpp에 구현되어있습니다.
 
 
											
					
 
 
 </div></div>

Fireplace

samueljeon

목차
0. BWAPI는?
1. BWAPI 다운로드
2. StarCraft 1.16.1 다운로드
3. Configuration 세팅
4. 구동 확인
0. BWAPI
BWAPI는 Brood War API의 약자입니다. 스타크래프트의 확장판인 브루드워의 API를 뜻하는 직관적인 의미를 갖고 있습니다. 아쉽게도 블리자드에서 정식으로 제공하는 SDK는 아니며, 1.16.1 버전의 스타크래프트와 코드로 인터랙션을 하기 위해 개발된 오픈소스 프로젝트입니다. BWAPI가 제공하는 API들로 AI 로직을 구현하고 DLL 형태로 컴파일하여 카오스런처를 이용해 플러그인 형식으로 사용하게됩니다. BWAPI는 스타크래프트 1.16.1 버전의 코드를 리버스 엔지니어링으로 분석하여 필요한 메소드들을 후킹함으로써 게임이 진행되고 플레이어의 시야가 있는 부분에 한해 이벤트를 발생시켜 AI 모듈이 동작할 수 있도록 해 줍니다. BWAPI로 무엇을 할 수 있는지 유튜브 영상으로 살펴보겠습니다.
 
 
흑운장이라는 이름으로 친숙한 전 스타크래프트 프로게이머 이성은 선수가 직접 상대해본 프로토스 ELO 1위 Stardust와 저그 ELO 1위 AI인 Monster입니다. 인간 프로선수에게 대적할 수준은 아니지만 꽤 수준급의 컨트롤과 운영능력을 보여줍니다. 여러차례 게임을 진행하며 점차 무기력하고 공략되는 안타까운 모습을 보여주지만 이 AI들은 대 인간용으로 설계된 AI들이 아니고 AI 대회 승리를 위해 고안된 프로그램들이기 때문에 당연하다고 볼 수 있는 결과입니다. 영상 중간중간에 '딥러닝 인공지능'이라는 언급이 나오지만 사실 이 두 AI는 딥러닝은 커녕 머신러닝의 범주에도 들어가지 않습니다. 단순히 인간에 의해 뼈대가 잡히고 상황에 따라 대응하도록 설계되어있을 뿐입니다.
 
1. BWAPI 설치
공식 Github에서 설치할 수 있습니다.
Assets 하위의 BWAPI.7z 압축 파일을 내려받고 압축을 해제합니다.
 
 
압축을 해제하면 다음과 같은 디렉터리 구조를 확인할 수 있습니다.
 
 
Visual Studio 2017또는 Visual Studio 2019로 ExampleProject.sln 솔루션을 열어줍니다.
만약 설치되어있지 않다면 Visual Studio 2019를 설치합니다.
 
일반적으로는 2017 버전으로 개발하지만 2019를 사용하여도 큰 이슈는 발생하지 않았습니다.
 
솔루션을 열면 여러개의 프로젝트가 포함되어있습니다.
 
 
상단의 Build - Build Solution 메뉴를 사용하여 솔루션 빌드를 시도합니다.
높은 확률로 컴파일에 실패할것입니다.
프로젝트의 플랫폼 툴셋이 기본적으로 Visual Studio 2017 + Windows XP 설정으로 되어 있기 때문입니다.
 
AIModuleLoader 프로젝트에 마우스 우클릭으로 컨텍스트 메뉴를 열고, Properties(속성) 메뉴를 선택합니다.
 
 
Alt + Enter 단축키로도 열 수 있습니다.
대화상자가 열리면 상단 Configuration 드롭다운 메뉴에서 All Configuration 옵션을 선택합니다.
 
 
Platform Toolset 옵션을 현재 설치되어있는 Visual Studio의 버전으로 선택합니다.
기존 설정은 (not installed) 라고 써 있을텐데, 적절하게 Visual Studio 2019나 Visual Studio 2017을 선택합니다.
 
 
이렇게 모든 프로젝트를 수정합니다.
AIModuleLoader, BWAPIClient, BWAPILIB, ExampleAIClient, ExampleAIModule, ExampleTournamentModule 총 6개 프로젝트에 대해 이 작업을 해 줍니다.
 
작업을 마쳤으면 다시 Build - Build Solution 메뉴를 통해 컴파일을 시도합니다.
 
 
컴파일에 성공했습니다. 
솔루션 파일이 위치한 디렉터리에는 Debug라는 이름의 폴더가 생겼습니다.
이 안에 ExampleAIModule.dll이 생성되었습니다.
 
이 DLL 파일이 앞으로 개발할 AI의 결과물이 될 것입니다.
 
2. StarCraft 1.16.1 다운로드
다운로드 경로나 방법에 대해서는 따로 기술하지 않겠습니다. 
블리자드 앱에서 내려받을 수 있는 리마스터 버전이 아닌, 1.16.1 버전을 사용해야합니다.
 
경로 설정에 대해서만 알아보겠습니다.
솔루션 파일이 위치한 디렉터리에는 Starcraft라는 폴더가 있습니다.
 
안에는 bwapi-data 폴더와 SNP_DirectIP.snp 파일이 존재합니다. 
이 경로에 스타크래프트 1.16.1 버전 클라이언트를 넣어줍니다.
 
 
3. Configuration 세팅
이제 AI를 구동시키고 테스트하기 위한 환경을 설정합니다.
솔루션 파일이 위치한 디렉터리에는 Chaoslauncher 폴더가 있습니다.
 
스타크래프트의 구동을 도와주는 도구로서 여러 플러그인의 사용을 가능하게 합니다.
Chaoslauncher.exe를 관리자권한으로 실행합니다.
 
먼저 Settings 탭으로 이동하여, 스타크래프트 설치 경로를 지정해줍니다.
2에서 확인한 경로와 연결하면 됩니다.
 
저장하고, Plugins 탭으로 돌아와 BWAPI 4.4.0 Injector [DEBUG] 플러그인의 체크박스를 활성화합니다.
Config를 눌러 Configuration 파일을 엽니다.
 
 
메모장 등의 텍스트 에디터로 열립니다.
여기에서 어떤 DLL을 사용할지나 맵, 플레이 모드와 종족 등을 선택합니다.
 
BWAPI 4.4.0 Injector [RELEASE] 플러그인을 사용하면 ai=... 경로를 사용합니다.
BWAPI 4.4.0 Injector [DEBUG] 플러그인을 사용하면 ai_dbg=... 경로를 사용합니다.
 
아까 컴파일했던 DLL은 솔루션 파일이 위치한 디렉터리의 DEBUG 폴더에 위치하므로,
ai_dbg=../Debug/ExampleAIModule.dll로 설정했습니다.
 
auto_menu는 BWAPI가 게임 메뉴를 선택해서 자동으로 입장해줍니다.
OFF, SINGLE_PLAYER, LAN, BATTLE_NET을 선택할 수 있습니다.
 
맵은 경로를 이용해 지정할 수 있습니다.
map=maps/BroodWar/Fighting_Spirit.scx
 
 
경로를 참고하여 지정해주었습니다.
 
내 종족입니다.
race=Terran
 
상대의 종족입니다.
enemy_race=Protoss
 
더 아래에 있는 옵션들은 세부적으로 스타크래프트의 창을 어떻게 지정할 것인지나 몇 명의 적을 기다릴 것인지 등을 설정할 수 있습니다. 게임 속도를 조절할 수도 있고, 지속적인 개발을 하다보면 사용하게 되는 옵션들이 있으니 시간을 내어 차근차근 확인해보는것을 권장합니다.
 
 
4. 구동 확인
실제로 구동 테스트를 해 보겠습니다.
기본 Config에서 수정한 내용은 다음과 같습니다.
 
ai_dbg = ../Debug/ExampleAIModule.dll 
auto_menu = SINGLE_PLAYER
 
카오스 런처에서 Start를 누르면 스타크래프트가 실행되고 싱글플레이로 컴퓨터와 대전합니다.스스로 미네랄을 캐고, 보급고를 건설합니다.
 
 
이 AI의 코드는 ExampleAIClient 프로젝트의 ExampleAIClient.cpp에 구현되어있습니다.

BWAPI: 1. 스타크래프트 인공지능 개발 환경 준비

댓글