Chapter 1. 설치하기
2018/04/23
파이썬으로 마인크래프프에 접속하여 프로그래밍을 하려면 다음 5가지를 설치하여야 한다.
- 마인크래프트 ( 1.12.2 )
- 파이썬 3 ( 3.6.5 )
- 자바 ( 10.0.1 )
- 스피곳(spigot) 마인크래프트 서버 ( 1.12.2 )
- 마인크래프트 파이썬 API ( py3minepi, raspberryjuice )
( ) 안은 2018년 4월 기준 최신 버전
위의 5가지에 대한 설치는 windows OS를 기준으로 설명한다. 미국학생들에게 배포하기 위하여 영문으로 만든 문서이기 때문에 이미지는 모두 영문으로 캡쳐하였다. 한글버전도 똑같이 진행하면 된다.
A. 마인크래프트 설치하기
1. 마인크래프트 공식 홈페이지를 방문한다. https://www.minecraft.net
마인크래프트 계정에 가입하고 마인크래프트를 구매한다.
2. 윈도우용 마인크래프트 설치 파일을 다운로드 한다.
3. 다운로드한 파일은 원하는 폴더에 넣어도 되지만, 설치의 편의성을 위해 “C:\Minecraft” 폴더를 만들어서 그곳에 다운로드 하기로 한다.
4. 다운로드 한 파일을 더블클릭하여 실행시킨다. 마인크래프트 설치 마법사가 나타나면 “다음” 버튼을 누른다.
5. 설치 폴더는 기본으로 두고 “다음” 버튼을 누른다.
6. “설치” 버튼을 눌러 설치를 시작한다. 마인크래프트 설치 마법사는 기본 파일만을 설치하므로 설치 시간이 매우 짧다. 실제 마인크래프트 게임은 실행할 마인크래프트 버전을 선택할 때 설치된다.
7. 설치가 끝나면 마인크래프트 실행 아이콘을 클릭하여 마인크래프트를 실행시킨다.
8. 1번에서 가입한 마인크래프트 계정으로 로그인을 하면 마인크래프트를 버전별 설치할 수 있는 화면이 나타난다.
마인크래프트의 기본설치는 완료되었다.
B. 파이썬 3 설치하기
1. 파이썬 공식 홈페이지를 방문한다. https://www.python.org/
2. 최신 버전의 파이썬 3을 선택한다. 2018년 4월 기준 가장 최신 버전은 “python 3.6.5” 이다.
3. “C:\Minecraft” 폴더에 설치 파일을 다운로드 한다.
4. python-3.6.5.exe 파일을 더블클릭하여 설치를 시작한다.
5. “파이썬 경로 추가”를 선택한다. 본 항목을 선택해야 환경변수에서 경로가 설정되어 파이썬 실행파일을 정상적으로 불러올 수 있다. “선택 설치”를 클릭한다.
6. 모든 항목을 선택하고 “다음” 버튼을 누른다.
7. 아래 그림과 같이 추가 옵션을 선택하고, 설치 경로는 “C:\Pytho36” 로 입력한다. “설치” 버튼을 누른다. 경로가 길면 나중에 경로 찾기 힘들다. 따라서 찾기 쉬운 짧은 경로를 선택한다.
8. 설치 중
9. 설치가 성공하면 “닫기” 버튼울 눌러 설치를 완료한다.
C. 자바 설치하기
1. 자바 다운로드 공식 홈페이지를 방문한다.
http://www.oracle.com/technetwork/java/javase/downloads/index.html
2. 최신 버전의 java SE를 다운로드 한다. 2018년 4월 기준 가장 최신 버전은 “jdk-10.0.1” 이다.
3. “C:\Minecraft” 폴더에 설치 파일을 다운로드 한다.
4. jdk-10.0.1_windows-x64_bin.exe 파일을 더블클릭하여 설치를 시작한다.
5. 설치 마법사와 설치옵션은 따로 수정하지 않고 “다음” 버튼을 눌러서 진행한다.
6. JRE(Java Runtime Environment)를 설치한다.
7. 설치가 성공하면 “닫기” 버튼을 눌러 설치를 완료한다.
D. 스피곳 마인크래프트 서버 설치하기
spigot 서버는 마인크래프트 서버에 각종 플러그인을 더하여 마인크래프트 서버를 좀 더 다양한 기능으로 활용할 수 있도록 만든 서버이다.
1. spigot 다운로드 홈페이지를 방문한다. https://getbukkit.org/download/spigot
2. 최신의 spigot 서버를 다운로드 한다. 2018년 4월 기준 최신 버전은 “spigot 1.12.2” 버전이다.
3. “C:\Minecraft” 폴더에 설치 파일을 다운로드 한다.
4. spigot 서버는 여러 개를 만들 수 있기 때문에 “Server” 폴더를 추가하여 관리하도록 한다. spigot-1.12.2.jar 파일을 Server 폴더로 이동시킨다.
5. Java가 설치가 되었기 때문에 spigot-1.12.2.jar 파일을 더블클릭하면 자동으로 서버가 설치가 시작된다. 하지만 완전하게 설치가 되지 않는다.
6. eula.txt 파일을 수정해야만 설치가 완료된다.
7. eula.txt 파일을 메모장으로 열어서 “eula=false” 를 “eula=true” 로 수정한다.
8. 다시 spigot-1.12.2.jar 파일을 더블클릭하면 모든 설치가 완료된다.
9. 설치가 완료되고 나서 spigot-1.12.2.jar 파일을 더블클릭하면 마인크래프트 서버가 실행된다. 하지만 사용의 편의성을 위해 배치파일을 만들도록 한다. 메모장으로 start.txt 파일을 만든다.
10. start.txt 파일 안에 아래와 같은 내용을 입력한다.
@echo off
java -Xms512M -Xmx1024M -XX:MaxPermSize=128M -jar spigot-1.12.2.jar
pause
11. start.txt 파일의 확장자를 start.bat로 변경한다.
12. start.bat 파일을 더블클릭하여 마인크래프트 서버를 실행시킨다. 인터넷에 접속해야할 필요가 있는 프로세스는 윈도우의 방화벽에서 보안 경고창이 뜬다. “허용”을 눌러주어 인터넷 접속을 허가한다.
13. 다음 그림은 정상적으로 마인크래프트 서버가 실행되는 화면이다. 마인크래프트 버전은 1.12.2이며, 접속 포트는 25565 임을 알 수 있다. 접속포트와 서버에 대한 환경 설정은 server.properties 파일에서 수정할 수 있다.
E. 마인크래프트 파이썬 API 및 raspberryjuice 설치하기
파이썬으로 프로그래밍한 코드를 마인크래프트 서버에 적용시키기 위해서는 두 개를 연결시켜주는 API가 필요하다. 또한 연결을 위한 4711포트를 열어주는 raspberryjuice 플러그인이 필요하다.
1. 파이썬 API인 py3minepi 패키지 다운로드 홈페이지를 방문한다.
https://github.com/py3minepi/py3minepi
2. 압축 파일을 선택하여 다운로드 한다.
3. “C:\MineCraft” 폴더에 압축 파일을 다운로드 한다.
4. 다운받은 py3minepi-master.zip 파일의 압축을 푼다.
5. 압축을 푼 폴더를 보면 파이썬 패키지 설치 형태로 되어 있다.
6. 윈도우의 명령창을 실행하여 py3minepi-master 폴더로 이동한다.
C:\>cd MineCraft
C:\MineCraft>cd py3minepi-master
C:\MineCraft\py3minepi-master>dir
7. 아래의 명령을 실행시켜 파이썬 API를 파이썬 패키지로 등록한다.
C:\MineCraft\py3minepi-master>python setup.py install
- 만약 실행이 되지 않는다면 파이썬의 경로가 설정되어 있지 않기 때문이다. 파이썬 설치할 때 B-5번에서 “파이썬 경로 추가”를 선택하지 않았기 때문에 발생한다. 이때는 환경설정에서 파이썬 경로를 추가하여 파이썬 명령어를 실행가능 하도록 해준다.
8. “C:\MineCraft\py3minepi-master>pip list” 명령을 통해서 패키지가 정상적으로 등록되었는지 확인한다.
9. 실제 등록된 패키지는 파이썬의 설치 폴더의 site-packages에 저장된다.
C:\Python36\Lib\site-packages\py3minepi-0.0.1-py3.6.egg
10. raspberryjuice 플러그인 홈페이지를 방문한다.
https://github.com/zhuowei/RaspberryJuice
11. jars 디렉토리로 들어가서 최신의 raspberryjuice 파일을 다운로드 한다. 2018년 4월 기준 최신 버전은 “raspberryjuice 1.11” 버전 이다.
12. raspberryjuice-1.11.jar 파일은 마인크래프트 서버의 “plugins” 폴더에 저장한다.
C:\MineCraft\Server\plugins\
13. 플러그인 폴더에 저장하는 것으로 raspberryjuice 플러그인 설치 완료
4. 모든 파일이 로딩되면 초기 화면이 나타난다. “멀티플레이어”를 선택한다.
5. 방화벽 보안 경고창이 뜨면 “허용”을 클릭한다.
6. “서버추가” 버튼을 누른다.
7. 서버 이름을 정하고, 1번에서 실행시킨 서버가 본인의 컴퓨터에서 실행되기 때문에 서버 주소는 “localhost”로 입력한다.
8. 서버추가가 완료되면 서버에 접속할 수 있음을 알 수 있다.
9. 추가한 서버를 클릭하고 “서버 접속”을 눌러 서버에 접속한다.
10. 서버에 접속한 첫 화면.
11. 마인크래프트 실행화면에서 “ESC” 버튼을 눌러 화면을 빠져나온다. 그리고 파이썬 IDLE를 실행한다.
12. 파이썬 Shell에 아래의 코드를 입력한다.
>>> from mcpi.minecraft import Minecraft
>>> mc = Minecraft.create()
>>> mc.player.setTilePos(0, 200, 0)
순서대로 파이썬 API에서 설치한 Minecraft 클래스를 임포트하고, 클래스 생성 후 함수를 호출하는 코드이다. 함수는 플레이어를 x, y, z 축 중에서 y축으로 200 이동시키라는 의미이다. 즉, 플레이어가 하늘로 솟아오른다는 의미이다.
만약 에러 메시지가 나타난다며 파이썬 API가 정상적으로 설치되지 않았거나, raspberryjuice 플러그인이 정상적이지 않은 경우가 많다. API를 재설치하거나 마인크래프트 서버를 재 실행하여 오류를 수정할 수 있다.
14. 아래는 11번에서 ~ 12번까지 마인크래프트 화면과 파이썬 IDLE 화면을 동시에 캡쳐한 그림이다.
15. 이와 같은 동작이 성공하면 모든 설치가 정상적으로 된 것이다. 이로써 파이썬 코드를 통해 마인크래프트를 조작할 수 있는 환경이 완료되었다.
Chapter 1. 설치 끝
'파이썬 개발도구 설치' 카테고리의 다른 글
| 8. 파이썬 GUI 프로그래밍 실습 - 1. 프로젝트 생성 (0) | 2020.05.16 |
|---|---|
| 7. 이클립스 설정 ( UTF-8, Font 등 ) (0) | 2020.05.16 |
| 6. Qt Designer 설치 (0) | 2020.05.16 |
| 5. PySide2 설치 (0) | 2020.05.16 |
| 4. Pydev 설치 (0) | 2020.05.16 |
| 3. 이클립스 설치 (0) | 2018.12.22 |
| 2. JAVA 설치 (0) | 2018.12.21 |
| 1. 파이썬 개발 도구 - 파이썬 설치 (0) | 2018.12.21 |