So fügst du Mods zu deinem Minecraft PocketMine Edition Server hinzu

PocketMine-MP kennt keine klassischen Mods. Erweitert wird der Server stattdessen über Plugins – kleine PHP-Erweiterungen im .phar-Format, die ausschließlich auf dem Server laufen.

Wichtig

Weder Forge- oder Fabric-Mods noch Bedrock Add-Ons funktionieren auf einem PocketMine-Server. Forge und Fabric gehören zur Java Edition, und Behaviour Packs werden von PocketMine-MP ausdrücklich nicht unterstützt. Packs, die ein Behaviour Pack voraussetzen, funktionieren dort ebenfalls nicht korrekt.

Hinweis

Plugins laufen komplett auf dem Server. Deine Mitspieler müssen dafür nichts installieren und können mit einem unveränderten Minecraft Bedrock Client beitreten.

Wo finde ich Plugins?

Die offizielle Plugin-Plattform von PocketMine-MP ist Poggit:

• Poggit Release

Achtung

Lade Plugins nur aus vertrauenswürdigen Quellen herunter und achte darauf, dass das Plugin zur installierten PocketMine-Hauptversion passt.

Plugin installieren

1. Plugin herunterladen
   Lade das Plugin als .phar-Datei herunter.

2. Server stoppen
   Stoppe deinen Server über die Verwaltung.

3. Per SFTP verbinden
   Verbinde dich per SFTP mit deinem Server oder nutze den Datei-Browser in der Verwaltung.

4. Plugin hochladen
   Lade die .phar-Datei im Hauptordner deines Servers in folgenden Ordner hoch:

   plugins

5. Server starten
   Starte deinen Server. Beim Start wird das Plugin geladen.

Tipp

Beim ersten Start legt ein Plugin in der Regel einen eigenen Unterordner mit seinen Konfigurationsdateien an. Standardmäßig liegt dieser im Ordner plugin_data im Hauptordner deines Servers. Die Dateien darin kannst du anschließend anpassen.

Plugin aktualisieren

1. Server stoppen
   Stoppe deinen Server über die Verwaltung.

2. Alte Version löschen
   Lösche die alte .phar-Datei des Plugins aus dem Ordner plugins.

   Wichtig

   Die offizielle PocketMine-Dokumentation weist ausdrücklich darauf hin, alte Versionen eines Plugins zu löschen und den Server neu zu starten. Lass die alte Datei also nicht einfach liegen.

3. Neue Version hochladen
   Lade die neue .phar-Datei in den Ordner plugins hoch.

4. Server starten
   Starte deinen Server, damit die Änderung wirksam wird.

Plugin entfernen

1. Server stoppen
   Stoppe deinen Server über die Verwaltung.

2. Plugin löschen
   Lösche die .phar-Datei aus dem Ordner plugins.

3. Konfiguration löschen
   Lösche optional den zugehörigen Unterordner des Plugins im Ordner plugin_data.

4. Server starten
   Starte deinen Server.

Wo liegen die Konfigurationsdateien der Plugins?

Standardmäßig sammelt PocketMine-MP die Konfigurationen aller Plugins im Ordner plugin_data im Hauptordner deines Servers – jedes Plugin bekommt dort einen eigenen Unterordner.

Möchtest du stattdessen die alte Struktur nutzen, bei der die Konfiguration eines Plugins direkt unterhalb von plugins/ liegt, setze in der Datei pocketmine.yml im Hauptordner deines Servers folgenden Wert:

plugins:
  legacy-data-dir: true

Hinweis

Standardmäßig steht dieser Wert auf false. Die Option existiert laut Kommentar in der pocketmine.yml nur aus Kompatibilitätsgründen für ältere Installationen – bei einem neuen Server musst du sie nicht ändern.

Resource Packs für die Optik

Optische Änderungen für alle Spieler setzt du über Resource Packs um.

1. Server stoppen
   Stoppe deinen Server über die Verwaltung.

2. Pack hochladen
   Lade das Resource Pack als .zip- oder .mcpack-Datei im Hauptordner deines Servers in folgenden Ordner hoch:

   resource_packs

3. Pack registrieren
   Öffne im Ordner resource_packs die Datei resource_packs.yml und trage den Dateinamen inklusive Endung in die Liste resource_stack ein:

   resource_stack:
     - MeinPack.mcpack

4. Server starten
   Starte deinen Server.

Hinweis

Der Stapel unter resource_stack wird von unten nach oben angewendet: Einträge weiter oben überschreiben Einträge weiter unten.

Achtung

Entpackte Resource Packs (also einfache Ordner) werden nicht unterstützt – erlaubt sind ausschließlich .zip und .mcpack. Ebenso lassen sich Resource Packs nicht pro Welt festlegen, sie gelten immer für den gesamten Server.

Resource Pack verpflichtend machen

Mit dem Eintrag force_resources in der Datei resource_packs.yml im Ordner resource_packs legst du fest, ob Spieler das Pack laden müssen, um beitreten zu können:

force_resources: true