👟Einstieg

Erfahren Sie, wie Sie einen Server mit Plazma erstellen.

Um Plazma stabil zu nutzen, muss das System die folgenden Anforderungen erfüllen.

	Minimum	Empfohlen
Architektur	x64	-
RAM	8GB	16GB
Speicherplatz	1GB	8GB
JDK	17	21

Für eine reibungslose Konfigurationsdateibearbeitung ist es auch ratsam, einen Editor wie Visual Studio Code zu installieren.

---

1. JDK 설치

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

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

1.1 JDK 설치 유무 확인

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

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

Richtige Ausgabe

openjdk 21.0.2 2024-01-16 LTS
OpenJDK Laufzeitumgebung 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, gemischter Modus, gemeinsame Nutzung)

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

JDK가 설치되어 있지 않음

'java' ist keine interne oder externe Befehl, ein ausführbares Programm oder
eine Stapeldatei.

JDK가 너무 오래됨

Unbekannte Option: --version
Fehler: Java Virtual Machine konnte nicht erstellt werden.
Fehler: Es ist ein schwerwiegender Ausnahmefehler aufgetreten. Das Programm wird beendet.

1.2 JDK 설치

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

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

Windows

1. Laden Sie zuerst Azul Zulu herunter und installieren Sie JDK 21 im .msi-Format.
2. Führen Sie den heruntergeladenen Installationsassistenten aus und klicken Sie auf Next.

3. Aktivieren Sie im mittleren linken Bereich des Fensters Set JAVA_HOME variable und klicken Sie dann auf Next.

4. Klicken Sie auf Install, um die JRE-Installation abzuschließen.

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

Führen Sie dann den folgenden Befehl im Terminal aus, um JRE zu installieren.

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 herunterladen

Plazma bietet verschiedene Arten von ausführbaren Dateien an.

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

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

Weitere Informationen

Der Name der ausführbaren Datei ist plazma-(Version Manager)-1.20.4-R0.1-SNAPSHOT-(Mapping Typ).jar.

• Mapping Typ Mapping ist eine Art Karte, die den echten Code von Minecraft mit dem obfuszierten Code verbindet.

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

  • Mojmap Mojang-mapped, ist das Mapping für das Vanilla Minecraft. 1.20.6 이후의 모던 플러그인에서 사용합니다.

• Version Manager Der Version Manager ist eine Art Launcher, der die für den Serverbetrieb erforderlichen Bibliotheken bereitstellt und Serverdateien patcht.

  • Paperclip Ein Administrator, den das PaperMC-Team für Paper und andere abgeleitete Plattformen entwickelt hat. Es lädt Bibliotheken herunter und wendet Patches auf den Server an.

  • Bundler Der Version Manager für Vanilla Minecraft.

---

3. Startskript erstellen

Um Plazma einfach zu starten und den Server automatisch neu zu starten, müssen Sie ein erstellen.

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

Sie können das Startskript über den Download-Button unten links herunterladen. Stellen Sie sicher, dass das heruntergeladene Startskript mit Ihrem Betriebssystem übereinstimmt.

---

4. Dateien ordnen

Verschieben Sie das heruntergeladene Startskript und Plazma in einen neuen Ordner.

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

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

Führen Sie nun das Startskript aus. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 허용을 선택해야 합니다.

---

5. EULA-Zustimmung

Nach dem Ausführen des Startskripts wird eine eula.txt-Datei im Ordner erstellt.

Die ist ein Endbenutzer-Lizenzvertrag, dem Sie zustimmen müssen, um die Dienste von zu nutzen.

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

Um der EULA zuzustimmen, ändern Sie eula=false in der eula.txt-Datei in eula=true und speichern Sie die Änderungen.

---

6. Externe Verbindungen zulassen (Windows)

Moderne Betriebssysteme blockieren standardmäßig externe Zugriffe, um vor Gefahren zu schützen, indem sie die Firewall und den Router verwenden.

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

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

Wenn Ihr Router UPnP nicht unterstützt, müssen Sie je nach Routermodell Informationen suchen.

Alternativ können Sie auch Ngrok verwenden, um eine temporäre Adresse zu generieren.

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

6.1 Überprüfung der Notwendigkeit von Port-Weiterleitungen

Geben Sie Folgendes in das Ausführungsfenster ein und führen Sie es aus.

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

Wenn die Ausgabe True ist, sind keine weiteren Maßnahmen erforderlich. Wenn die Ausgabe False ist, müssen Port-Weiterleitungen festgelegt werden.

6.2 Serververbindung

외부에서 접속

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

Die Adresse, die zum Verbinden mit dem Server verwendet wird, finden Sie hier heraus.

UPnP로 포트포워딩 시도

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

Danach, wenn Sie den Server neu starten, versucht Plazma automatisch Portweiterleitung.

Die folgende Meldung auf der Konsole zeigt den Erfolg oder Misserfolg von UPnP an, und in der Konsole wird [UPnP] (Nachricht) angezeigt.

Nachricht	Bedeutung
Port (포트) erfolgreich geöffnet	Portweiterleitung erfolgreich.
Port (포트) ist bereits geöffnet	Ein anderer Dienst verwendet den Port bereits.
Port (포트) konnte nicht geöffnet werden	Portweiterleitung fehlgeschlagen.
Dienst ist nicht verfügbar	Der Router unterstützt kein UPnP.

Wenn der Server heruntergefahren wird, schließt Plazma die Ports automatisch.

Ngrok으로 임시 주소 생성

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

1. Laden Sie die Windows (64-bit) ZIP-Datei von der Ngrok-Website herunter.
2. Legen Sie das heruntergeladene Ngrok in den Serverordner.

3. Erstellen Sie auf dem Ngrok-Dashboard einen Authentifizierungstoken.
4. Führen Sie den im Serverordner angezeigten Befehl in der Command Line aus.

5. Fügen Sie dem Ausführungsskript start /b ngrok tcp --region jp 25565 am Anfang und taskkill /f /t /im ngrok.exe am Ende hinzu.

6. In der Konsole wird Weiterleitung tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565 angezeigt, wobei 0.tcp.jp.ngrok.io:12345 die Adresse des Servers ist.

7. Jetzt können Sie über diese Adresse von extern auf den Server zugreifen.

로컬에서 접속

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

Beispielsweise, wenn nach Ausführung des Befehls Folgendes angezeigt wird:

Windows IP-Konfiguration

Ethernet-Adapter Ethernet:

    Verbundenes DNS-Suffix. . . . :
    IPv4-Adresse. . . . . . . . . : 192.168.3.7
    Subnetzmaske . . . . . . . : 255.255.255.0
    Standardgateway . . . . . . : 192.168.3.1

Versuchen Sie, sich mit der im IPv4-Adressfeld angezeigten 192.168.3.7 zu verbinden, um lokal auf den Server zuzugreifen.

Wenn Server und Spiel auf demselben PC ausgeführt werden, können Sie sich mit localhost verbinden.

7. Fortschritt

Wenn der Server erfolgreich gestartet wurde und ordnungsgemäß funktioniert, ist es jetzt an der Zeit, den Server anzupassen.

Erfahren Sie, wie Sie den Server anpassen können, indem Sie das folgende Handbuch lesen.

https://github.com/PlazmaMC/Document/blob/prod/de/origin/plazma/administration/getting-started/naechster-schritt.md

---