Farbthema
العربية Беларуская Български Čeština Dansk Deutsch Ελληνικά English Español Suomi Français עברית Magyar Bahasa Indonesia Italiano 日本語 한국어 Lietuvių Nederlands Norsk ☠ Pirate Polski Português (BR) Português (PT) Română Русский Slovenčina Српски Svenska Türkçe Українська 简体中文 繁體中文

Installation & Einrichtung

Eranio

Installation & Einrichtung

Vollständige Schritt-für-Schritt-Anleitung zur Installation des Minecraft Plugins-Plugins und zur Aktivierung für deine Spielserver.

Voraussetzungen

  • Pelican Panel Version 1.0.0-rc.1+ installiert und laufend
  • PHP 8.5 auf dem Panel-Server
  • Ein vom Panel verwalteter Minecraft-Server
  • Datenbankbenutzer mit CREATE TABLE Rechten (das Plugin erstellt die Tabelle minecraft_installed_plugins)
  • storage/ und bootstrap/cache/ beschreibbar (Berechtigungen 0755, Eigentümer: Webserver-Benutzer)

Schritt 1: Plugin installieren

  1. Lade die neueste minecraft-plugins Plugin-Version herunter
  2. Platziere es im plugins/-Verzeichnis deines Pelican Panels: 
    /var/www/pelican/plugins/minecraft-plugins/
  3. Überprüfe die Verzeichnisstruktur: 
    plugins/minecraft-plugins/
├── src/
├── config/
├── resources/
├── database/
└── plugin.json
  4. Leere den Anwendungscache: 
    php artisan cache:clear
php artisan config:clear
php artisan view:clear
  5. Überprüfe, ob das Plugin unter Admin Panel → Plugins als „Minecraft Plugins" erscheint

Das Plugin erstellt die Datenbanktabelle minecraft_installed_plugins automatisch beim ersten Laden.

Schritt 2: Für einen Server aktivieren

Das Plugin verwendet das Feature-Flag plugins auf Eggs.

  1. Gehe zu Admin Panel → Eggs
  2. Bearbeite dein Minecraft-Server-Egg (z.B. „Paper", „Spigot", „Purpur")
  3. Füge plugins zum Features-Feld hinzu: 
    ["plugins"]
    Wenn das Egg bereits Features hat: 
    ["eula", "java_version", "plugins"]
  4. Klicke Speichern

Wichtig: Das Feature-Flag muss genau plugins lauten (Kleinbuchstaben). Plugins, PLUGINS oder plugin funktionieren nicht.

Hinweis: Die 403-Fehlermeldung ist derzeit auf Deutsch fest einprogrammiert: „Modpack Browser ist für diesen Server nicht verfügbar.", dies ist ein bekanntes Problem.

Schritt 3: Minecraft-Versionserkennung

Das Plugin erkennt deine Minecraft-Version automatisch mit 11 Methoden (identisch zu Game Mods):

Priorität Methode Was geprüft wird
1 variables.txt Im Panel gespeicherte Servervariablen
2 server.properties Versionsbezogene Eigenschaften
3 version.json Mojangs Versionsmanifest
4 Fabric JAR Fabric-Server-JAR-Dateiname
5 Forge JAR Forge-Server-JAR-Dateiname
6 Forge-Bibliotheken Bibliotheksverzeichnisstruktur
7 Rekursive Suche Durchsucht 7 Verzeichnisse (Tiefe 1-6). Überspringt: node_modules, cache, temp, logs, crash-reports, Weltverzeichnisse, mods, plugins. Max. Pfad: 250 Zeichen
8 server.jar Generische Server-JAR-Analyse
9 Paper JAR PaperMC-Dateiname
10 Spigot JAR Spigot-Dateiname
11 Purpur JAR Purpur-Dateiname

Validierung: Altes Schema 1.x (Minor 0-50) oder Mojangs Jahres-Schema seit 2026 (26.1, 26.2, 26.3). Normalisiert auf major.minor. 5 Minuten gecacht.

Suche nach Version: Die gewählte Version gilt für die ganze Versionsfamilie. 26.1 findet auch Einträge, die nur für 26.1.1 oder 26.1.2 markiert sind, 1.21 findet 1.21.1 bis 1.21.11. Die Unterversionen kommen live aus Mojangs Versionsliste (12 Stunden zwischengespeichert), neue Versionen wie 26.3.1 oder 27.1 werden ohne Plugin-Update erkannt.

Versionsunabhängige Anbieter

GeyserMC und PaperMC/Hangar sind versionsunabhängig, der MC-Versionsfilter wird in der Oberfläche bei diesen Anbietern ausgeblendet. Kein minecraftVersion-Parameter wird an die API gesendet.

Schritt 4: Erster Start

  1. Navigiere zu deinem Server → klicke Plugin Browser in der Seitenleiste
  2. Das Plugin erkennt Spiel und Version
  3. Anbieter-Tabs erscheinen: SpigotMC, CurseForge, Modrinth, Hangar, GeyserMC
  4. Vorhandene Plugins in /plugins/ werden gescannt und als „Manual / Upload" registriert
  5. Bereit zum Durchsuchen und Installieren!

Überprüfungsliste

Prüfung Erwartet Bei Fehler
Plugin in Admin → Plugins „Minecraft Plugins" aufgelistet Falscher Pfad oder Cache nicht geleert
„Plugin Browser" in der Seitenleiste Sichtbar für Server mit plugins Feature Feature-Flag fehlt auf dem Egg
Anbieter-Tabs SpigotMC, CurseForge, Modrinth, Hangar, GeyserMC JS-/Netzwerkfehler
Version erkannt „Detected: X.X.X" Benachrichtigung Server nie gestartet oder keine JAR
minecraft_installed_plugins Tabelle Existiert in der Datenbank php artisan migrate ausführen

Fehlerbehebung

Plugin nicht im Admin Panel

  • Stelle sicher, dass der Pfad genau plugins/minecraft-plugins/ ist
  • Führe php artisan cache:clear aus und lade neu
  • Prüfe storage/logs/laravel.log auf „Class not found" Fehler

„Plugin Browser" nicht in der Seitenleiste

  • Egg muss "plugins" in Features haben
  • Speichere das Egg nach dem Bearbeiten
  • Lösche den Konfigurationscache: php artisan config:clear

Versionserkennung fehlgeschlagen

  • Starte den Server einmal, damit JAR + version.json generiert werden
  • Benenne eigene JARs erkennbar um (server.jar, paper-26.3.jar)
  • Verwende das manuelle Dropdown als Workaround

Datenbank-Migrationsfehler

  • Vergib CREATE TABLE: GRANT CREATE ON your_database.* TO 'user'@'localhost';
  • Führe manuell aus: php artisan migrate
Konfiguration