Installation & Einrichtung
Eranio
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 1.0.0-rc.1 oder neuer installiert und aktiv
- PHP 8.5 auf dem Panel-Server
- Ein vom Panel verwalteter Minecraft-Server
storage/undbootstrap/cache/beschreibbar (Berechtigungen0755)- 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, 9, 11, 16, 17, 21, 25. Das Plugin wählt für jede Installation das passende, siehe Modpacks installieren. Das Runtime-Egg hat zwei Startbefehle, Default (Java 9 bis 25) und Java 8.
Schritt 2: Egg konfigurieren
Das Plugin verwendet das modpacks-Feature-Flag.
- Gehe zu Admin Panel → Eggs
- Bearbeite dein Minecraft-Server-Egg
- Füge
modpacksim 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 | Java-Image und Startbefehl je Pack gesetzt |
Ü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.jsonim Plugin-Root prüfenstorage/logs/laravel.logauf 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 dasmodpacks-Feature beim Egg fehlt modpackszu den Egg-Features hinzufügen und speichern