Was ist Purpur und wie wird es installiert? Umstieg von Paper und purpur.yml-Einstellungen
Purpur ist eine Minecraft-Java-Serversoftware auf Basis von Paper, mit der Sie das Gameplay über die Datei purpur.yml fein abstimmen können. In dieser Anleitung erfahren Sie, wie sich Purpur von Paper unterscheidet, wie Sie die JAR-Datei herunterladen und einen neuen Server starten und wie Sie Ihren bestehenden Paper-Server ohne Verlust Ihrer Welt auf Purpur umstellen; außerdem geht es um die wichtigsten Einstellungen, Berechtigungen und die Plugin-Kompatibilität. Einen allgemeinen Vergleich der Serversoftware finden Sie in der Anleitung Unterschiede zwischen Vanilla, Spigot und PaperMC, weitere Themen auf der Seite Minecraft-Anleitungen.
Bevor Sie beginnen
- Ein VDS mit Windows oder Linux. Da Purpur mit den Standardeinstellungen wie Paper läuft, hat es dieselben Hardwareanforderungen wie Paper; entscheidend sind bei Minecraft die Java-Version und der RAM. Die Pakete finden Sie auf der Seite Minecraft-Server mieten. Falls Sie sich noch nicht für ein Betriebssystem entschieden haben, lesen Sie die Anleitung Windows oder Linux.
- Die richtige Java-Version. Die Installationsseite von Purpur verweist auf die Einstiegsanleitung von Paper. Laut der Tabelle von Paper wird Java 17 für Minecraft 1.17–1.19 empfohlen, Java 21 für 1.20–1.21.11 und Java 25 für 26.1 und neuer. Prüfen Sie die installierte Version mit
java -version; die Installation von Java und das Schreiben von Startskripten behandelt die Anleitung zur Einrichtung von Grund auf. - Ein vollständiges Backup. Wenn Sie umziehen möchten, kopieren Sie den gesamten Serverordner (Welten, den Ordner
pluginsund die Konfigurationsdateien). Bei VDS liegen Backups in Ihrer Verantwortung; Sie können die Kopie per SFTP auf einen Speicher außerhalb des Servers übertragen, etwa den Cloud-Backup-Speicher. - Version und Plugin-Liste. Notieren Sie die aktuell verwendete Minecraft-Version und Ihre Plugins.
- Ein offener Port. Der TCP-Port 25565, über den sich die Spieler verbinden, muss in der Firewall des Betriebssystems geöffnet sein; die Schritte stehen in der Anleitung zum Öffnen von Ports.
1. Verstehen, wie sich Purpur von Paper unterscheidet
Purpur ist ein Fork von Paper; die eigene Dokumentation beschreibt es als Drop-in-Ersatz für Paper, der keine Änderungen erfordert. Als Fork bringt es alle Funktionen und Performance-Fixes von Paper mit, dazu den Profiler spark, der seit 1.21 mitgeliefert wird. Laut der FAQ-Seite von Purpur greift keine der zusätzlichen Änderungen, solange Sie sie nicht in purpur.yml aktivieren; wenn Sie die Datei nicht anfassen, unterscheidet sich der Betrieb von Purpur nicht von dem von Paper.
Kurz gesagt: Purpur ist kein „schnelleres Paper“, sondern ein Paper mit mehr Einstellungen. Wenn Sie nur auf Purpur wechseln, um die TPS (Ticks pro Sekunde) zu erhöhen, werden Sie mit den Standardeinstellungen keinen Unterschied bemerken.
| Thema | Paper | Purpur |
|---|---|---|
| Basis | Fork von Spigot | Fork von Paper |
| Konfigurationsdateien | server.properties, bukkit.yml, spigot.yml, config/paper-global.yml, config/paper-world-defaults.yml | Alle Dateien von Paper, zusätzlich purpur.yml im Hauptverzeichnis |
| Standard-Gameplay | Verhalten von Paper | Wie Paper; Unterschiede ergeben sich erst durch das Aktivieren von Optionen in purpur.yml |
| Von Purpur hinzugefügte Befehle | — | /purpur, /tpsbar, /rambar, /ram, /uptime, /ping, /compass, /credits, /demo |
| Plugin-API | Bukkit, Spigot, Paper | Zusätzlich die Purpur-API |
| Zusätzliche Berechtigungen | — | Zum Beispiel allow.ride.<mob>; standardmäßig deaktiviert, auch für OPs (Operatoren) |
| Download | Downloadseite von PaperMC | purpurmc.org/downloads und api.purpurmc.org |
2. Zwischen Purpur und Paper entscheiden
| Ihre Situation | Empfehlung |
|---|---|
| Ein Survival-, Minigame- oder Economy-Server mit Plugins; das Gameplay soll nah an Vanilla bleiben | Paper reicht aus. |
| Sie möchten Gameplay-Änderungen wie reitbare Mobs, eine Endertruhe (Ender Chest) mit sechs Reihen oder das Abbauen von Spawnern (Blöcke, die Mobs erzeugen) mit Behutsamkeit (Silk Touch) | Purpur |
| Sie möchten die KI von Dorfbewohnern abschalten, die sich in vollen Handelshallen nicht bewegen können | Purpur (die Einstellung lobotomize) |
| Sie möchten Spieler, die nicht an der Tastatur sind (AFK), ankündigen, statt sie zu kicken | Purpur |
| Sie möchten sofort auf eine neue Minecraft-Version umsteigen | Da Purpur ein Fork von Paper ist, erscheinen Builds für eine neue Version erst nach denen von Paper; außerdem erhält nicht jede Nebenversion einen Build (für 1.20.3 und 1.20.5 gibt es keinen). Wenn Ihre Version nicht auf der Downloadseite steht, bleiben Sie bei Paper. |
3. Die Purpur-JAR-Datei herunterladen
Laden Sie Purpur nur aus der offiziellen Quelle herunter: von der Seite purpurmc.org/downloads oder über die Download-API, die diese Seite nutzt. Auf der Seite können Sie die Version auswählen und den neuesten Build herunterladen; verwenden Sie als „Experimental“ markierte Builds nicht auf einem Live-Server. Die API-Adressen lauten:
https://api.purpurmc.org/v2/purpur: listet die Minecraft-Versionen auf, für die es Builds gibt.https://api.purpurmc.org/v2/purpur/<version>: listet die Build-Nummern für diese Version auf.https://api.purpurmc.org/v2/purpur/<version>/latest/download: lädt den neuesten Build für diese Version herunter. Bei einer neuen Version kann dieser Build experimentell sein; wenn Sie die Adresse ohne/downloadaufrufen und"type": "experimental"sehen, warten Sie auf einen stabilen Build.
Legen Sie unter Linux den Serverordner an und laden Sie die Datei unter dem Namen purpur.jar herunter (das Beispiel verwendet Version 26.2; geben Sie Ihre eigene Version an):
mkdir ~/purpur
cd ~/purpur
curl -o purpur.jar https://api.purpurmc.org/v2/purpur/26.2/latest/download
Legen Sie unter Windows einen Ordner wie C:\purpur an, öffnen Sie PowerShell in diesem Ordner und führen Sie den folgenden Befehl aus; -UseBasicParsing verhindert die Sicherheitsabfrage von Windows PowerShell 5.1:
Invoke-WebRequest -UseBasicParsing -Uri https://api.purpurmc.org/v2/purpur/26.2/latest/download -OutFile purpur.jar
Eine mit dem Browser heruntergeladene Datei trägt Version und Build-Nummer im Namen, in der Form purpur-26.2-2633.jar; verwenden Sie diesen Namen im Startbefehl oder ändern Sie den Dateinamen in purpur.jar.
4. Einen neuen Purpur-Server starten
Wenn Sie den Server neu aufsetzen, legen Sie die Datei purpur.jar in einen leeren Ordner und führen Sie im selben Ordner den folgenden Befehl aus; der Befehl ist in Windows PowerShell und unter Linux identisch:
java -Xms4G -Xmx4G -jar purpur.jar --nogui
-Xms und -Xmx legen den Arbeitsspeicher fest, der dem Server zugewiesen wird, während --nogui verhindert, dass sich ein separates grafisches Fenster öffnet. Paper empfiehlt, beide Werte gleich zu halten und etwa 1000–1500 MB vom gesamten Arbeitsspeicher des Servers abzuziehen (zum Beispiel 6500 MB auf einem Server mit 8 GB); Details finden Sie in der Anleitung zur RAM-Zuweisung.
Beim ersten Start erstellt der Server die Datei eula.txt und beendet sich. Akzeptieren Sie die Minecraft-EULA, indem Sie die Zeile eula=false in der Datei in eula=true ändern, und führen Sie den Befehl erneut aus. Beim Start des Servers werden im Hauptverzeichnis server.properties, bukkit.yml, spigot.yml, der Ordner config/ und purpur.yml angelegt. Purpur schreibt alle Optionen mit ihren Standardwerten in diese Datei. Um die laufende Software zu überprüfen, geben Sie in der Konsole Folgendes ein:
purpur version
5. Von Paper zu Purpur wechseln
- Informieren Sie die Spieler und fahren Sie den Server mit dem Befehl
stopin der Konsole herunter. Die Update-Anleitung von Paper weist darauf hin, die JAR-Datei nicht bei laufendem Server auszutauschen. - Erstellen Sie ein vollständiges Backup des Serverordners.
- Laden Sie den Purpur-Build für die Minecraft-Version herunter, die Sie unter Paper genutzt haben. Führen Sie ein Versions-Upgrade als separaten Schritt durch; wenn Sie Software und Version gleichzeitig ändern, lässt sich die Ursache eines Problems schwerer eingrenzen.
- Entfernen Sie die Paper-JAR-Datei, legen Sie die Purpur-JAR-Datei ein und passen Sie ihren Namen an den Startbefehl an. Wenn in Ihrem Startskript
paper.jarsteht, ändern Sie den Namen im Skript inpurpur.jar. - Starten Sie den Server und lesen Sie das erste Startprotokoll (
logs/latest.log). Welten, Plugins und Paper-Einstellungen werden unverändert übernommen; die einzige neue Datei im Hauptverzeichnis istpurpur.yml.
Wenn Sie von Spigot oder Vanilla kommen, gelten die Regeln für den Umstieg auf Paper, da Purpur die Weltstruktur von Paper verwendet. Für 26.1 und neuer gibt die Paper-Dokumentation an, dass ein direkter Umstieg von Spigot nicht möglich ist; die Schritte stehen im Migrationsabschnitt der Vergleichsanleitung.
Die Rückkehr zu Paper bedeutet ebenfalls nur den Austausch der JAR-Datei. Funktionen, die Sie über purpur.yml aktiviert haben, und Plugins, die ausschließlich auf die Purpur-API setzen, funktionieren unter Paper jedoch nicht. Wenn Sie zum Beispiel die Endertruhe mit sechs Reihen aktiviert haben, verwendet Paper die üblichen drei Reihen; bitten Sie die Spieler vor der Rückkehr, die zusätzlichen Reihen zu leeren, und halten Sie ein Backup bereit.
6. Den Aufbau der purpur.yml kennenlernen
purpur.yml liegt im Hauptverzeichnis des Servers und besteht aus zwei Hauptabschnitten:
settings: allgemeine Einstellungen für den gesamten Server (Befehle, Nachrichten, Netzwerk und einige Blöcke wie die Endertruhe).world-settings: Einstellungen pro Welt. Werte unterdefaultgelten für alle Welten, die keinen eigenen Abschnitt haben. Um eine einzelne Welt abweichend zu konfigurieren, legen Sie auf derselben Ebene wiedefaulteinen nach dieser Welt benannten Abschnitt an und tragen dort nur die Zeilen ein, die Sie ändern möchten. In 1.21.11 und älter ist dieser Name der Name des Weltordners (zum Beispielworld_nether); in den Versionen 26.x ist es der Schlüssel der Welt (zum Beispielminecraft:the_nether). Beim Upgrade von einer älteren Version verschiebt Purpur diese Abschnitte selbst auf den neuen Namen.
Auch der Dateikopf weist darauf hin: Einige Optionen verändern das Gameplay. Ändern Sie jeweils nur eine Einstellung und beobachten Sie das Ergebnis. Der sichere Weg, Änderungen zu übernehmen, ist ein Neustart des Servers. /purpur reload liest die Datei neu ein; beim Ausführen erscheint jedoch eine Warnung, dass diese Methode nicht unterstützt wird und Probleme verursachen kann und dass Sie den Server bei Problemen mit /stop neu starten sollten. Um die Auswirkung zu beobachten, öffnet der Befehl /tpsbar oben auf dem Bildschirm eine Leiste mit TPS, MSPT (Millisekunden pro Tick) und Ping.
7. Berechtigungen vergeben und Plugin-Kompatibilität prüfen
Die von Purpur hinzugefügten Spielerberechtigungen (zum Beispiel allow.ride.cow) sind laut der Berechtigungsseite standardmäßig für alle deaktiviert, auch für OPs; Sie müssen sie mit einem Berechtigungs-Plugin wie LuckPerms vergeben. Aktivieren Sie zuerst die Funktion in purpur.yml und vergeben Sie dann die Berechtigung. Um der Gruppe default, der in LuckPerms alle Spieler angehören, die Berechtigung zum Reiten von Kühen zu geben, führen Sie Folgendes in der Konsole aus:
lp group default permission set allow.ride.cow true
Purpur-Befehle sind an die Berechtigungen bukkit.command.<command> gebunden (zum Beispiel bukkit.command.tpsbar). Wenn Essentials (EssentialsX) installiert ist, überschreibt es die Befehle /ping, /uptime und /compass mit eigenen Befehlen; um die von Purpur zu verwenden, tragen Sie diese Befehle in der Essentials-Konfiguration in die Liste disabled-commands ein.
Laut der FAQ-Seite von Purpur funktionieren CraftBukkit-, Spigot- und Paper-Plugins unter Purpur; Inkompatibilitäten entstehen, wenn ein Plugin-Autor die Unterstützung fest auf CraftBukkit oder Spigot beschränkt und Paper sowie dessen Forks ignoriert. Ein Plugin installieren Sie wie bei Paper: Legen Sie die .jar-Datei in den Ordner plugins, starten Sie den Server neu und geben Sie in der Konsole plugins ein. Grüne Namen sind aktivierte Plugins; rote Namen sind nicht aktivierte Plugins (meist solche, die nicht geladen werden konnten). Wenn ein Plugin Probleme verursacht, testen Sie dasselbe Plugin mit einer Kopie der Welt unter Paper; tritt das Problem nur unter Purpur auf, melden Sie es auf der GitHub-Seite oder dem Discord-Server von Purpur.
Beispielkonfiguration: wichtige Einstellungen in der purpur.yml
Die Werte stammen aus der Konfigurationsreferenz von Purpur; die Spalte „Abschnitt“ zeigt, unter welchem Hauptabschnitt die Einstellung steht.
| Abschnitt | Einstellung | Standard | Was bewirkt sie? |
|---|---|---|---|
settings | use-alternate-keepalive | false | Sendet dem Spieler jede Sekunde eine Verbindungsprüfung (Keepalive) und kickt ihn nur, wenn 30 Sekunden lang keine davon beantwortet wird; ein einzelnes verlorenes Paket trennt den Spieler nicht. |
settings | tps-catchup | true | Lässt den Server, nachdem die TPS unter 20 gefallen sind, schneller als 20 laufen, um den Durchschnitt zu halten. Laut Dokumentation hat das Nebenwirkungen, etwa dass Mobs den Spieler bei Lag auf einen Schlag töten. |
settings | blocks.ender_chest.six-rows | false | Erweitert die Endertruhe auf sechs Reihen. |
world-settings.default | mobs.<mob>.ridable | false | Macht den Mob reitbar. Der Spieler steigt mit Shift + Rechtsklick auf; erfordert die Berechtigung allow.ride.<mob>. |
world-settings.default | mobs.villager.lobotomize.enabled | false | Schaltet die KI von Dorfbewohnern ab, die sich nicht bewegen können; der Handel funktioniert weiterhin. Das Prüfintervall wird mit check-interval festgelegt (Standard: 100 Ticks). |
world-settings.default | gameplay-mechanics.player.idle-timeout.kick-if-idle | true | Steht der Wert auf false, wird ein Spieler, der die in server.properties mit player-idle-timeout festgelegte Leerlaufzeit überschreitet, nicht gekickt, sondern als AFK angekündigt. Ist die Zeit 0 (Standard), läuft keine AFK-Erkennung. |
world-settings.default | gameplay-mechanics.silk-touch.enabled | false | Spawner lassen sich mit einer Spitzhacke mit Behutsamkeit (Silk Touch) abbauen; erfordert die Berechtigungen purpur.drop.spawners und purpur.place.spawners. |
world-settings.default | gameplay-mechanics.use-better-mending | false | Die Verzauberung Reparatur (Mending) repariert zuerst den am stärksten beschädigten Gegenstand. |
Das folgende Beispiel aktiviert einige dieser Einstellungen. Da die Schlüssel bereits in der Datei vorhanden sind, ändern Sie die vorhandenen Werte, statt neue Zeilen hinzuzufügen:
settings:
use-alternate-keepalive: true
blocks:
ender_chest:
six-rows: true
world-settings:
default:
gameplay-mechanics:
use-better-mending: true
player:
idle-timeout:
kick-if-idle: false
mobs:
cow:
ridable: true
villager:
lobotomize:
enabled: true
In diesem Beispiel können Spieler mit der entsprechenden Berechtigung Kühe reiten, und wenn player-idle-timeout größer als 0 ist, werden AFK-Spieler angekündigt statt gekickt. Alle Optionen finden Sie auf der Konfigurationsseite von Purpur.
Häufige Fehler
- Der Server startet nicht und meldet den Fehler „Could not load purpur.yml, please correct your syntax errors“. Die YAML-Einrückung ist fehlerhaft. Verwenden Sie zum Einrücken Leerzeichen, keine Tabs; vergleichen Sie die zuletzt geänderte Zeile mit der Datei in Ihrem Backup oder stellen Sie die Datei
purpur.ymlaus dem Backup wieder her. - Der Server beendet sich sofort mit einem Java-Fehler (z. B.
UnsupportedClassVersionError). Die installierte Java-Version ist für die Purpur-Version zu alt. Die Versionen 26.x benötigen Java 25, 1.20–1.21.11 benötigen Java 21; prüfen Sie dies mitjava -version. - Fehler „Unable to access jarfile purpur.jar“. Der Dateiname stimmt nicht mit dem im Befehl überein; eine mit dem Browser heruntergeladene Datei enthält Version und Build-Nummer im Namen. Benennen Sie die Datei um.
ridable: trueist gesetzt, aber der Mob lässt sich nicht reiten. Die Berechtigung fehlt. Die Berechtigungallow.ride.<mob>ist selbst für OPs deaktiviert; vergeben Sie sie mit LuckPerms und steigen Sie mit Shift + Rechtsklick auf den Mob.- Es erscheint keine AFK-Ankündigung, oder Spieler werden weiterhin gekickt. Der Wert
kick-if-idlemussfalsesein, und in der Dateiserver.propertiesmuss der Wertplayer-idle-timeoutgrößer als 0 sein.
Häufig gestellte Fragen
Ist Purpur schneller als Paper?
Im Allgemeinen nicht; die Leistungsbasis ist Paper, und wenn purpur.yml unverändert bleibt, läuft Purpur wie Paper. Einige Optionen, etwa das Abschalten der Dorfbewohner-KI, zielen auf bestimmte Situationen ab. Um die Wirkung einer Änderung zu messen, erstellen Sie mit spark, das von Paper mitgebracht wird, ein zehnminütiges Profil: /spark profiler start --timeout 600.
Kann ich von Purpur zu Paper zurückwechseln?
Ja, Sie müssen nur die Paper-JAR-Datei für dieselbe Minecraft-Version einsetzen. Purpur-spezifische Funktionen und Plugins werden deaktiviert; erstellen Sie vorher ein Backup.
Welchen Purpur-Build sollte ich wählen?
Wählen Sie den neuesten Build, der für die Minecraft-Version Ihres Servers veröffentlicht wurde, und verwenden Sie als experimentell markierte Builds nicht auf einem Live-Server. Purpur veröffentlicht möglicherweise nicht für jede Version Builds; prüfen Sie Ihre Version auf der Downloadseite oder in der Liste unter https://api.purpurmc.org/v2/purpur.
Was passiert mit meinen bestehenden Paper-Einstellungen?
Sie bleiben unverändert und werden weiter verwendet. Die Werte in config/paper-global.yml, config/paper-world-defaults.yml, spigot.yml und bukkit.yml gelten auch unter Purpur; purpur.yml ist eine zusätzliche Ebene darüber.
Weiterführende Anleitungen
- Vanilla, Spigot, Paper, Purpur und Folia: Was sollten Sie wählen?
- Minecraft-Server von Grund auf einrichten: Paper unter Windows und Linux
- RAM für einen Minecraft-Server zuweisen: Xms, Xmx und Aikar's Flags
- Ports für einen Minecraft-Server öffnen (25565, 19132, Proxy)
- Windows oder Linux für einen Minecraft-Server? Ein ehrlicher Vergleich
Kommentare0
Noch keine Kommentare
Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.
Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.