마인크래프트 플러그인 강좌 0강 - 준비하기

마인크래프트 플러그인이란?

마인크래프트 플러그인은 마인크래프트 내에서 기능을 확장할 수 있도록 프로그래밍하여 적용할 수 있도록 한 것을 말합니다. 이런 플러그인들의 예로는 부동산 플러그인, 경제 플러그인 등이 있겠네요.

 

마인크래프트 플러그인을 개발하기 위해서는?

마인크래프트 플러그인을 개발하기 위해서는 JDK(Java Development Kit)를 다운로드 받아야 합니다. 그 이유는 마인크래프트라는 게임 자체가 Java라는 언어로 개발되었기 때문입니다. 따라서 JDK를 다운로드 받으면 Java 프로그램 개발 및 실행할 수 있습니다. Java를 다운로드하라고 할 때 흔히 하는 실수는 JDK가 아닌 JRE를 다운로드 받는 것입니다. JRE는 Java Runtime Environment의 약자로 Java 프로그램을 실행하기 위한 목적으로 사용됩니다.

	JRE(Java Runtime Environment)	JDK(Java Development Kit)
목적	Java 프로그램 실행	Java 프로그램 개발 및 실행
구성 요소	JVM(Java Virtual Machine) + 기본 라이브러리	JRE + 개발 도구(컴파일러, 디버거 등)
제공 도구	Java(프로그램 실행)만 제공	Javac(컴파일), Javadoc(문서화) 등 다양한 도구 포함

 

여기서 JVM은 Java Virtual Machine의 약자로, Java 프로그램이 실행되는 가상 환경이다. Java는 한 번 작성되면 어디서나 실행할 수 있다는 특징이 JVM 덕분입니다. JVM은 운영체제 상관없이 실행되고 메모리를 자동으로 정리해주기 때문에 많은 사람들이 사용합니다.

마인크래프트 플러그인 개발 첫 단계는?

마인크래프트 플러그인을 개발하고 적용하기 위해서는 서버가 필요합니다. 서버를 구동하는 방법은 다음과 같습니다.

① Java 다운로드 하기

https://www.oracle.com/java/technologies/downloads/

Download the Latest Java LTS Free

 

JDK를 다운로드 받으셔야 합니다.

② 환경변수 설정하기

환경변수를 설정하는 이유는 운영 체제와 애플리케이션이 특정 정보를 쉽게 참조할 수 있도록 하기 위해서입니다. 따라서 이를 통해 시스템 전체나 특정 프로그램에서 필요한 설정이나 경로를 효율적으로 관리할 수 있습니다. 간단하게 말하면 경로나 설정이 변경될 경우 환경변수 값만 수정하면 프로그램 실행을 간소화할 수 있다는 의미입니다. 이 부분은 크게 신경쓰지 않으셔도 됩니다.

 

내PC 우클릭 ▶ 속성 버튼 클릭 ▶ 정보 창에서 아래로 스크롤 후 고급 시스템 설정 버튼 클릭

 

 

고급 시스템 설정 버튼 클릭 후 환경 변수 버튼 클릭

환경 변수 버튼 클릭 후 새로 만들기 버튼 클릭

변수 이름에 JAVA_HOME을 써주시고, 변수 값으로 JDK가 설치되어 있는 경로를 써주셔야 합니다.

C:\Program Files\Java\jdk-23로 써주셔야 합니다.

그 다음 시스템 변수에서 Path 항목을 선택 후 편집 버튼을 클릭합니다.

그 후 새로 만들기 버튼을 누르고 %JAVA_HOME%\bin\ 을 입력하여 추가해줍니다.

마지막 단계로 CLASSPATH를 설정해주어야 합니다. 똑같이 위에서 했던 것처럼 시스템 변수 항목에서 새로 만들기 버튼을 누르고 아래처럼 해주신 뒤 확인 버튼을 누르시면 됩니다.

③ Java 설치 및 환경변수 설정이 잘 적용되었는지 확인하기

"Window키 + R"을 누르신 뒤 cmd을 입력한 후 엔터를 누르시면 cmd 창이 나타납니다.

그 뒤 각각 "javac -version, javac, java"를 입력 해서 잘 출력되는지 확인 하면 됩니다.

 

④ 버킷 다운로드 받고 서버 생성하기

버킷(Bukkit)은 여러가지 종류가 있습니다. 하지만 이 블로그에서는 Paper 플러그인을 사용하도록 하겠습니다.

https://papermc.io/downloads/paper

Paper Downloads

여기서 다운로드를 받으시면 .jar 파일을 다운로드 받으실 수 있습니다. 그 다음 새로운 폴더를 하나 만드시고 안에 jar 파일을 옮겨주세요.

이름이 너무 기니 이름을 간단하게 바꿔주도록 하겠습니다.

그 다음 빈 곳을 우클릭 한 뒤 새로 만들기를 하고 텍스트 문서를 눌러주세요.

그 다음 메모장으로 들어가주세요.

@echo off
java -Xms1G -Xmx2G -jar paper.jar
pause

(참고: Xms는 최소 메모리 양, Xmx는 최대 메모리 양)

메모장에 위와 같이 입력하시면 되는데 중요한 점은 각자 컴퓨터 메모리 사양에 따라 최소 메모리, 최대 메모리 양을 다르게 해주시면 됩니다. 보통은 위와 같이만 해도 혼자서 플러그인 개발 공부하는 데 큰 무리가 없습니다. 저는 메모리 8기가이기 때문에 작게 할당을 해주었고요, 만약에 메모리(램)이 남아돈다 하시면 크기를 늘려주셔도 됩니다.

 

그 다음 단계로 저장을 하신 뒤 .txt 부분을 .bat으로 바꿔주시기 바랍니다. 만약 뒤에 확장자가 보이지 않는다면 확장자를 보이게 바꿔주세요.

바꿔주셨다면 이제 실행시키시면 됩니다. 실행시키면 아래와 같이 나옵니다

 

실행시키시면 로그가 뜨다가 멈추게 될텐데 이때 eula.txt로 가셔서 false를 true로 바꿔주셔야 합니다.

이렇게 바꿔주시고 저장하신 뒤 다시 server.bat 파일을 실행시키시면 됩니다.

실행시키면 월드를 로딩해줄 것입니다.

 

로딩이 끝나면 이렇게 뜰 것입니다. 이제 서버가 잘 열렸는지 확인해보기 위해 마인크래프트를 열고 서버에 접속해봅니다. 접속할 때는 설치하신 paper 버전의 마인크래프트를 실행시켜야 합니다. 저는 paper 1.21 버전을 사용하였기 때문에 1.21 버전의 마인크래프트를 실행시키도록 하겠습니다.

 ⑤ 마인크래프트 실행

플러그인 테스트 목적으로 열었기 때문에 localhost로 접속해줍니다. 포트포워딩을 하고 호스팅을 하면 다른 사람들도 들어올 수 있는 서버를 열 수 있을 것입니다.

접속하시면 서버 로그에도 접속했다는 문구가 나올 것입니다.

 

그럼 이제 플러그인을 개발하기 위한 준비는 모두 마쳤습니다. 다음 장에서는 플러그인을 개발하는 환경 설정 및 간단한 플러그인을 만들어보도록 하겠습니다.