5편 - 소스 파일로 Pocketmine-MP 설치하기

  1. Git 설치하기
  2. PMMP 프로젝트 git clone하기
  3. Composer.phar 다운로드하기
  4. Composer로 의존 모듈 설치하기
  5. PMMP 소스 파일 실행

주의) 컴퓨터를 어느 정도 다룰 줄 아는 독자를 대상으로 한 가이드입니다.
+ 개발 환경 구축 가이드이기 때문에, 플러그인 개발은 다루지 않습니다.

0. 시작하기 앞서...

이번 가이드에선 PMMP를 소스 파일 상태로 설치하고 실행하는 방법을 알려드릴게요.

주로 PMMP자체를 수정해야 하거나, dev 버전에만 포함된 기능이 필요할 때 이 방법을 사용합니다. 하지만 .phar 파일을 사용하는 방법보다 작동 속도가 느리기 때문에,  개발 단계에서만 사용하는 것이 좋습니다.

 

 


1. Git 설치하기

먼저 PMMP의 소스 파일을 다운로드 받아야 합니다.

PMMP의 소스 파일은 @github/pmmp/PocketMine-MP 에서 구할 수 있습니다.

하지만 PMMP는 git-submodulecomposer를 사용하기 때문에 단순히 Download ZIP을 사용해서는 모든 소스를 받을 수 없습니다.

먼저 아래 링크를 눌러 git 설치 파일을 다운로드합니다.

Git - Downloading Package

다운로드 된 설치 파일을 실행하면 아래와 같은 설치 메뉴가 표시됩니다.
별다른 조정 없이 확인을 누르며 넘겨서 설치를 완료하시면 됩니다.

설치가 완료되면 CMD에서 git명령어를 사용할 수 있게 됩니다.

git --version
> git version 2.29.0.windows.1

   

   


2. PMMP 프로젝트 git clone하기

자 이제 PMMP의 소스 파일을 다운로드할 차례입니다.

작업 폴더로 이동한 후 아래 명령어를 입력합니다.

git clone --recursive https://github.com/pmmp/PocketMine-MP.git bin/pmmp
반드시 작업 폴더의 최상위 디렉토리에서 명령어를 사용해야 합니다.
저의 경우, C:\home\workspace\pmmp 입니다.

bin/pmmp 폴더 경로로 PocketMine-MP를 clone하는 명령어입니다.

git에 대해 잘 모르신다면 대충 git 기반으로 소스 코드를 다운로드 받는 거라고 생각하시면 됩니다.

--recursive 플래그는 서브 모듈까지 바로 clone한다는 의미입니다.
위 플래그를 생략한 후 별도로 git submodule update --init 명령어를 실행해도 됩니다.

 

 

- 2번을 마친 후의 폴더 구조
.
├── \bin
│   └── \php
│       └── ... (이하 생략)
│   └── \pmmp
│       └── ... (이하 생략)
├── PocketMine-MP.phar
├── start.bat
├── update.bat
└── vc_redist.x64.exe

3. Composer.phar 다운로드하기

Composer는 PHP의 의존성 관리 프로그램입니다.
대충 NodeJS의 npm과 같은 기능이라고 생각하시면 됩니다.
PMMP도 이 Composer를 사용해 의존성을 관리합니다.

먼저 아래 링크를 눌러 composer.phar 파일을 다운로드합니다.

https://getcomposer.org/composer-stable.phar

다운로드 된 composer.phar 파일을 작업 폴더의 bin 폴더 안에 넣어주세요.

 

 

- 3번을 마친 후의 폴더 구조
.
├── \bin
│   └── \php
│       └── ... (이하 생략)
│   └── \pmmp
│       └── ... (이하 생략)
│   └── composer.phar
├── PocketMine-MP.phar
├── start.bat
├── update.bat
└── vc_redist.x64.exe

4. Composer로 의존 모듈 설치하기

이제 cmd의 작업 디렉토리를  bin/pmmp 로 이동해줍니다.

cd bin\pmmp

그리고 아래 명령어를 입력해 composer로 의존 모듈을 설치해줍니다.

..\php\php ..\composer.phar install

아래 사진처럼 뭔가가 다운로드 되고 있으면 제대로 실행하신 겁니다.

설치가 완료되면 bin\pmmp\vendor 폴더가 생기고 그 안에 엄청 많은 파일이 있을 겁니다.

 

 

- 4번을 마친 후의 폴더 구조
.
├── \bin
│   └── \php
│       └── ... (이하 생략)
│   └── \pmmp
│       ├── \vendor
│       └── ... (이하 생략)
│   └── composer.phar
├── PocketMine-MP.phar
├── start.bat
├── update.bat
└── vc_redist.x64.exe

5. PMMP 소스 파일 실행

이번엔 소스 파일로 PMMP를 구동하는 스크립트를 작성해야 합니다.
따라서 아래 스크립트를 start-source.bat로 저장해서 사용하도록 할게요.

@echo off
TITLE Pocketmine-MP in Windows 10

set PHP_PATH=bin\php
set PHP_BINARY=%PHP_PATH%\php.exe
set POCKETMINE_FILE=PocketMine-MP.phar

:loop
    %PHP_BINARY% -c %PHP_PATH% %POCKETMINE_FILE%
    pause
goto loop

 

위에서 작성한  start-source.bat를 실행한 후 set-up wizard 과정을 마무리 하면 아래와 같은 경고 메세지와 함께 서버가 실행이 안됩니다.

개발 버전으로 실행하는 것을 허용하는 설정이 되어있지 않기 때문입니다.

먼저 pocketmine.yml 파일을 열어줍니다.

이 파일을 열면 settings의 enable-dev-builds 값이 false로 되어있습니다.

이를 true로 변경한 후 다시 start-source.bat를 실행하면 정상적으로 서버가 실행됩니다.


이상으로 이번 가이드도 마무리하겠습니다.    

   

그럼 빠빠이...