======Mario AI Competition======

=====1. 환경을 꾸미기 전에=====

본 문서는 자바를 통해 마리오AI를 다룬다\\
개발툴은 eclipse를 사용하며, SVN을 통해 소스파일을 받게 된다.\\
이하의 작업은 아무것도 설치되어 있지 않다는 가정하에 진행되었으며\\
이미 eclipse가 설치되어 있다면 필요한 부분만 사용하기 바란다.\\
  
=====2. 개발툴 설치=====

eclipse는 [[http://eclipse.org]] 에서 다운받을 수 있다.\\
 해당 사이트로 들어간 뒤 download를 눌러준다.
  
 {{:마리오:00.jpg|}}
  
 그 뒤 자신의 OS 버젼 (여기서는 32bits windows7 / 헬리오스 sr2 를 기반으로 한다)을 선택한다
  
 {{:마리오:01.jpg|}}
  
 다운받은 압축파일을 원하는 장소에 풀어 실행시키고 workspace를 정한다.\\
 제대로 실행이 되었다면, SVN을 사용하기 위해 eclipse marketplace를 실행하여 subversive를 찾는다

 {{:마리오:03.jpg|}}
 {{:마리오:04.jpg|}}

 === 결과적으로 실패는 했지만, 가능하다면 SVN에 대해서는 subclipse 보다 subversive를 설치하기를 추천한다 ===
 subversive 설치시 무슨 문제인지 연결이 올바르게 되지 않아 할 수 없이 subclipse를 사용하였다.

 따라서 subversive 대신 subclipse를 설치하고 재시작을 한다.

=====3. 마리오AI 파일 다운로드 및 프로젝트 생성=====

 subclipse가 무사히 설치되었다면, 이제 마리오AI를 받으면 된다.\\
 - 먼저 메뉴의 [File] -> [New] -> [Other] -> [SVN]을 눌러 메뉴를 확장시킨다.\\
 - 확장된 메뉴 내의 'Checkout projects from SVN'을 선택한 뒤, Next를 누른다.\\
 - 다음 repository를 입력하게 되는데 [http://marioai.googlecode.com/svn/trunk]를 등록하거나 이미 등록되어 있다면 선택하고 Next를 누른다.\\
 - 한번 더 맨 위의 [http://marioai.googlecode.com/trunk]를 누르고 Next를 누른다.\\
 - 그 뒤 'Check out as a project configured using the New Project Wizard'를 선택하고 Finish를 누른다.\\

 {{:마리오:007.jpg|}}

 - 마리오는 자바로 되어 있기 때문에 [Java] -> [Java Project]를 선택하고 Next를 누른다.\\
 - 프로젝트 이름은 'MarioAI'로 적었다.\\
 - 'Use project folder as root for sources and class files'를 선택하고 Next를 누른다.\\

 {{:마리오:008.jpg|}}

 - 그 다음에 나오는 창의 밑부분 'Details'에서 'Configure inclusion and exclusion filters'를 누른다.

 {{:마리오:009.jpg|}}

 - 새로 열린 창에서 'Inclusion' 창에서 'Add'를 눌러 [".lvl" ".dat"]를 추가한 뒤 Finish를 눌러서 창을 종료한다.\\
 - Finish를 다시 눌러 프로젝트 생성을 완료한다.

=====3. 설정 및 빌드=====

 처음 프로젝트를 생성한 뒤에 하나를 설정해 줘야 한다.\\
 프로젝트 트리구조를 확장시켜 src폴터를 선택하여 [마우스 오른쪽 버튼] -> [Build Path] -> [Use as source folder] -> [OK]\\
 그리서 나서 [Project] -> [Build All]을 누른다.\\
 (처음부터 [Project] -> [Build Automatically]가 설정되어 있다면 다시 빌드할 필요는 없다.)

=====4. 실행=====

 위의 과정을 착실히 수행해 왔다면, [Run] -> [Run Configurations]눌러 창을 연 다음\\
 [Java Application] -> [New Launch Configuration]을 선택한 상태에서 'Main'탭의 'Main class'를 찾아 다음과 같이 입력한다\\
 'ch.idsia.scenarios.Main'

 {{:마리오:10.jpg|}}

 그 뒤 'Run'을 누르게 되면,

 
 {{:마리오:11.jpg|}}

 축하한다. 콧수염 배관공이 하늘에서 떨어지는 것을 볼 수 있을 것이다.\\
 (현재의 모드는 매뉴얼 모드로 A키로 불꽃, S키로 점프를 할 수 있으며, 십자키로 콧수염 아저씨를 움직일 수 있다.)

=====5. AI 실행=====

 AI를 적용하여 실행시키기 위해서는 뒤에 옵션을 추가로 정해주면 된다\\
 다시 [Run] -> [Run Configurations]를 눌러 창을 연 다음\\
 'Arguments' 탭을 열어 'Program arguments'에 다음을 추가해 보자
 '-ag ch.idsia.agents.controllers.ForwardJumpingAgent'

 {{:마리오:12.jpg|}}

 그 뒤 'Run'을 누르게 되면, 자기 혼자서 달려나가는 콧수염 배관공 아저씨를 볼 수 있을 것이다.
 (다른 컨트롤러를 사용해보고 싶다면 프로젝트 트리의 src->ch.idsia.agents.controllers 하위에 있는 컨트롤러로 바꿔보자.)