DevTools für PocketMine-MP: vom Pluginordner zur PHAR

Baue einen funktionierenden PocketMine-Befehl, verpacke ihn mit DevTools 1.17.2 und prüfe die PHAR auf einem sauberen Server ohne DevTools.

Inhaltssprache

DevTools verwandelt einen bearbeitbaren PocketMine-Pluginordner in eine PHAR, die du auf einen anderen Server übertragen kannst. Baue den kleinen ModonixWorkshop-Befehl unten, verpacke ihn und prüfe seine Antwort in Minecraft. Wenn der erste Befehl einfach bleibt, ist der Weg vom Quellcode zum funktionierenden Plugin leicht nachzuvollziehen.

Installiere DevTools auf einem kompatiblen PocketMine-Server. Die Befehle unten laufen in der Serverkonsole, ohne vorangestellten Schrägstrich; verwende /workshop für die abschließende Prüfung im Spiel.

Die installierte ModonixWorkshop-PHAR antwortet in Bedrock 26.52 neben unserem hölzernen Lobby-Steg.

Die installierte Beispiel-PHAR antwortet „ModonixWorkshop 0.0.1 is ready.“ Der Steg ist unser Demonstrationsbau, keine mit DevTools gelieferte Karte.

Beginne mit passendem Server und passender DevTools-Datei

Starte für dieses Beispiel Axolotl-PM 5.49.1 in einem separaten Entwicklungsordner mit PHP 8.3.29 ZTS und den vom Server benötigten Erweiterungen. Halte deinen normalen Server getrennt, während du die Bauschritte lernst. Einen Minecraft-Client brauchst du erst, wenn du den Befehl im Spiel ausprobieren möchtest.

Stoppe diesen Server, lege DevTools 1.17.2 als DevTools.phar in seinen Ordner plugins und starte ihn wieder. Gib ein:

plugins
genplugin ModonixWorkshop Modonix

Der erste Befehl listet geladene Plugins auf. Der zweite erstellt plugins/ModonixWorkshop/plugin.yml und plugins/ModonixWorkshop/src/Main.php. Verwende diese Namen im Beispielcode unten: Der Autorenname wird auch Teil des PHP-Namensraums.

Das Erstellen des Ordners lädt das neue Plugin nicht sofort. Stoppe den Server vor der Bearbeitung dieser Dateien und starte ihn nach den Änderungen erneut.

Gib dem Beispiel einen prüfbaren Befehl

Ersetze plugins/ModonixWorkshop/plugin.yml durch:

name: ModonixWorkshop
version: 0.0.1
main: Modonix\ModonixWorkshop\Main
api: 5.44.3
src-namespace-prefix: Modonix\ModonixWorkshop
commands:
  workshop:
    description: Check the workshop plugin
    permission: modonixworkshop.command.workshop
permissions:
  modonixworkshop.command.workshop:
    default: op

Das Beispiel oben behält API 5.44.3 aus der ursprünglichen Anleitung als Mindestversion bei. Eine neu erzeugte Datei kann stattdessen die API des laufenden Servers nennen; der Wert hier ist die Deklaration des Beispiels. DevTools selbst deklariert mindestens API 5.0.0. Das Ändern einer dieser Zahlen passt den Plugincode nicht an eine ältere API an.

Ersetze plugins/ModonixWorkshop/src/Main.php durch:

<?php
declare(strict_types=1);

namespace Modonix\ModonixWorkshop;

use pocketmine\command\Command;
use pocketmine\command\CommandSender;
use pocketmine\plugin\PluginBase;

class Main extends PluginBase{
    public function onCommand(CommandSender $sender, Command $command, string $label, array $args): bool{
        if($command->getName() !== "workshop"){
            return false;
        }
        $sender->sendMessage("ModonixWorkshop 0.0.1 is ready.");
        return true;
    }
}

Starte den Server erneut. DevTools ermöglicht das Laden von Ordnerplugins, deshalb listet plugins sowohl DevTools als auch ModonixWorkshop. Führe workshop aus; der Befehl antwortet ModonixWorkshop 0.0.1 is ready. So hast du vor dem Verpacken ein einfaches Ergebnis zum Prüfen.

Die Befehlsberechtigung ist standardmäßig Operatoren vorbehalten. Nutze für die erste Prüfung von /workshop im Spiel ein Operatorkonto. Sollen später normale Spieler den Befehl nutzen, erteile gezielt modonixworkshop.command.workshop, statt alle zu Operatoren zu machen.

Baue die PHAR aus dem geladenen Ordner

Gib bei geladenem ModonixWorkshop Folgendes ein:

makeplugin ModonixWorkshop

DevTools schreibt das Archiv unter plugin_data/DevTools/ModonixWorkshop_v0.0.1.phar. Behalte den Quellordner ModonixWorkshop als bearbeitbares Projekt. Die PHAR ist die Kopie zum Installieren auf dem anderen Server.

Meldet makeplugin einen ungültigen Pluginnamen, führe plugins aus und prüfe, ob ModonixWorkshop nach dem Neustart geladen wurde. Bei einem Ladefehler behebe vor dem Verpacken den ersten relevanten Konsolenfehler. Meldet PHP, dass PHAR-Erstellung deaktiviert ist, setze phar.readonly=0 in der PHP-Konfiguration des Entwicklungsservers und starte ihn erneut.

Installiere das Paket auf einem separaten Server

Bereite zum Übertragen auf eine andere Installation einen separaten Server mit derselben Server- und PHP-Umgebung vor. Kopiere das Archiv bei gestopptem Server in dessen Verzeichnis plugins; ModonixWorkshop.phar ist ein praktischer Dateiname. Der Pluginname kommt weiterhin aus der plugin.yml im Archiv.

Lass DevTools und den bearbeitbaren Quellordner auf dem ersten Server. Starte den zweiten und führe aus:

plugins
workshop

Der zweite Server sollte ModonixWorkshop laden und der Befehl ModonixWorkshop 0.0.1 is ready. zurückgeben. Halte Ordner und PHAR auf getrennten Servern, damit dasselbe Plugin nicht zweimal geladen wird. Du kannst die verpackte Version auch auf deinem Entwicklungsserver prüfen: Stoppe ihn, verschiebe den Quellordner aus seinem aktiven Pluginverzeichnis, installiere die PHAR und starte neu. Diese verpackte Version zeigt das Minecraft-Bild oben.

Halte Client und Server kompatibel

Wähle die unter Dateien für die ausgewählte Datei angegebene Server-API. Stimme den verbindenden Bedrock-Client getrennt von der Mindest-API des Plugins auf das Spielprotokoll des Servers ab.

Die ursprünglichen PocketMine-MP- und DevTools-Repositories sind archiviert. Verwende beim Lernen oder Warten dieses Servers die bei der Datei angegebene unterstützte Umgebung; ein neuerer Client kann sich nicht mit jedem älteren Serverprotokoll verbinden.

Noch keine Bewertungen

Dateien

Dateien filtern Dateien: 3Stabile Version
Alle Dateien anzeigen

Version 1.17.2

Stabil

DevTools.phar

Serversoftware: PocketMine-MP
1 Download
Herunterladen · 43,7 KB
Anforderungen und Details
  • Serversoftware: PocketMine-MP · Server-API-Version: 5.0.0

Stoppe den Entwicklungsserver, lege DevTools.phar in plugins und starte ihn neu. DevTools 1.17.2 deklariert mindestens PocketMine API 5.0.0. Starte nach dem Erzeugen oder Bearbeiten eines Quellplugins neu, bevor du makeplugin ausführst. Halte seinen bearbeitbaren Ordner und die gebaute PHAR in getrennten aktiven Pluginverzeichnissen. Die Bauschritte in der Serverkonsole benötigen keinen Minecraft-Client.

Voraussetzungen und Hinweise
Bekannte Probleme
Loading a source folder and its PHAR together can cause duplicate-plugin errors. Restart after editing source files. PocketMine-MP 5.44.3 targets Bedrock 26.30; match player clients to the server protocol. The example plugin requires API 5.44.3.
Server-Laufzeitvoraussetzungen
The original PHAR-building walkthrough used PocketMine-MP 5.44.3 with PHP 8.3.29 ZTS on Windows; that server targets Bedrock 26.30. The additional in-game /workshop example uses DevTools 1.17.2 on Axolotl-PM 5.49.1 with PHP 8.3.29 ZTS and Bedrock 26.52 on Windows. DevTools still declares minimum API 5.0.0; the example does not establish support for other server or client versions.

Version 1.17.0

Stabil

DevTools.phar

Serversoftware: PocketMine-MP
0 Downloads
Herunterladen · 43,4 KB
Anforderungen und Details
  • Serversoftware: PocketMine-MP · Server-API-Version: 5.0.0
Voraussetzungen und Hinweise
Server-Laufzeitvoraussetzungen
A compatible PocketMine-MP server and its supported PHP runtime.

Version 1.16.0

Stabil

DevTools.phar

Serversoftware: PocketMine-MP
0 Downloads
Herunterladen · 36,4 KB
Anforderungen und Details
  • Serversoftware: PocketMine-MP · Server-API-Version: 4.0.0
Voraussetzungen und Hinweise
Server-Laufzeitvoraussetzungen
A compatible PocketMine-MP server and its supported PHP runtime.

Versionsänderungen

Version 1.17.2

Stabil

Veröffentlichungsdatum des Originalprojekts: 2025-02-01.

Genau zugehöriger Quellcode: DevTools 1.17.2 – Quellcode

Quelle: DevTools 1.17.2 – Versionshinweise
Die Kompatibilitätsangaben unten entsprechen den vom Autor angegebenen Zielumgebungen. Vollständige Angaben zu Versionen und Geräten findest du in der verlinkten Quelle.

Dateien ansehen

Version 1.17.0

Stabil

Veröffentlichungsdatum des Originalprojekts: 2023-06-01.

Genau zugehöriger Quellcode: DevTools 1.17.0 – Quellcode

Quelle: DevTools 1.17.0 – Versionshinweise
Die Kompatibilitätsangaben unten entsprechen den vom Autor angegebenen Zielumgebungen. Vollständige Angaben zu Versionen und Geräten findest du in der verlinkten Quelle.

Dateien ansehen

Version 1.16.0

Stabil

Veröffentlichungsdatum des Originalprojekts: 2022-09-24.

Genau zugehöriger Quellcode: DevTools 1.16.0 – Quellcode

Quelle: DevTools 1.16.0 – Versionshinweise
Die Kompatibilitätsangaben unten entsprechen den vom Autor angegebenen Zielumgebungen. Vollständige Angaben zu Versionen und Geräten findest du in der verlinkten Quelle.

Dateien ansehen

Kommentare 0

Teile, was funktioniert hat, stelle eine Frage oder antworte einem anderen Spieler.

An der Diskussion teilnehmen

1Dein Name und deine E-Mail-Adresse

Kein Konto nötig. Bestätige deine E-Mail-Adresse vor deinem ersten Kommentar mit einem Code. Neben deinem Namen erscheint nur eine maskierte Adresse. Gastkommentare werden vor der Veröffentlichung geprüft.

2Prüfen und veröffentlichen

Noch keine Kommentare. Erzähle, was bei dir funktioniert hat.

Modonix durchsuchen

Suchen in