為了穩定使用Plazma，系統必須滿足以下要求。
為了方便進行配置文件修改，建議安裝類似的編輯器。
1. JDK 설치
이름에서 알 수 있듯이, Minecraft: "Java" Edition 은 Java로 개발되어, 실행을 위해선 를 필요로 합니다.
Plazma는 Mojang Studios의 공식 서버 플랫폼을 , Plazma를 사용하기 위해서도 JDK를 설치해야 합니다.
1.1 JDK 설치 유무 확인
JDK가 시스템에 설치되어 있는지 확인하려면, 에 을 입력하고 실행합니다.
다음과 같이 출력되면 로 건너뜁니다.
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가 없거나 너무 오래되었으므로, 를 수행해야 합니다.
'java'不是内部或外部命令，也不是可运行的程序或批处理文件。
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를 사용합니다.
在左上角的菜單中啟用Set JAVA_HOME variable，然後點擊“下一步”。
먼저, 다음 명령어를 터미널에서 실행하여 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
다음 명령어를 입력하여 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을 사용합니다.
了解更多
執行文件名為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並自動重新啟動服務器，需要創建。
通過左下角的下載按鈕下載啟動腳本。
請確認下載的啟動腳本與您的操作系統相符。
4. 整理文件
現在將下載的啟動腳本和Plazma移動到新文件夾中。
폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.
그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다.
現在執行啟動腳本。 Windows의 경우, 방화벽 허용 선택 창에서, 반드시 허용을 선택해야 합니다.
5. EULA同意
執行啟動腳本後，文件夾中將生成eula.txt。
是使用Mojang Studios的服務時必須同意的使用權協議。
만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재를 받을 수 있습니다.
要同意EULA，請將eula.txt文件中的eula=false修改為eula=true，然後保存。
6. 允許外部訪問（Windows）
現代操作系統通常會阻止外部訪問以防止危險訪問。
Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.
6.1 檢查是否需要端口轉發
輸入以下命令並運行。
powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content"
如果輸出為True，則可以結束，否則需要設置端口轉發。
6.2 連接到服務器
포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다.
서버 폴더의 purpur.yml에서, network.upnp-port-forwarding을 true로 활성화합니다.
然後重新啟動伺服器，Plazma將自動嘗試進行端口轉發。
以下是根據控制台輸出的消息來判斷UPnP是否成功，控制台將顯示類似[UPnP]（消息）的消息。
當伺服器關閉時，Plazma會自動關閉埠。
Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다.
在伺服器資料夾中執行顯示在下方Command Line的命令。
在執行腳本的最上方添加 start /b ngrok tcp --region jp 25565，在最底部添加 taskkill /f /t /im ngrok.exe。
在控制台頂部顯示的 Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565 中，0.tcp.jp.ngrok.io:12345將成為伺服器的地址。
로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 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. 發展
如果伺服器成功啟動並正常運行，現在輪到您自定義伺服器了。
请查看以下说明书以了解如何个性化服务器。
