So gibst du neuen Spielern auf deinem Paper-Server ein Starterkit

Was ein Minecraft-Starterkit beim ersten Join macht

Das Kit in dieser Anleitung besteht aus einem Steinschwert, einer Steinspitzhacke und 16 Brot, gefolgt von einer privaten Chatnachricht, die dem Neuling sagt, was er gerade bekommen hat. Es wird automatisch verteilt, wenn ein Spieler deinen Server zum ersten Mal betritt. Du musst keinen Befehl eingeben und keine Berechtigung einrichten.

„Zum ersten Mal“ heißt hier das, was Paper schon weiß: ein Spieler, den der Server vor seinem Join noch nie gespeichert hatte. Die Laufzeit führt keine eigene Liste und keinen Zähler. Deshalb funktioniert das Kit auf einem Server, den du schon betreibst, und deshalb kann es auch ein paar Dinge nicht, die weiter unten stehen.

Diese Anleitung nutzt den Blockeditor von NimBlock und seine eigenständige, kostenlose Laufzeit. Mit einem NimBlock-Konto kannst du die Regel speichern. Um sie auszuführen, brauchst du einen bestehenden Minecraft-Java-Server, bei dessen Hoster du Plugins hochladen darfst. Die Schritte unten sind für Paper 1.21.11 mit Java 21. Du brauchst keinen Server, der bei NimBlock gehostet wird.

Die Kit-Regel im Studio bauen

1. Öffne deine Plugins in NimBlock und erstelle ein neues Plugin. Der Editor startet mit einer Begrüßungsregel; du kannst sie behalten oder löschen.
2. Zieh aus Regeln eine neue Regel in das Plugin und nenne sie Starterkit.
3. Setz aus Auslöser den Block Ein Spieler verbindet sich in ihren wenn-Platz.
4. Setz aus Bedingungen den Block Spieler ist zum ersten Mal hier in ihren falls-Platz.
5. Füge aus Aktionen dreimal Dem Spieler einen Gegenstand geben hinzu: STONE_SWORD mit Anzahl 1, STONE_PICKAXE mit Anzahl 1, BREAD mit Anzahl 16.
6. Füge zum Schluss Dem Spieler eine Nachricht senden hinzu, zum Beispiel Willkommen {player}! Hier ist ein Starterkit für den Anfang. Lass {player} genau so stehen: Die Laufzeit ersetzt es durch den Namen des Spielers.
7. Speichere das Plugin. Kopiere auf seiner Seite das komplette angezeigte JSON in eine reine Textdatei namens starter-kit.json, gespeichert als UTF-8.

Items werden mit ihrem Minecraft-Namen geschrieben, zum Beispiel IRON_AXE oder COOKED_BEEF. Tausch die drei Items gegen dein eigenes Kit aus: eine Aktion pro Item, jeweils mit ihrer Anzahl. Die öffentliche Grammatik listet alle verfügbaren Auslöser, Bedingungen und Aktionen auf.

Auf deinem bestehenden Paper-Server installieren

1. Lade die NimBlock-Laufzeit herunter. Stopp deinen Server, leg die .jar der Laufzeit direkt in plugins/ und starte den Server dann.
2. Prüf mit /plugins, ob NimBlock aktiviert ist. Die Anleitung von Paper zum Installieren von Plugins erklärt, wie du ein fehlgeschlagenes Laden untersuchst.
3. Lade starter-kit.json nach plugins/NimBlock/specs/ hoch. Achte auf die Großbuchstaben im Ordnernamen. Leg den Ordner vorher an, falls nötig.
4. Führ als Server-Operator /nimblock reload aus, dann /nimblock list. Der Name deines gespeicherten Plugins sollte erscheinen. In der Serverkonsole lässt du den Schrägstrich am Anfang weg.

Behebe jeden Fehler, der beim Neuladen gemeldet wird, bevor du testest. Ein unbekannter Item-Name fällt erst auf, wenn die Regel ausgeführt wird, also prüf die Schreibweise jedes Items vor deinem ersten Test.

Mit einem Konto testen, das noch nie auf dem Server war

Dein eigenes Konto hat schon auf deinem Server gespielt, deshalb bekommt es das Kit nicht, und genau so soll die Regel funktionieren. Teste mit einem Minecraft-Java-Konto, das diesen Server noch nie betreten hat, zum Beispiel dem eines Freundes, oder auf einer Kopie deines Servers mit einer neuen Welt. Beim ersten Join sollte das Konto das Schwert, die Spitzhacke, das Brot und die Nachricht bekommen. Trenn die Verbindung, warte kurz und verbinde dich neu: Es sollte nichts mehr verteilt werden.

Spieler, die vor der Installation der Regel schon da waren, sind keine Neulinge und bekommen das Kit nicht. Das Laden der Regel spielt frühere Joins nicht nach.

Die Grenzen eines Starterkits beim ersten Join

• Einmal pro Spieler, solange der Server sich an ihn erinnert: Die Bedingung liest die Spielerdaten von Paper selbst. Wenn du eine neue Welt startest, ist jeder wieder ein Neuling und bekommt das Kit noch einmal. Wenn du die Daten eines Spielers löschst, ist nur dieser Spieler wieder ein Neuling und bekommt das Kit erneut.
• Gilt für die ganze erste Sitzung: Die Bedingung ist nicht nur im Moment des Joins wahr, sondern bis der Neuling die Verbindung trennt, auch wenn der Server ihn zwischendurch speichert. Lass sie unter Ein Spieler verbindet sich; unter einem anderen Auslöser, zum Beispiel beim Wiederbeleben, könnte ein Neuling das Kit in dieser ersten Sitzung ein zweites Mal bekommen.
• Kein tägliches Kit, keine Abklingzeit, kein Zähler: Die Laufzeit reagiert auf Ereignisse und merkt sich nichts, deshalb kann sie kein Kit „einmal am Tag“ oder „dreimal pro Spieler“ geben.
• Einfache Items: Die Aktion gibt eine Item-Art und eine Anzahl. Verzauberungen und eigene Namen gehören nicht dazu.
• Volles Inventar: Was nicht hineinpasst, fällt dem Spieler vor die Füße. Das Inventar eines Neulings ist normalerweise leer, also spielt das selten eine Rolle.

Das Kit ändern, ohne die Laufzeit neu zu installieren

Bearbeite die Regel im Studio und speichere eine neue Version. Ersetze den Inhalt derselben Datei starter-kit.json durch das neu gespeicherte JSON und führ dann /nimblock reload aus. Der nächste Neuling bekommt das neue Kit; Spieler, die schon das alte bekommen haben, erhalten nichts mehr. Wenn du die alte und die neue Datei behältst, werden beide Regeln geladen und zwei Kits verteilt.

Du kannst die Laufzeit auf deinem eigenen kompatiblen Paper-Server nutzen, ohne Hosting bei NimBlock zu kaufen. Deine Regel bleibt eine lesbare JSON-Datei, die du ansehen und zusammen mit dem Backup deines Servers aufbewahren kannst.