為了穩定使用Plazma，系統必須滿足以下要求。
為了方便進行配置文件修改，建議安裝類似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 단계를 수행해야 합니다.
'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를 사용합니다.
설치를 완료한 후, 1.1 단계을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요.
在左上角的菜單中啟用Set JAVA_HOME variable，然後點擊“下一步”。
Azul Zulu 에서 JDK 21을 .dmg 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다.
먼저, 다음 명령어를 터미널에서 실행하여 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을 사용합니다.
아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다.
일반 사용자라면 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。
是使用Mojang Studios的服務時必須同意的使用權協議。
만일 동의하지 않는 경우, 서버를 시작할 수 없으며, 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，則可以結束，否則需要設置端口轉發。
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. 發展
如果伺服器成功啟動並正常運行，現在輪到您自定義伺服器了。
请查看以下说明书以了解如何个性化服务器。
🎨발전하기
