Modpacks installieren
Modpacks installieren
Vollständige Anleitung zum 8-Schritte-Installationsprozess, Egg-Wechsel, Backup-Erstellung, Dateibewahrung, Konfigurationszusammenführung, Direktinstallation und alle möglichen Fehler.
Vor der Installation
Installationstyp-Erkennung
Das Plugin liest .installed_modpack.json vom Server-Root:
| Typ | Bedingung | Emoji | Was passiert |
|---|---|---|---|
| Erstinstallation | Keine Tracking-Datei gefunden | 🟢 | Saubere Installation |
| Update | Gleiches Modpack, andere Version | 🟠 | Wahl: Konfigurationen behalten oder löschen |
| Wechsel | Andere Modpack-ID | 🔴 | Vollständige Bereinigung + neue Installation |
| Neuinstallation | Gleiches Modpack + gleiche Version | 🔵 | Aktuelle Version neu installieren |
Tracking-Datei
.installed_modpack.json benötigt 6 Felder: provider, modpack_id, modpack_name, version_id, version_name, installed_at. Fehlt ein Feld, wird als Erstinstallation behandelt.
Der 8-Schritte-Installationsprozess
Schritt 1: Bewahren (💾)
Wichtige Dateien werden vor dem Löschen im Speicher gesichert:
Root-Dateien bewahrt: server.properties, eula.txt, ops.json, banned-players.json, banned-ips.json, whitelist.json, usercache.json
Verzeichnisse bewahrt (rekursiv): /config/, /plugins/
Schritt 2: Backup (📦)
Ein automatisches Backup wird mit deutschem Namen basierend auf dem Installationstyp erstellt:
| Typ | Beispiel-Backup-Name |
|---|---|
| Erstinstallation | „Modpack-Erstinstallation" |
| Update | „Modpack-Update" |
| Wechsel | „Modpack-Wechsel" |
| Neuinstallation | „Modpack-Neuinstallation" |
Backup-Anzahl wird verwaltet — ältestes wird bei Erreichen des Limits gelöscht.
Schritt 3: Löschen (🗑️)
Alle Serverdateien werden gelöscht außer geschützte Verzeichnisse:
Geschützt (nie gelöscht): worlds, plugins, logs
Schritt 4: Download (⬇️)
- Server wird gestoppt (erzwungen)
- Egg gewechselt zu „Minecraft Modpack Installer"
- Variablen gesetzt:
MODPACK_PROVIDER,MODPACK_ID,MODPACK_VERSION_ID - Server neu installiert — löst den Download aus
- Warten auf Download — max. 300 Sekunden Timeout
Schritt 5: Entpacken (📦→📂)
Nach Download wird die Extraktion überwacht:
- Dateistabilitäts-Überwachung: Prüft Dateigrößen wiederholt
- 3 aufeinanderfolgende stabile Prüfungen = Dekompression abgeschlossen
Schritt 6: Wiederherstellen (♻️)
Bewahrte Dateien werden wiederhergestellt:
- Bei Update (Konfigurationen behalten): /config/ und /plugins/ werden übersprungen (werden in Schritt 7 zusammengeführt)
- Bei Wechsel/Erstinstallation/Update (löschen): Alles wiederherstellen
Schritt 7: Zusammenführen (🔀)
Bis zu 45 Sekunden Warten auf Erscheinen der mods/ und config/-Verzeichnisse.
Konfigurations-Merge-Strategien
| Format | Erweiterungen | Strategie |
|---|---|---|
| JSON | .json |
Rekursiver Merge: neue Struktur + alte Werte |
| YAML | .yml, .yaml |
Schlüssel-Merge mit Kommentar-Bewahrung |
| Properties | .properties, .cfg |
Schlüssel=Wert-Merge |
| TOML | .toml |
Abschnittsbasierter Merge mit Header-/Kommentar-Bewahrung |
Plugin-Konfigurations-Zusammenführung
Nach dem Root-Konfigurations-Merge werden auch /plugins/PluginName/-Unterverzeichnisse zusammengeführt:
- Scannt jedes Plugin-Konfigurations-Verzeichnis
- Führt individuelle Konfigurationsdateien mit den gleichen Format-Strategien zusammen
- Überspringt Dateien wo alter oder neuer Inhalt leer ist
Schritt 8: Abschließen (✅)
- Egg zurückgewechselt zu „Minecraft Modpack Runtime"
- Tracking-Datei gespeichert
- Installation abgeschlossen
Installations-Aktionsmatrix
| Aktion | Erst. | Update (löschen) | Update (behalten) | Wechsel |
|---|---|---|---|---|
| Backup erstellen | ✓ | ✓ | ✓ | ✓ |
| Mods löschen | — | ✓ | ✓ | ✓ |
| Konfigurationen löschen | — | ✓ | — | ✓ |
| Mod-Konfigurationen zusammenführen | — | — | ✓ | — |
| Wichtige Dateien wiederherstellen | — | ✓ | ✓ | ✓ |
Plugin-übergreifende Bereinigung
Bei Modpack-Installation oder -Wechsel bereinigt das Plugin automatisch Daten anderer Plugins:
Game Mods Bereinigung
- Löst dynamisch
Eranio\GameMods\Services\SafeCacheServiceundCacheKeyServiceauf - Leert
server_installed_mods-Tabelle für den Server - Log: „Cleaned database mods for server {uuid}"
Minecraft Plugins Bereinigung
- Löst dynamisch
Eranio\MinecraftPlugins\Services\SafeCacheServiceundCacheKeyServiceauf - Leert
minecraft_installed_plugins-Tabelle für den Server - Log: „Cleaned database plugins for server {uuid}"
Fortschritts-Widget
Während der Installation zeigt ein Fortschritts-Widget alle 8 Schritte:
| Funktion | Detail |
|---|---|
| Abfrageintervall | 2 Sekunden |
| Schritt-Indikatoren | Pfeilförmig mit clip-path CSS |
| Mobiloptimiert | Eigenes CSS für mobile Sichtbarkeit |
| Auto-Weiterleitung | Bei Abschluss automatische Weiterleitung |
Vollständige Fehlerreferenz
Download-Fehler
| Log | Ursache | Lösung |
|---|---|---|
| „[Modpack] Download timeout" | 300s überschritten | Timeout erhöhen, Servernetzwerk prüfen, kleineres Modpack versuchen |
| Egg-Wechsel fehlgeschlagen | Installer-Egg fehlt | Prüfen ob Seeder erfolgreich gelaufen ist |
Extraktions-Fehler
| Log | Ursache | Lösung |
|---|---|---|
| „[Modpack] Decompression timeout" | Dateistabilität nie erreicht | Festplatte voll, beschädigter Download, sehr großes Modpack |
Merge-Fehler
| Log | Ursache | Lösung |
|---|---|---|
| „[Modpack] Could not merge config file" | Ungültiges Format, Parse-Fehler | Konfig-Syntax prüfen, manuell zusammenführen |
| Konfig-Verzeichnisse erscheinen nicht binnen 45s | Extraktion unvollständig | Schritt 5 prüfen, Festplatte prüfen |
Plugin-übergreifende Bereinigungsfehler
| Log | Auswirkung |
|---|---|
| „GameMods classes not found" | Nicht kritisch — alte Daten können bestehen bleiben |
| „MinecraftPlugins classes not found" | Nicht kritisch |