> 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/forge-fabric-mod-installieren.md).

# Forge / Fabric Mod installieren

In diesem Artikel erklären wir dir, wie du Mods auf deinem Minecraft Server installierst.

Bei INSTANTROOT kannst du viele Mods direkt über den **One-Click Mod Installer** im INSTANTPANEL installieren. Dadurch musst du Mod-Dateien in vielen Fällen nicht manuell hochladen.

### Was sind Mods?

Mods erweitern Minecraft um neue Funktionen, Blöcke, Items, Kreaturen, Biome, Techniksysteme oder Spielmechaniken.

Beispiele für Mods sind:

* neue Maschinen
* neue Dimensionen
* neue Mobs
* neue Waffen oder Werkzeuge
* Performance-Verbesserungen
* neue Weltgeneration
* zusätzliche Komfortfunktionen

Mods unterscheiden sich von Plugins. Plugins werden meistens auf Paper, Spigot oder Bukkit verwendet. Mods benötigen dagegen einen Modloader wie Forge oder Fabric.

### Forge und Fabric kurz erklärt

Forge und Fabric sind sogenannte Modloader.

Ein Modloader sorgt dafür, dass Minecraft Mods laden und ausführen kann.

| Modloader | Beschreibung                                                                                          |
| --------- | ----------------------------------------------------------------------------------------------------- |
| Forge     | Sehr verbreiteter Modloader mit vielen großen Modpacks und umfangreichen Mods                         |
| Fabric    | Leichter Modloader, häufig für moderne Versionen, Performance-Mods und kleinere Erweiterungen genutzt |

Ein Forge-Mod funktioniert normalerweise nicht auf Fabric.

Ein Fabric-Mod funktioniert normalerweise nicht auf Forge.

Achte deshalb immer darauf, dass Modloader, Minecraft-Version und Mod-Version zusammenpassen.

### Voraussetzungen

Bevor du eine Mod installierst, prüfe:

* dein Server ist im INSTANTPANEL erreichbar
* du weißt, ob dein Server Forge oder Fabric nutzt
* die Minecraft-Version des Servers ist bekannt
* die Mod ist mit deiner Minecraft-Version kompatibel
* die Mod ist für den richtigen Modloader gedacht
* du hast vor Änderungen ein Backup erstellt

**Wichtig:** Installiere Mods nicht blind auf einem laufenden Server. Stoppe den Server vorher und erstelle ein Backup.

### Backup erstellen

Erstelle vor der Installation einer Mod immer ein Backup.

So kannst du den vorherigen Zustand wiederherstellen, falls der Server nach der Installation nicht mehr startet oder die Mod Probleme verursacht.

1. Öffne deinen Minecraft Server im INSTANTPANEL.
2. Gehe zum Bereich **Backups**.
3. Erstelle ein neues Backup.
4. Warte, bis das Backup vollständig abgeschlossen ist.
5. Stoppe danach den Server.

### Mod über den One-Click Mod Installer installieren

Der einfachste Weg ist die Installation über den One-Click Mod Installer.

1. Öffne das INSTANTPANEL.
2. Wähle deinen Minecraft Server aus.
3. Stoppe den Server.
4. Öffne den Bereich **Mod Installer** oder **One-Click Mod Installer**.
5. Suche die gewünschte Mod.
6. Prüfe die angezeigte Minecraft-Version.
7. Prüfe den Modloader, also Forge oder Fabric.
8. Wähle die passende Version aus.
9. Starte die Installation.
10. Warte, bis die Installation abgeschlossen ist.
11. Starte den Server erneut.

Nach dem Start lädt der Server die installierte Mod. Je nach Mod kann der erste Start etwas länger dauern.

### Passende Version auswählen

Die häufigste Ursache für Probleme ist eine falsche Version.

Diese drei Angaben müssen zusammenpassen:

| Angabe            | Beispiel                   |
| ----------------- | -------------------------- |
| Minecraft-Version | `1.20.1`                   |
| Modloader         | `Forge`                    |
| Mod-Version       | Version für `Forge 1.20.1` |

Wenn dein Server auf Minecraft `1.20.1` mit Forge läuft, brauchst du auch eine Mod für Forge und Minecraft `1.20.1`.

Eine Fabric-Mod für Minecraft `1.20.1` funktioniert nicht auf einem Forge-Server.

Eine Forge-Mod für Minecraft `1.19.2` funktioniert normalerweise nicht auf einem Forge-Server mit Minecraft `1.20.1`.

### Modloader vor der Installation prüfen

Prüfe vor der Installation, ob dein Server Forge oder Fabric nutzt.

Du findest diese Information in der Regel in der Serverübersicht, bei der Software-Auswahl oder im Startlog.

Typische Hinweise:

| Hinweis                 | Bedeutung                                                 |
| ----------------------- | --------------------------------------------------------- |
| Forge                   | Server nutzt Forge                                        |
| Fabric                  | Server nutzt Fabric                                       |
| Vanilla                 | Keine Mods möglich                                        |
| Paper / Spigot / Bukkit | Plugins möglich, aber keine klassischen Forge/Fabric-Mods |

Wenn dein Server noch auf Vanilla läuft, musst du zuerst auf Forge oder Fabric wechseln, bevor du Mods verwenden kannst.

### Client-Mods und Server-Mods

Nicht jede Mod muss auf dem Server installiert werden.

Es gibt drei Arten von Mods:

| Art                    | Bedeutung                                                     |
| ---------------------- | ------------------------------------------------------------- |
| Server-Mod             | Muss auf dem Server installiert werden                        |
| Client-Mod             | Muss nur beim Spieler installiert werden                      |
| Client- und Server-Mod | Muss auf dem Server und bei allen Spielern installiert werden |

Viele Gameplay-Mods müssen sowohl auf dem Server als auch auf dem Client installiert sein.

Beispiele:

* neue Blöcke
* neue Items
* neue Mobs
* neue Dimensionen
* neue Maschinen

Reine Client-Mods wie Minimap-Mods oder Grafik-Mods werden normalerweise nicht auf dem Server installiert.

### Spieler müssen die gleiche Mod verwenden

Wenn eine Mod auch auf dem Client benötigt wird, müssen alle Spieler diese Mod ebenfalls installieren.

Dabei müssen Version und Modloader passen.

Beispiel:

Der Server nutzt:

* Minecraft `1.20.1`
* Forge
* Mod `BeispielMod` für Forge `1.20.1`

Dann müssen Spieler ebenfalls verwenden:

* Minecraft `1.20.1`
* Forge
* dieselbe oder kompatible Version der Mod

Wenn ein Spieler eine benötigte Mod nicht installiert hat, kann die Verbindung fehlschlagen.

Typische Fehlermeldungen sind:

* `Mod rejected`
* `Missing mods`
* `Mismatched mod list`
* `Incompatible mod set`
* `Connection closed`

### Mod manuell installieren

Wenn eine Mod nicht im One-Click Mod Installer verfügbar ist, kannst du sie manuell installieren.

1. Lade die Mod von einer vertrauenswürdigen Quelle herunter.
2. Prüfe Minecraft-Version und Modloader.
3. Stoppe deinen Server im INSTANTPANEL.
4. Öffne den Dateimanager oder verbinde dich per SFTP.
5. Öffne den Ordner `mods`.
6. Lade die `.jar`-Datei der Mod in den Ordner `mods` hoch.
7. Starte den Server erneut.

Falls der Ordner `mods` nicht vorhanden ist, läuft dein Server wahrscheinlich nicht auf Forge oder Fabric.

### Mod entfernen

Wenn du eine Mod entfernen möchtest:

1. Stoppe den Server.
2. Öffne den One-Click Mod Installer oder den Dateimanager.
3. Entferne die Mod.
4. Prüfe den Ordner `mods`, falls die Mod manuell installiert wurde.
5. Starte den Server erneut.

**Wichtig:** Entferne Mods nicht unüberlegt aus bestehenden Welten. Wenn die Mod Blöcke, Items oder Dimensionen hinzugefügt hat, können beim Entfernen Daten fehlen oder beschädigt werden.

### Mod aktualisieren

Um eine Mod zu aktualisieren:

1. Erstelle ein Backup.
2. Stoppe den Server.
3. Entferne die alte Mod-Version.
4. Installiere die neue passende Mod-Version.
5. Starte den Server.
6. Prüfe die Konsole und die Logs.

Aktualisiere nicht mehrere Mods gleichzeitig, wenn du Probleme vermeiden möchtest. Installiere Änderungen besser Schritt für Schritt.

### Abhängigkeiten beachten

Manche Mods benötigen zusätzliche Bibliotheken oder weitere Mods.

Diese werden oft als Dependencies oder Required Mods bezeichnet.

Beispiele:

* Library-Mods
* API-Mods
* Core-Mods
* Fabric API

Wenn eine benötigte Abhängigkeit fehlt, startet der Server möglicherweise nicht.

Typische Hinweise im Log sind:

* `Missing dependency`
* `Requires`
* `Mod requires`
* `Dependency not found`

Installiere in diesem Fall die fehlende Abhängigkeit in der passenden Version.

### Fabric API

Viele Fabric-Mods benötigen die Fabric API.

Wenn du Fabric verwendest und eine Mod nicht startet, prüfe, ob die Fabric API benötigt wird.

Die Fabric API muss dann ebenfalls in den Ordner `mods` installiert werden oder über den One-Click Mod Installer hinzugefügt werden, falls verfügbar.

### Häufige Probleme

#### Server startet nach Mod-Installation nicht

Prüfe:

* passt die Mod zur Minecraft-Version?
* passt die Mod zu Forge oder Fabric?
* fehlen Abhängigkeiten?
* wurde eine Client-only Mod auf dem Server installiert?
* ist die Mod-Datei vollständig hochgeladen?
* gibt es eine Fehlermeldung im Log?

Wenn der Server nicht startet, entferne zuletzt installierte Mods oder stelle dein Backup wieder her.

#### Spieler können nicht verbinden

Mögliche Ursachen:

* Spieler haben die Mod nicht installiert
* Spieler nutzen eine andere Mod-Version
* Spieler nutzen den falschen Modloader
* Spieler verwenden eine andere Minecraft-Version
* Server und Client haben unterschiedliche Modlisten

Vergleiche die Modliste des Servers mit der Modliste des Spielers.

#### Missing mods

Diese Meldung bedeutet, dass dem Client oder Server eine benötigte Mod fehlt.

Lösung:

* fehlende Mod installieren
* richtige Version verwenden
* Modloader prüfen
* Server und Client vergleichen

#### Incompatible mod set

Diese Meldung bedeutet, dass eine oder mehrere Mods nicht zusammenpassen.

Mögliche Ursachen:

* falsche Minecraft-Version
* falscher Modloader
* inkompatible Mod-Version
* fehlende Abhängigkeit
* Mod ist nicht für Server geeignet

#### Server crasht direkt beim Start

Öffne die Konsole oder die Logs im INSTANTPANEL.

Suche nach Begriffen wie:

* `Error`
* `Exception`
* `Caused by`
* `Missing`
* `Incompatible`
* `Failed to load`

Die wichtigste Stelle im Log steht meistens am Ende oder direkt nach `Caused by`.

#### Ordner `mods` fehlt

Wenn der Ordner `mods` fehlt, läuft dein Server wahrscheinlich nicht auf Forge oder Fabric.

Wechsle zuerst die Server-Software auf Forge oder Fabric und starte den Server einmal. Danach wird der Ordner normalerweise automatisch erstellt.

### Empfehlungen

* Installiere nur Mods aus vertrauenswürdigen Quellen.
* Erstelle vor jeder Änderung ein Backup.
* Installiere Mods einzeln und teste nach jeder Änderung.
* Achte immer auf Minecraft-Version, Modloader und Mod-Version.
* Entferne Mods aus bestehenden Welten nur mit Vorsicht.
* Lies bei Problemen immer die Logs.
* Verwende für Modpacks möglichst die offiziellen Serverfiles.

### Support kontaktieren

Wenn du eine Mod nicht installieren kannst oder der Server nach der Installation nicht startet, kontaktiere den Support.

Gib bitte folgende Informationen an:

* Minecraft-Version
* Modloader: Forge oder Fabric
* Name der Mod
* Mod-Version
* ob die Mod über den One-Click Mod Installer oder manuell installiert wurde
* genaue Fehlermeldung
* letzter Abschnitt aus dem Serverlog
* was du bereits versucht hast

Sende keine Passwörter, Tokens oder privaten Zugangsdaten.
