العربية Беларуская Български Č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

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+ installiert und laufend
  • PHP 8.1, 8.2 oder 8.3 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: Muss mit 1. beginnen, Minor 0-50. Normalisiert auf major.minor. 5 Minuten gecacht.

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-1.21.4.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