Installation & Einrichtung

Vollständige Schritt-für-Schritt-Anleitung zur Installation des Minecraft Modpacks Plugins, Egg-Konfiguration und Vorbereitung des Servers für Modpack-Installationen.

Voraussetzungen

Pelican Panel Version 1.0.0+ installiert und aktiv
PHP 8.1, 8.2 oder 8.3 auf dem Panel-Server
Ein vom Panel verwalteter Minecraft-Server
storage/ und bootstrap/cache/ beschreibbar (Berechtigungen 0755)
Datenbankbenutzer mit CREATE TABLE-Berechtigung

Schritt 1: Plugin installieren

Lade die neueste Version des minecraft-modpacks-Plugins herunter
Platziere es im plugins/-Verzeichnis deines Pelican Panels:
```
/var/www/pelican/plugins/minecraft-modpacks/
```

Leere den Anwendungscache:

php artisan cache:clear
php artisan config:clear
php artisan view:clear

Überprüfe, ob das Plugin unter Admin Panel → Plugins erscheint

Auto-Seeder

Das Plugin führt seinen Seeder automatisch bei jedem Panel-Start aus (in try-catch eingepackt). Der Seeder erstellt:

Minecraft Modpack Installer Egg — Für den Download, Features: ['eula', 'java_version', 'minecraft', 'modpacks', 'plugins', 'mods', 'installer']
Minecraft Modpack Runtime Egg — Standard-Minecraft-Server-Egg

Docker-Images konfiguriert: Java 8, 11, 16, 17, 21.

Schritt 2: Egg konfigurieren

Das Plugin verwendet das modpacks-Feature-Flag.

Gehe zu Admin Panel → Eggs
Bearbeite dein Minecraft-Server-Egg
Füge modpacks im Feld Features hinzu:
```
["modpacks"]
```
Klicke Speichern

Feature-Flag muss exakt modpacks (Kleinbuchstaben) sein. Die automatisch erstellten Eggs haben dieses Feature bereits.

Schritt 3: Eggs überprüfen

Nach dem ersten Laden beide Eggs verifizieren:

Egg	Zweck	Wichtige Features
Minecraft Modpack Installer	Handhabt Download + Entpacken	Hat `MODPACK_PROVIDER`, `MODPACK_ID`, `MODPACK_VERSION_ID` Variablen
Minecraft Modpack Runtime	Führt den Modpack-Server aus	Standard-Minecraft-Features

Überprüfungscheckliste

Prüfung	Erwartet	Bei Problemen
Plugin in Admin → Plugins	Gelistet	Cache leeren, Pfad prüfen
„Modpack Browser" in Seitenleiste	Sichtbar	Feature-Flag fehlt (`modpacks`)
Installer-Egg existiert	„Minecraft Modpack Installer" in Eggs	Seeder nicht gelaufen — Logs prüfen
Runtime-Egg existiert	„Minecraft Modpack Runtime" in Eggs	Seeder nicht gelaufen

Fehlerbehebung

Plugin nicht sichtbar

Alle Caches leeren: php artisan cache:clear && php artisan config:clear && php artisan view:clear
plugin.json im Plugin-Root prüfen
storage/logs/laravel.log auf Fehler prüfen

Eggs nicht automatisch erstellt

Seeder läuft bei jedem Start — Logs auf Seeder-Fehler prüfen
Datenbankbenutzer hat möglicherweise keine CREATE TABLE-Berechtigung

„Modpack Browser ist für diesen Server nicht verfügbar"

Plugin ruft abort(403) auf wenn das modpacks-Feature beim Egg fehlt
modpacks zu den Egg-Features hinzufügen und speichern