Modpacks installieren

Eranio

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 schaut in der Tabelle server_installed_modpacks nach, welches Pack für den Server gespeichert ist:

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:

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 (⬇)

1. Server wird gestoppt (erzwungen)
2. Egg gewechselt zu „Minecraft Modpack Installer"
3. Variablen gesetzt: MODPACK_PROVIDER, MODPACK_ID, MODPACK_VERSION_ID
4. Server neu installiert, löst den Download aus
5. 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

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

1. Minecraft-Version geprüft: aus dem Installationsspeicher, aus den Dateien gelesen, falls der Anbieter sie nicht geliefert hat
2. Egg zurückgewechselt zu „Minecraft Modpack Runtime" mit passendem Java-Image und Startbefehl
3. Pack gespeichert in server_installed_modpacks mit Minecraft- und Java-Version
4. Installationsspeicher abgeschlossen mit Status done

Java und Startbefehl

Welche Java-Version der Server braucht, hängt vom Pack ab. Das Plugin findet das selbst heraus:

1. Zu Beginn der Installation fragt es beim Anbieter, für welche Minecraft-Version die gewählte Pack-Version gebaut ist. Modrinth liefert game_versions, CurseForge gameVersions (oder die Version aus dem Dateinamen, wenn die Liste leer ist).
2. Bei ATLauncher, FeedTheBeast, Technic und VoidsWrath wird die Version nach dem Download aus den installierten Dateien gelesen: modrinth.index.json, manifest.json, libraries/net/minecraft/server oder versions.
3. Am Ende bekommt das Runtime-Egg das passende Docker-Image und den passenden Startbefehl.

Lässt sich keine Version ermitteln, wird Java 21 verwendet.

Startbefehl

Jeder Modpack-Server startet mit den G1-Flags nach Aikar. Der Befehl liest bei jedem Start das Speicherlimit des Servers:

Forge- und NeoForge-Packs ab 1.17 starten über unix_args.txt, alle anderen über server.jar. Java-8-Packs nutzen dieselben Flags ohne Argumentdateien.

Installationsspeicher

Jede Installation wird beim Start in die Tabelle server_modpack_installs geschrieben: Anbieter, Pack, Version, Minecraft-Version, Herkunft der Version, Java-Version, Image und Status (running, done, failed, aborted). Der Installer liest diesen Eintrag während der Installation und am Ende. Nach einer erfolgreichen Installation stehen Minecraft- und Java-Version auch beim installierten Pack in server_installed_modpacks.

Installations-Aktionsmatrix

Plugin-übergreifende Bereinigung

Bei Modpack-Installation oder -Wechsel bereinigt das Plugin automatisch Daten anderer Plugins:

Game Mods Bereinigung

• Löst dynamisch Eranio\GameMods\Services\SafeCacheService und CacheKeyService auf
• 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\SafeCacheService und CacheKeyService auf
• 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:

Vollständige Fehlerreferenz

Download-Fehler

Extraktions-Fehler

Merge-Fehler

Plugin-übergreifende Bereinigungsfehler