> For the complete documentation index, see [llms.txt](https://docs.instantroot.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.instantroot.de/gameserver/minecraft/modpack-installieren.md). # Modpack installieren In diesem Artikel erklären wir dir, wie du ein Modpack auf deinem Minecraft Server installierst. Bei INSTANTROOT kannst du viele Modpacks direkt über den One-Click Mod Installer im INSTANTPANEL installieren. Dadurch musst du die Serverdateien nicht manuell hochladen und sparst dir viele einzelne Einrichtungsschritte. ### Was ist ein Modpack? Ein Modpack ist eine Sammlung aus mehreren Minecraft Mods, Konfigurationen und oft auch zusätzlichen Dateien. Mods erweitern Minecraft um neue Inhalte oder Funktionen. Ein Modpack bündelt viele dieser Mods zu einem fertigen Spielerlebnis. Ein Modpack kann zum Beispiel enthalten: * neue Blöcke * neue Items * neue Biome * Techniksysteme * Magiesysteme * neue Mobs * neue Dimensionen * Performance-Mods * eigene Konfigurationen * angepasste Rezepte Bekannte Modpacks sind zum Beispiel Modpacks von CurseForge, Modrinth oder anderen Plattformen. ### Wichtig vor der Installation Ein Modpack verändert deinen Server oft sehr stark. Bestehende Welten, Einstellungen oder Dateien können dadurch überschrieben werden. Erstelle deshalb vor der Installation ein Backup, wenn du deinen aktuellen Serverstand behalten möchtest. **Wichtig:** Installiere ein Modpack möglichst nur auf einem frisch eingerichteten Server oder nachdem du ein Backup erstellt hast. ### Voraussetzungen Bevor du ein Modpack installierst, solltest du prüfen: * der Minecraft Server ist im INSTANTPANEL sichtbar * du hast Zugriff auf das INSTANTPANEL * der Server ist gestoppt * du weißt, welches Modpack du installieren möchtest * du hast vorher ein Backup erstellt, falls bereits Daten vorhanden sind ### Modpack über den One-Click Mod Installer installieren Der einfachste Weg ist die Installation über den One-Click Mod Installer im INSTANTPANEL. Gehe dazu so vor: 1. Öffne das INSTANTPANEL. 2. Melde dich mit deiner E-Mail-Adresse und deinem Passwort an. 3. Wähle deinen Minecraft Server aus. 4. Stoppe den Server. 5. Öffne den Bereich für den One-Click Mod Installer. 6. Suche das gewünschte Modpack. 7. Wähle das Modpack aus. 8. Prüfe die angezeigte Version. 9. Starte die Installation. 10. Warte, bis die Installation vollständig abgeschlossen ist. 11. Starte den Server wieder. Je nach Größe des Modpacks kann die Installation einige Minuten dauern. Während der Installation solltest du den Server nicht starten, neu installieren oder Dateien löschen. ### Nach der Installation Nach der Installation startet der Server mit dem ausgewählten Modpack. Beim ersten Start kann der Server länger brauchen als gewohnt. Das ist normal, weil viele Modpacks zusätzliche Dateien erstellen, Konfigurationen vorbereiten und eine neue Welt generieren. Warte deshalb nach dem Start einige Minuten und prüfe die Konsole im INSTANTPANEL. ### Passenden Client installieren Damit du dich mit einem Modpack-Server verbinden kannst, brauchst du das gleiche Modpack auch auf deinem eigenen Minecraft Client. Es reicht nicht, nur den Server zu installieren. Du musst auf deinem PC denselben Modpack-Client verwenden, der zur Serverversion passt. Das bedeutet: * gleiche Minecraft-Version * gleicher Modloader * gleiche Modpack-Version * gleiche Mods * passende Konfigurationen, falls erforderlich Wenn der Server zum Beispiel ein Forge-Modpack nutzt, brauchst du auf deinem PC ebenfalls die passende Forge-Version mit dem gleichen Modpack. ### CurseForge oder Modrinth Launcher verwenden Viele Modpacks lassen sich bequem über einen Launcher installieren. Häufig genutzt werden zum Beispiel: * CurseForge Launcher * Modrinth App * Prism Launcher * ATLauncher * Technic Launcher, falls das Modpack dort angeboten wird Wähle dort das gleiche Modpack und möglichst exakt die gleiche Version aus, die auch auf dem Server installiert wurde. ### Modpack-Version beachten Die Modpack-Version ist sehr wichtig. Wenn dein Client eine andere Version nutzt als der Server, kann die Verbindung fehlschlagen. Typische Fehlermeldungen sind: * `Mod list is not compatible` * `Mismatched mod channel list` * `Failed to synchronize registry data` * `Incompatible FML modded server` * `This server has mods that require Forge` * `Connection closed` Prüfe in diesem Fall, ob Server und Client wirklich dieselbe Modpack-Version verwenden. ### Forge, Fabric und andere Modloader Modpacks benötigen meistens einen Modloader. Ein Modloader ist die technische Grundlage, damit Mods überhaupt geladen werden können. Häufige Modloader sind: | Modloader | Verwendung | | --------- | ------------------------------------------- | | Forge | sehr verbreitet für große Modpacks | | Fabric | häufig für moderne und performante Modpacks | | Quilt | ähnlich zu Fabric, je nach Modpack | | NeoForge | neuerer Forge-Zweig bei manchen Modpacks | Der Modloader muss zur Modpack-Version passen. Ein Forge-Modpack funktioniert nicht einfach mit Fabric. Ein Fabric-Modpack funktioniert nicht einfach mit Forge. ### Server startet nach der Installation nicht Wenn der Server nach der Modpack-Installation nicht startet, prüfe zuerst die Konsole und die Logs im INSTANTPANEL. Häufige Ursachen sind: * falsche Modpack-Version * unvollständige Installation * Modpack benötigt mehr Arbeitsspeicher * Modpack ist nicht für Server geeignet * eine Mod fehlt * eine Mod ist nur für den Client gedacht * falsche Java-Version * bestehende Welt ist nicht mit dem Modpack kompatibel ### Modpack benötigt mehr Arbeitsspeicher Viele Modpacks benötigen deutlich mehr Arbeitsspeicher als ein normaler Vanilla-Server. Kleine Modpacks können mit weniger RAM laufen. Große Technik- oder Abenteuer-Modpacks benötigen oft deutlich mehr. Wenn dein Server beim Start abstürzt oder sehr langsam reagiert, kann zu wenig Arbeitsspeicher eine Ursache sein. Typische Anzeichen sind: * Server startet sehr langsam * Server stürzt beim Start ab * Spieler werden getrennt * starke Lags * `OutOfMemoryError` * `Java heap space` In diesem Fall solltest du prüfen, ob dein gebuchtes Paket genug Ressourcen für das Modpack hat. ### Bestehende Welt mit Modpack verwenden Eine bestehende Vanilla-Welt kann mit einem Modpack funktionieren, muss aber nicht. Modpacks verändern oft: * Weltgenerierung * Biome * Blöcke * Items * Dimensionen * Strukturen * Rezepte Wenn du eine alte Welt mit einem neuen Modpack nutzt, können fehlende Blöcke, beschädigte Chunks oder Fehler beim Start auftreten. **Empfehlung:** Erstelle für ein neues Modpack am besten eine neue Welt. ### Welt nach Modpack-Installation neu generieren Wenn du eine neue Welt für das Modpack erstellen möchtest, kannst du den alten Weltordner entfernen oder umbenennen. Vorher solltest du ein Backup erstellen. Danach startet der Server beim nächsten Start mit einer neuen Welt. Der Name des Weltordners hängt von deiner Serverkonfiguration ab. Häufig heißt der Ordner `world`. ### Modpack wechseln Wenn du ein anderes Modpack installieren möchtest, solltest du vorher prüfen, ob du die bestehende Welt behalten möchtest. Ein Wechsel zwischen Modpacks kann problematisch sein, weil Mods, Blöcke und Items unterschiedlich sind. Empfohlenes Vorgehen: 1. Server stoppen. 2. Backup erstellen. 3. Bestehende Welt sichern oder entfernen. 4. Neues Modpack über den One-Click Mod Installer installieren. 5. Server starten. 6. Konsole prüfen. 7. Mit passendem Client verbinden. ### Modpack deinstallieren Ein Modpack lässt sich nicht immer sauber durch das Löschen einzelner Mods entfernen. Wenn du zurück zu Vanilla, Paper oder einer anderen Serverart wechseln möchtest, ist meist eine Neuinstallation oder ein sauberer Wechsel der Server-Software sinnvoll. Vorher solltest du ein Backup erstellen. ### Häufige Probleme #### Ich kann nicht auf den Server verbinden Prüfe: * ist der Server gestartet? * nutzt dein Client das gleiche Modpack? * nutzt dein Client die gleiche Modpack-Version? * nutzt dein Client den richtigen Modloader? * verwendest du die richtige Minecraft-Version? * ist die Serveradresse korrekt? #### Fehlermeldung: Mod list is not compatible Diese Meldung bedeutet, dass Client und Server nicht dieselben Mods oder Versionen verwenden. Lösung: * installiere das gleiche Modpack wie auf dem Server * verwende die gleiche Modpack-Version * entferne zusätzliche Mods, die nicht zum Server passen * aktualisiere Server und Client nicht unabhängig voneinander #### Fehlermeldung: Failed to synchronize registry data Diese Meldung tritt häufig auf, wenn Mods, Items oder Blöcke zwischen Client und Server nicht übereinstimmen. Lösung: * Client-Modpack-Version prüfen * Server-Modpack-Version prüfen * keine einzelnen Mods manuell austauschen * Modpack neu installieren, falls nötig #### Server crasht direkt beim Start Prüfe die Logs im INSTANTPANEL. Häufige Ursachen: * Modpack benötigt mehr RAM * falsche Java-Version * fehlerhafte Mod * Client-Mod wurde auf den Server geladen * Mod-Abhängigkeit fehlt * Welt ist nicht kompatibel #### Server hängt beim Start Große Modpacks können beim ersten Start länger brauchen. Warte einige Minuten und beobachte die Konsole. Wenn über längere Zeit keine neuen Einträge erscheinen oder der Server automatisch stoppt, prüfe die Logs. #### Spieler haben starke Lags Modpacks können deutlich mehr Leistung benötigen als normale Minecraft Server. Prüfe: * Anzahl der Spieler * Anzahl der geladenen Chunks * große Maschinen oder Farmen * viele Entities * zu hohe View-Distance * zu wenig RAM * Performance-Mods oder Servereinstellungen ### Support kontaktieren Wenn die Installation oder Verbindung nicht funktioniert, kontaktiere den Support. Gib bitte folgende Informationen an: * Name des Modpacks * Modpack-Version * Minecraft-Version * Modloader, zum Beispiel Forge oder Fabric * genaue Fehlermeldung * Screenshot oder Auszug aus der Konsole * ob der Server über den One-Click Mod Installer installiert wurde * ob bereits eine Welt vorhanden war * was du bereits versucht hast **Sicherheit:** Sende niemals Passwörter, private Zugangsdaten oder Tokens an den Support.