Mods und Modpacks auf einem Minecraft-Server (Fabric, Forge, NeoForge)

Mods verändern das Spiel selbst: Sie fügen Blöcke, Gegenstände, Mobs, Dimensionen oder ganze Spielsysteme hinzu. Anders als bei Plugins brauchen sie meist auch die Spieler. Diese Anleitung zeigt, wie Sie Mods auf dem Server installieren, ein fertiges Modpack zum Laufen bringen und die häufigsten Fehler beheben.

So funktionieren Mods#

Mods lädt ein Loader ins Spiel: Fabric, Forge oder NeoForge. Jeder Mod ist für einen bestimmten Loader und eine bestimmte Minecraft-Version geschrieben. Ein Fabric-Mod funktioniert nicht auf NeoForge, und ein Mod für 1.21.1 funktioniert meist nicht auf 26.1. Manche Mods veröffentlichen eigene Dateien für mehrere Loader; laden Sie also immer die Datei für Ihren Loader und Ihre Version herunter.

Je nachdem, wo ein Mod läuft, gibt es drei Arten:

Die meisten Fabric-Mods brauchen die Bibliothek Fabric API. Das ist ein eigener Mod, der sowohl auf dem Server als auch bei den Spielern in den Ordner mods gehört. Ebenso brauchen viele Mods weitere Bibliotheken. Die Seite eines Mods führt sie immer als Abhängigkeiten (Dependencies) auf.

Einen Mod über die Registerkarte Mods installieren#

1. Öffnen Sie Meine Dienste, klicken Sie auf Ihren Server und wechseln Sie in die Registerkarte Mods.
2. Klicken Sie auf Durchsuchen. Der Katalog nutzt Modrinth und zeigt nur Mods für Ihren Loader und Ihre Minecraft-Version.
3. Geben Sie in das Feld „Mods suchen“ einen Namen ein und klicken Sie auf Suchen.
4. Klicken Sie beim Mod auf Installieren.
5. Prüfen Sie im Dialog den Abschnitt Erforderliche Abhängigkeiten. Der Kundenbereich installiert sie mit dem Mod, zum Beispiel Fabric API. Wählen Sie nur die ab, die Sie bereits selbst hochgeladen haben.
6. Klicken Sie auf Installieren und danach auf Neu starten. Mods werden nur beim Start des Servers geladen.

Aktualisieren, Deaktivieren und Entfernen von Mods funktioniert genauso wie bei Plugins, siehe Plugins installieren.

Einen Mod von Hand installieren#

1. Laden Sie den Mod von seiner Seite auf Modrinth oder CurseForge herunter. Prüfen Sie, ob die Datei für Ihren Loader und Ihre Minecraft-Version ist (beides sehen Sie in der Registerkarte Software unter Installierte Software).
2. Laden Sie auch alle Abhängigkeiten herunter, die die Seite des Mods als erforderlich (Required) aufführt.
3. Öffnen Sie in der Registerkarte Dateien den Ordner mods. Existiert er nicht, starten Sie den Server einmal ohne Mods oder legen Sie ihn mit der Schaltfläche Neuer Ordner an.
4. Klicken Sie auf Hochladen und wählen Sie die .jar-Dateien. Sie können mehrere auf einmal auswählen. Eine einzelne Datei darf höchstens 100 MB groß sein.
5. Starten Sie den Server neu.

Von Hand hochgeladene Mods erscheinen in der Registerkarte Mods mit der Kennzeichnung Manuell hochgeladen, und der Kundenbereich verfolgt für sie keine Updates.

Was die Spieler brauchen#

Um sich mit einem Server mit Mods zu verbinden, braucht ein Spieler:

• dieselbe Minecraft-Version wie der Server,
• denselben Loader, idealerweise in derselben Version wie der Server,
• alle Inhalts-Mods vom Server in denselben Versionen (nicht die serverseitigen Mods; Client-Mods entscheidet jeder Spieler selbst).

Am einfachsten geben Sie den Spielern das ganze Modpack. Läuft auf dem Server ein öffentliches Modpack, installieren die Spieler einfach dieselbe Version des Modpacks in der CurseForge-App, der Modrinth App oder in Prism Launcher. Für eigene Mod-Zusammenstellungen erstellen Sie eine Liste der Mods mit Versionen oder bauen in einer dieser Apps ein eigenes Modpack und teilen es.

Modpacks#

Ein Modpack ist eine fertige Zusammenstellung von Mods mit Konfiguration. Auf den Server bringen Sie es, indem Sie den richtigen Loader einrichten und dann die Mods und die Konfiguration hochladen. Eine Installation von Modpacks mit einem Klick gibt es im Kundenbereich noch nicht; das Vorgehen unten funktioniert für Modpacks von CurseForge und Modrinth.

Wie viel RAM ein Modpack braucht#

Der verlässlichste Richtwert ist die Empfehlung des Modpack-Autors auf seiner Seite. Gibt es keine, nutzen Sie die grobe Tabelle unten. Planen Sie eine Reserve für die Spielerzahl und die Größe der Welt ein.

Stürzt der Server wegen Speichermangels ab, wechseln Sie in der Registerkarte Tarif ändern zu einem größeren Tarif.

Schritt 1: Minecraft- und Loader-Version herausfinden#

Sie brauchen drei Angaben: die Minecraft-Version, den Loader und die Loader-Version. Sie finden sie:

• Modrinth: auf der Seite des Modpacks bei der jeweiligen Version (Versions). In der Datei .mrpack stehen sie in modrinth.index.json im Abschnitt dependencies (Schlüssel minecraft, fabric-loader, forge oder neoforge).
• CurseForge: auf der Seite des Modpacks in der Registerkarte Files bei der jeweiligen Datei oder in der Anleitung des Autors. Das Server Pack enthält oft einen Loader-Installer, dessen Name die Version verrät.

Schritt 2: Den Server vorbereiten#

1. Stoppen Sie den Server in der Registerkarte Konsole mit der Schaltfläche Stopp. Nach einem Softwarewechsel startet der Kundenbereich den Server nur, wenn er vor dem Wechsel lief. Ein gestoppter Server generiert also keine neue Welt ohne die Mods (in einer solchen Welt würden in der Nähe des Spawns die Erze, Biome und Strukturen aus den Mods fehlen).
2. Wählen Sie in der Registerkarte Software den Servertyp, der dem Loader des Modpacks entspricht.
3. Wählen Sie die Minecraft-Version und im Feld Loader-Version dieselbe Version, die das Modpack verwendet.
4. Wählen Sie unter Serverdateien die Option Alles löschen und kreuzen Sie Ich stimme der Minecraft EULA zu an.
5. Klicken Sie auf Software wechseln, bestätigen Sie durch Ziehen des Schiebereglers und warten Sie, bis der Fortschritt Fertig anzeigt. Der Server bleibt gestoppt.

Schritt 3: Die Serverdateien des Modpacks besorgen#

CurseForge: Die Autoren stellen die Serverdateien als Server Pack bereit. Das ist eine eigene Datei, die einer Version des Modpacks als zusätzliche Datei (Additional Files) beiliegt. Laden Sie das Server Pack derselben Version herunter, die Ihre Spieler haben werden, und entpacken Sie es auf Ihrem Computer. Nicht jedes Modpack hat ein Server Pack. Fehlt es, verwenden Sie die App wie bei Modrinth beschrieben.

Modrinth: Eine Datei .mrpack ist ein ZIP, das keine Mods enthält, sondern nur Links darauf und die Konfiguration. Die Serverdateien erhalten Sie auf eine dieser Arten:

• Mit der Modrinth App (einfacher): Installieren Sie das Modpack in der App, öffnen Sie den Ordner der Instanz und nehmen Sie daraus die Ordner mods und config sowie die übrigen Ordner des Modpacks. Entfernen Sie aus dem Ordner mods reine Client-Mods (auf Modrinth ist ihre Umgebung als Client only angegeben).

• Für Fortgeschrittene mit mrpack-install: Modrinth nennt dieses Kommandozeilenwerkzeug als eine der Möglichkeiten, ein Modpack auf einem Server bereitzustellen. Laden Sie es für Ihr System von der Seite Releases des Repositorys mrpack-install (öffnet sich in einem neuen Fenster) herunter und führen Sie im Ordner des Programms aus:

  mrpack-install <FILE>.mrpack --server-dir server-modpack

  • mrpack-install – ein Programm, das die Serverdateien des Modpacks gemäß seiner Liste (modrinth.index.json) herunterlädt. Die heruntergeladene Datei hat das System im Namen, zum Beispiel mrpack-install-windows.exe oder mrpack-install-linux. Unter Windows starten Sie sie in PowerShell als .\mrpack-install-windows.exe; unter Linux und macOS machen Sie sie zuerst mit chmod +x mrpack-install-linux ausführbar und starten sie als ./mrpack-install-linux.
  • <FILE>.mrpack – der Pfad zum heruntergeladenen Modpack, zum Beispiel Downloads/muj-pack.mrpack.
  • --server-dir server-modpack – der Ordner, in den die Dateien heruntergeladen werden. Er wird automatisch angelegt.

  Neben Mods und Konfiguration lädt das Programm auch den Server selbst mit Loader herunter. Den laden Sie nicht auf unseren Server hoch; den Loader installiert die Registerkarte Software (Schritt 2).

Schritt 4: Die Dateien auf den Server hochladen#

Laden Sie nur diese Teile hoch (sofern das Modpack sie hat):

• den Ordner mods mit allen .jar-Dateien,
• den Ordner config,
• weitere Ordner des Modpacks, zum Beispiel defaultconfigs, kubejs oder resourcepacks, wenn der Autor sie als Teil des Servers angibt.

In der Registerkarte Dateien:

1. Legen Sie mit der Schaltfläche Neuer Ordner im Hauptverzeichnis des Servers einen Ordner mit demselben Namen an, zum Beispiel mods.
2. Öffnen Sie ihn, klicken Sie auf Hochladen und wählen Sie alle Dateien aus dem entsprechenden Ordner auf Ihrem Computer. Sie können mehrere Dateien auf einmal auswählen.
3. Machen Sie dasselbe für Unterordner (zum Beispiel config und die Ordner darin).

Laden Sie nicht die Server-.jar des Modpacks, den Ordner libraries, Installer oder Startskripte (run.sh, run.bat, start.sh, user_jvm_args.txt) hoch. Den Loader hat der Kundenbereich in Schritt 2 installiert. Die Datei user_jvm_args.txt wird bei unserem Hosting nicht verwendet: Speicher und Startparameter stellt die Registerkarte Startoptionen anhand der Tarifgröße und der Anzahl der Mods ein (Startparameter und Speicher).

Laden Sie auch nicht die server.properties des Modpacks hoch. Der Server legt die Datei selbst mit der Adresse und dem Port an, die wir ihm zugeteilt haben. Verlangt der Autor des Modpacks eigene Werte (zum Beispiel den Welttyp bei Skyblock-Modpacks), stellen Sie sie vor dem ersten Start ein: Klicken Sie in der Registerkarte Servereigenschaften auf Aus Standardwerten anlegen, ändern Sie die benötigten Optionen und speichern Sie. Der Welttyp wird nur beim Anlegen einer neuen Welt verwendet; nach dem ersten Start hätte er keine Wirkung mehr. Einen eigenen Welttyp aus einem Mod lehnt das Formular als unbekannten Wert ab. Schreiben Sie diesen Wert direkt in die Datei server.properties in der Registerkarte Dateien (Bearbeiten, speichern mit Strg+S).

Schritt 5: Den Server starten und sich verbinden#

1. Klicken Sie in der Registerkarte Konsole auf Start. Der erste Start eines großen Modpacks dauert einige Minuten.
2. Warten Sie auf die Zeile Done (…)! For help, type "help".
3. Verbinden Sie sich aus dem Spiel mit demselben Modpack in derselben Version.

Konfiguration von Mods#

Bearbeiten Sie die Einstellungen in der Registerkarte Dateien bei gestopptem Server und starten Sie den Server danach. .toml-Dateien verwenden die Form schlüssel = wert; .json-Dateien müssen gültige JSON-Syntax haben (Kommas zwischen Einträgen, Anführungszeichen um Text).

Überprüfung#

1. Warten Sie in der Registerkarte Konsole, bis der Server die Zeile Done (…)! For help, type "help" erreicht. Endet er stattdessen mit einem Fehler, machen Sie mit dem Abschnitt Fehlerbehebung weiter.
2. Prüfen Sie in der Registerkarte Mods auf der Unterregisterkarte Installiert, ob der Mod aktiviert ist. Von Hand hochgeladene Mods haben die Kennzeichnung Manuell hochgeladen.
3. Verbinden Sie sich aus dem Spiel mit einem Client, der denselben Loader, dieselbe Minecraft-Version und dieselben Mods hat. Der Server darf Sie nicht mit einer Liste von Mods trennen.
4. Prüfen Sie im Spiel, ob der Inhalt des Mods funktioniert (zum Beispiel, ob Sie einen neuen Block oder Gegenstand im Kreativinventar finden).

Fehlerbehebung#

Suchen Sie Fehler in der Konsole und in der Datei logs/latest.log. Stürzt der Server ab, entsteht ein Bericht im Ordner crash-reports. Am wichtigsten darin sind die Zeile Description: und die erste Zeile, die mit Caused by: beginnt.

Spieler werden beim Verbinden mit einer Liste von Mods getrennt#

Der Spieler hat nicht dieselben Mods wie der Server (ein Mod fehlt, er hat eine andere Version oder einen zusätzlichen Inhalts-Mod, den der Server nicht hat). Die Meldung nennt meist die konkreten Mods. Gleichen Sie die Versionen an, am besten, indem die Spieler dieselbe Version des Modpacks verwenden.

Mod resolution encountered an incompatible mod set! (Fabric)#

Fabric hat beim Start festgestellt, dass die Mods nicht zusammenpassen. Unter der Meldung steht eine Liste: eine fehlende Abhängigkeit (zum Beispiel Fabric API), eine zu alte Loader-Version oder ein Mod für eine andere Minecraft-Version. Ergänzen oder ersetzen Sie die aufgeführten Mods. Braucht ein Mod einen neueren Fabric-Loader, wählen Sie ihn in der Registerkarte Software im Feld Loader-Version.

Attempted to load class … for invalid dist DEDICATED_SERVER (Forge, NeoForge) oder Cannot load class … in environment type SERVER (Fabric)#

Auf dem Server liegt ein Client-Mod. Sein Name steht meist in der Ausgabe über der Meldung. Entfernen Sie ihn aus dem Ordner mods.

UnsupportedClassVersionError#

Der Mod braucht ein neueres Java, ist also für eine neuere Minecraft-Version gemacht, als der Server verwendet. Laden Sie die Version des Mods für Ihre Minecraft-Version herunter.

Der Server stürzt mit OutOfMemoryError ab oder beendet sich ohne Fehler#

Der Server hat nicht genug Speicher. Beendet er sich ohne Fehler und zeigt die Konsole Out of memory: true, hat er das Speicherlimit des Tarifs überschritten. Prüfen Sie in der Registerkarte Startoptionen die Warnungen neben den Startparametern und klicken Sie bei Bedarf auf Empfohlene verwenden. Es hilft auch, schwere Mods zu entfernen, die Sichtweite zu senken oder zu einem größeren Tarif zu wechseln. Details stehen im Artikel Leistung und Optimierung.

Nach dem Wechsel von Paper laden die Mods nicht#

Prüfen Sie in der Registerkarte Software, ob der Servertyp Fabric, Forge oder NeoForge ist. Mods müssen im Ordner mods liegen, nicht in plugins.

Die Datei ist größer als 100 MB#

Die Datei lässt sich nicht über den Kundenbereich hochladen. Wenden Sie sich für einen SFTP-Zugang an den Support.

Weitere Meldungen beschreibt der Artikel Häufige Fehler auf Minecraft-Servern. Kommen Sie nicht weiter, senden Sie uns die Datei aus crash-reports oder logs/latest.log.

Weiterführende Links#

• Fabric: Mods installieren (öffnet sich in einem neuen Fenster)
• NeoForge: Server (öffnet sich in einem neuen Fenster)
• Modrinth: Modpacks auf einem Server (öffnet sich in einem neuen Fenster)
• Modrinth: das Format .mrpack (öffnet sich in einem neuen Fenster)
• mrpack-install (öffnet sich in einem neuen Fenster)