כדי להשתמש ב-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 Zulu21.32+17-CA (בנייה 21.0.2+13-LTS)
OpenJDK 64-Bit שרת VM Zulu21.32+17-CA (בנייה 21.0.2+13-LTS, מצב מעורב, שיתוף)
위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, 1.2 단계를 수행해야 합니다.
'java' הוא פקודה פנימית או חיצונית, תוכנית הניתנת לביצוע, או
קובץ batch אינו זמין.
אפשרות לא מוכרת: --version
שגיאה: לא ניתן היה ליצור את מכונת ה-Java הווירטואלית.
שגיאה: שגיאה חמורה אירעה. התוכנית תיצא.
1.2 JDK 설치
본 설명서에서는 JDK의 로 Azul Zulu를 사용합니다.
설치를 완료한 후, 1.1 단계을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요.
התחל על ידי הורדת JDK 21 בפורמט .msi מ-Azul Zulu.
הרץ את אשף ההתקנה שהורדת ולחץ על 'הבא'.
בתפריט המוצג במרכז השמאלי של החלון, הפעל את 'Set JAVA_HOME variable' ולאחר מכן לחץ על 'הבא'.
לחץ על 'התקן' כדי להשלים את התהליך של התקנת JRE.
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, מפת 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 서버에 접속
포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다.
서버에 접속할 때 사용되는 주소는 여기에서 확인할 수 있습니다.
서버 폴더의 purpur.yml에서, network.upnp-port-forwarding을 true로 활성화합니다.
그런 다음, 서버를 재시작하면, Plazma가 자동으로 포트 포워딩을 시도합니다.
아래는 콘솔에 출력되는 메세지에 따른 UPnP 성공 여부이며, 콘솔에서는 [UPnP] (메세지) 와 같이 출력됩니다.
서버가 종료되면 Plazma가 자동으로 포트를 닫습니다.
Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다.
다운로드한 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
מתאם Ethernet Ethernet:
סיומת DNS מחוברת. . . . :
כתובת IPv4. . . . . . . . . : 192.168.3.7
מסכת תת-רשת . . . . . . . : 255.255.255.0
שער ברירת מחדל . . . . . . : 192.168.3.1
여기에서 IPv4 주소에 표시된 192.168.3.7로 접속을 시도하면 로컬에서 서버에 접속할 수 있습니다.
서버와 게임이 같은 PC에서 실행되는 경우, localhost로 접속할 수 있습니다.
7. להתפתח
서버를 성공적으로 시작하고 서버가 올바르게 작동중이라면, 이제 서버를 사용자화 할 차례입니다.
קרא את המדריך הבא כדי ללמוד כיצד להתאים אישית את השרת.
