👟Getting Started

Learn how to create a server with Plazma.

To use Plazma stably, the system must meet the following requirements:

	Minimum	Recommended
Architecture	x64	-
RAM	8GB	16GB
Storage Space	1GB	8GB
JDK	17	21

For smooth configuration file editing, it is also good to install an editor like Visual Studio Code.

---

1. JDK 설치

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

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

1.1 JDK 설치 유무 확인

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

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

Correct output

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' is not recognized as an internal or external command,
operable program or batch file.

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. First, download JDK 21 in .msi format from Azul Zulu.

2. Run the downloaded installation wizard and click Next.

3. After activating Set JAVA_HOME variable in the menu displayed in the middle left of the window, click Next.

4. Press Install to complete the JRE installation.

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

Then, install JRE by running the following command in the terminal.

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 Download

Plazma provides various types of executable files.

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

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

Learn more

The name of the executable file is determined as plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mapping type).jar.

• Mapping Type Mapping is a kind of map that connects the actual code of Minecraft with the obfuscated code.

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

  • Mojmap Mojang-mapped, the vanilla Minecraft mapping. 1.20.6 이후의 모던 플러그인에서 사용합니다.

• Version Manager The version manager can be considered as a launcher for the server, which is necessary for running the server and patching server files.

  • Paperclip Developed by the PaperMC team for Paper and other derivative platforms, it downloads libraries and applies patches to the server.

  • Bundler The vanilla Minecraft version manager.

---

3. Creating a Startup Script

To easily start Plazma and automatically restart the server, you need to create a startup script.

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

You can download the startup script by clicking the bottom left download button. Make sure the downloaded startup script matches your operating system.

---

4. File Organization

Now, move the downloaded startup script and Plazma to a new folder.

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

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

Now, run the startup script. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 허용을 선택해야 합니다.

---

5. EULA Agreement

Once you run the startup script, a eula.txt file will be generated in the folder.

is a license agreement that must be agreed upon by using the services of Mojang Studios.

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

To agree to the EULA, change eula=false to eula=true in the eula.txt file and save it.

---

6. Allow External Connections (Windows)

Modern operating systems block external access by default using Firewalls and Routers to prevent dangerous access from outside.

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

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

If the router does not support UPnP, you need to search for information yourself as different routers have different panels.

Alternatively, you can also generate a temporary address using Ngrok.

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

6.1 Check the Need for Port Forwarding

Enter the following in the execution window and run it.

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

If the output is True, you can finish here, but if it is False, you need to set up port forwarding.

6.2 Connect to the Server

외부에서 접속

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

The address to use when connecting to the server can be checked here.

UPnP로 포트포워딩 시도

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

Then, when you restart the server, Plazma will automatically attempt port forwarding.

The success of UPnP will be based on the message output on the console, which will be displayed as [UPnP] (message).

Message	Meaning
Successfully opened port (port)	Port forwarding successful.
Port (port) is already open	Another service is using the port.
Failed to open port (port)	Port forwarding failed.
Service is unavailable	The router does not support UPnP.

When the server is shut down, Plazma automatically closes the port.

Ngrok으로 임시 주소 생성

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

1. Download the Windows (64-bit) ZIP file from Ngrok website.

2. Put the downloaded Ngrok into the server folder.

3. Generate an authentication token from Ngrok Dashboard as mentioned in footnote 13.

4. Run the command displayed in the Command Line at the top of the execution script in the server folder.

5. Add start /b ngrok tcp --region jp 25565 at the top and taskkill /f /t /im ngrok.exe at the bottom of the execution script.

6. At the top of the console, the address Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565 indicates that 0.tcp.jp.ngrok.io:12345 is the server address.

7. Now you can connect from outside using this address.

로컬에서 접속

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

For example, when the following is displayed after running the command,

Windows IP Configuration

Ethernet Adapter Ethernet:

    Connected DNS Suffix. . . . :
    IPv4 Address. . . . . . . . : 192.168.3.7
    Subnet Mask . . . . . . . . : 255.255.255.0
    Default Gateway . . . . . . : 192.168.3.1

You can connect to the server from your local machine by attempting to connect to the 192.168.3.7 displayed in the IPv4 address.

If the server and the game are running on the same PC, you can connect using localhost.

7. To develop

If you have successfully started the server and it is running correctly, it is now time to customize the server.

Learn how to customize the server through the following guide.

🎨발전하기

---