👟시작하기

Plazma로 서버를 만드는 방법을 알아 보세요.

Plazma를 안정적으로 사용하기 위해선, 시스템이 다음과 같은 요구 사항을 충족해야 합니다.

	최저	권장
아키텍쳐	x64	-
RAM	8GB	16GB
저장공간	1GB	8GB
JDK	17	21

원할한 구성 파일 수정을 위하여, Visual Studio Code등의 편집기를 설치하는것도 좋습니다.

---

1. JDK 설치

이름에서 알 수 있듯이, Minecraft: "Java" Edition 은 Java로 개발되어, 실행을 위해선 를 필요로 합니다.

Plazma는 Mojang Studios의 공식 서버 플랫폼을 , Plazma를 사용하기 위해서도 JDK를 설치해야 합니다.

1.1 JDK 설치 유무 확인

JDK가 시스템에 설치되어 있는지 확인하려면, 에 을 입력하고 실행합니다.

다음과 같이 출력되면 2 단계로 건너뜁니다.

올바른 출력

openjdk 21.0.2 2024-01-16 LTS
OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS)
OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing)

위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, 1.2 단계를 수행해야 합니다.

JDK가 설치되어 있지 않음

'java'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는
배치 파일이 아닙니다.

JDK가 너무 오래됨

Unrecognized option: --version
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit.

1.2 JDK 설치

본 설명서에서는 JDK의 로 Azul Zulu를 사용합니다.

설치를 완료한 후, 1.1 단계을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요.

Windows

1. 먼저, Azul Zulu 에서 JDK 21을 .msi 형태로 다운로드 합니다.

2. 다운로드된 설치 마법사를 실행하고, 다음을 클릭합니다.

3. 창 좌측 중앙에 표시되는 메뉴에서 Set JAVA_HOME variable을 활성화 한 후, 다음을 클릭합니다.

4. 설치를 눌러 JRE 설치를 완료합니다.

macOS

Azul Zulu 에서 JDK 21을 .dmg 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다.

Debian/Ubuntu

먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다.

sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y

curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg

echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list

그런 다음, 다음 명령어를 터미널에서 실행하여 JRE를 설치합니다.

sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless

Fedora/RHEL

다음 명령어를 입력하여 JDK를 설치할 수 있습니다.

sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm

sudo dnf install -y zulu21-ca-jre-headless

---

2. Plazma 다운로드

Plazma에서는 여러 가지 형태의 실행 파일을 제공하고 있습니다.

대부분의 경우에는 Mojang-mapped Paperclip을 사용합니다.

아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다. 일반 사용자라면 3 단계로 뛰어 넘겨도 문제되지 않습니다.

자세히 알아보기

실행 파일의 이름은 plazma-(버전 관리자)-1.20.4-R0.1-SNAPSHOT-(매핑 형태).jar 로 정해집니다.

• 매핑 형태 매핑은 Minecraft의 실제 코드와 난독화된 코드를 잇는 일종의 지도입니다.

  • Reobf Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다. 1.20.6부터 지원이 종료되었습니다.

  • Mojmap Mojang-mapped, 바닐라 Minecraft 매핑입니다. 1.20.6 이후의 모던 플러그인에서 사용합니다.

• 버전 관리자 버전 관리자는 서버 구동에 필요한 라이브러리와, 서버 파일을 패치하는 서버의 런처라고 할 수 있습니다.

  • Paperclip PaperMC 팀에서 Paper 및 기타 파생 플랫폼을 위해 개발한 관리자로, 라이브러리를 다운로드 하고 서버에 패치를 적용하는 역할을 합니다.

  • Bundler 바닐라 Minecraft 버전 관리자입니다.

---

3. 시작 스크립트 생성

Plazma를 간단하게 시작하고, 서버를 자동으로 재시작 하려면, 를 만들어야 합니다.

Flags.sh를 통해 시작 스크립트를 생성할 수 있습니다. Plazma에 만 입력하면 명령어가 자동으로 최적화 됩니다.

좌측 하단 다운로드 버튼을 통해 시작 스크립트를 다운로드 할 수 있습니다. 다운로드한 시작 스크립트가 자신의 운영체제와 동일한지 확인하세요.

---

4. 파일 정리

이제 다운로드한 시작 스크립트와 Plazma를 새 폴더에 이동합니다.

폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.

그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다.

이제 시작 스크립트를 실행합니다. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 허용을 선택해야 합니다.

---

5. EULA 동의

시작 스크립트를 한 번 실행하면, 폴더에 eula.txt 가 생성됩니다.

는 의 서비스를 이용함으로써 동의해야 하는 사용권 계약입니다.

만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재를 받을 수 있습니다.

EULA에 동의하려면 eula.txt 파일의 eula=false를 eula=true로 수정하고 저장합니다.

---

6. 외부 접속 허용 (Windows)

현대 운영 체제는 외부에서 위험한 접근을 차단하기 위해, 기본적으로 방화벽과 라우터가 외부 접속을 차단하고 있습니다.

Windows의 경우, 방화벽은 3 단계에서 허용했으므로, 포트 포워딩만 하면 됩니다.

해당 설명서는 Windows 운영 체제 및 를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.

라우터가 UPnP를 지원하지 않는 경우, 라우터 별로 패널이 다르므로, 직접 자료를 검색해야 합니다.

또는 Ngrok을 통해 임시 주소를 생성할 수도 있습니다.

Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.

6.1 포트 포워딩 필요 유무 확인

실행 창에 다음과 같이 입력하고 실행합니다.

powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content"

만약 출력이 True라면, 여기서 마쳐도 되지만, False라면 포트 포워딩을 설정해야 합니다.

6.2 서버에 접속

외부에서 접속

포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다.

서버에 접속할 때 사용되는 주소는 여기에서 확인할 수 있습니다.

UPnP로 포트포워딩 시도

서버 폴더의 purpur.yml에서, network.upnp-port-forwarding을 true로 활성화합니다.

그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다.

아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 [UPnP] (메세지) 와 같이 출력됩니다.

메세지	의미
Successfully opened port (포트)	포트포워딩 성공.
Port (포트) is already open	다른 서비스가 해당 포트를 사용중임.
Failed to open port (포트)	포트포워딩 실패.
Service is unavailable	라우터가 UPnP를 지원하지 않음.

서버가 종료되면 Plazma가 자동으로 포트를 닫습니다.

Ngrok으로 임시 주소 생성

Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다.

1. Ngrok 홈페이지에서 Windows (64-bit) ZIP 파일을 다운로드 합니다.

2. 다운로드한 Ngrok을 서버 폴더에 넣습니다.

3. Ngrok 대시보드 에서 합니다.

4. 서버 폴더에서 아래 Command Line에 표시되는 명령어를 실행합니다.

5. 실행 스크립트 가장 상단에 start /b ngrok tcp --region jp 25565, 최하단에 taskkill /f /t /im ngrok.exe를 추가합니다.

6. 콘솔 최상단에 표시된 Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565 에서, 0.tcp.jp.ngrok.io:12345가 서버의 주소가 됩니다.

7. 이제 외부에서 해당 주소를 통해 접속할 수 있습니다.

로컬에서 접속

로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 cmd /k ipconfig를 실행하여 출력된 IPv4 주소 로 접속할 수 있습니다.

예를 들어, 명령어 실행 후 다음과 같이 출력되었을 때,

Windows IP 구성

이더넷 어댑터 이더넷:

    연결된 DNS 접미사. . . . :
    IPv4 주소. . . . . . . . . : 192.168.3.7
    서브넷 마스크 . . . . . . . : 255.255.255.0
    기본 게이트웨이 . . . . . . : 192.168.3.1

여기에서 IPv4 주소에 표시된 192.168.3.7로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다.

서버와 게임이 같은 PC에서 실행되는 경우, localhost로 접속할 수 있습니다.

7. 발전하기

서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다.

아래 설명서를 통해 서버를 사용자화 하는 방법에 대해 알아보세요.

🎨발전하기

---