> 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/minecraft-version-wechseln.md).

# Minecraft Version wechseln

In diesem Artikel erklären wir dir, wie du die Minecraft Version deines Servers im INSTANTPANEL wechselst.

Das ist zum Beispiel sinnvoll, wenn du eine andere Minecraft-Version nutzen möchtest, von Vanilla auf Paper wechseln willst oder dein Server für bestimmte Plugins, Mods oder Spieler angepasst werden soll.

### Wichtig vor dem Wechsel

Ein Versionswechsel kann Auswirkungen auf deine Welt, Plugins, Mods und Einstellungen haben.

Erstelle deshalb vor jeder Änderung ein Backup.

**Wichtig:** Ein Wechsel auf eine neuere Version ist meistens möglich. Ein Wechsel zurück auf eine ältere Version kann Probleme verursachen, wenn die Welt bereits mit einer neueren Version geladen wurde.

### Was bedeutet Minecraft Version?

Die Minecraft Version bestimmt, mit welcher Spielversion dein Server läuft.

Beispiele:

* `1.20.1`
* `1.20.4`
* `1.21`
* `1.21.1`

Dein Minecraft Client sollte zur Server-Version passen. Wenn dein Server auf `1.21.1` läuft, solltest du dich auch mit dieser Version verbinden.

### Was bedeutet Server-Software?

Neben der Minecraft Version gibt es auch unterschiedliche Server-Software.

Häufige Varianten sind:

| Server-Software | Beschreibung                                                     |
| --------------- | ---------------------------------------------------------------- |
| Vanilla         | Originaler Minecraft Server ohne Plugins und Mods                |
| Paper           | Optimierte Server-Software mit Plugin-Unterstützung              |
| Spigot          | Server-Software mit Plugin-Unterstützung                         |
| Bukkit          | Ältere Plugin-Basis, heute meist durch Spigot oder Paper ersetzt |
| Forge           | Modloader für Forge-Mods und Modpacks                            |
| Fabric          | Modloader für Fabric-Mods und Modpacks                           |

Die Server-Software entscheidet, welche Erweiterungen du nutzen kannst.

Plugins funktionieren zum Beispiel auf Paper oder Spigot, aber nicht auf Vanilla, Forge oder Fabric.

Mods funktionieren mit Forge oder Fabric, aber nicht auf Paper oder Spigot.

### Version im INSTANTPANEL wechseln

Im INSTANTPANEL kannst du die Minecraft Version über den Versionenmanager wechseln.

Der Versionenmanager zeigt dir eine Liste verfügbarer Versionen und Server-Software an. Wenn du eine Version auswählst, wird die passende Serverdatei automatisch gewechselt.

### Schritt-für-Schritt-Anleitung

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 Versionen oder den Versionenmanager.
6. Wähle die gewünschte Minecraft Version aus der Liste.
7. Wähle bei Bedarf die passende Server-Software, zum Beispiel Vanilla, Paper, Forge oder Fabric.
8. Starte die Installation oder den Wechsel.
9. Warte, bis der Vorgang abgeschlossen ist.
10. Starte den Server wieder.
11. Prüfe die Konsole und die Logs auf Fehlermeldungen.

**Wichtig:** Stoppe den Server immer vor dem Versionswechsel. Ein Wechsel während der Server läuft, kann zu Fehlern oder beschädigten Dateien führen.

### Was passiert beim Wechsel?

Beim Wechsel über den Versionenmanager wird die Server-JAR ausgetauscht.

Die Server-JAR ist die Datei, mit der dein Minecraft Server gestartet wird. Sie enthält die eigentliche Server-Software.

Je nach Auswahl wird zum Beispiel gewechselt auf:

* eine andere Vanilla-Version
* eine Paper-Version
* eine Spigot-Version
* eine Forge-Version
* eine Fabric-Version

Deine Welt und Konfigurationsdateien bleiben normalerweise bestehen. Trotzdem solltest du vorher ein Backup erstellen, weil nicht jede Welt, jedes Plugin oder jede Mod mit jeder Version kompatibel ist.

### Von Vanilla auf Paper wechseln

Ein Wechsel von Vanilla auf Paper ist häufig sinnvoll, wenn du Plugins nutzen oder bessere Performance erreichen möchtest.

Vorteile von Paper:

* Plugin-Unterstützung
* bessere Performance als Vanilla
* viele zusätzliche Einstellungsmöglichkeiten
* große Plugin-Auswahl

Nach dem Wechsel auf Paper kannst du Plugins in den Plugin-Ordner hochladen.

Der Ordner heißt normalerweise `plugins`.

### Von Paper oder Spigot zurück auf Vanilla wechseln

Ein Wechsel zurück auf Vanilla ist möglich, kann aber Probleme verursachen.

Paper und Spigot können zusätzliche Dateien und Einstellungen erzeugen. Außerdem können Plugins Daten in der Welt oder in eigenen Ordnern speichern.

Wenn du zurück auf Vanilla wechselst:

* funktionieren Plugins nicht mehr
* der Ordner `plugins` wird nicht mehr genutzt
* pluginbezogene Funktionen können fehlen
* bestimmte Änderungen bleiben eventuell in der Welt gespeichert

Erstelle vorher ein Backup.

### Von einer älteren auf eine neuere Minecraft-Version wechseln

Ein Update auf eine neuere Minecraft-Version ist meistens der normale Weg.

Beispiel:

`1.20.4` auf `1.21.1`

Dabei kann die Welt beim ersten Start angepasst oder konvertiert werden. Das kann etwas dauern.

Nach einem Update solltest du prüfen:

* startet der Server fehlerfrei?
* können Spieler verbinden?
* funktionieren Plugins oder Mods?
* gibt es Fehlermeldungen in der Konsole?
* wurde die Welt korrekt geladen?

### Von einer neueren auf eine ältere Minecraft-Version wechseln

Ein Downgrade ist riskant.

Beispiel:

`1.21.1` zurück auf `1.20.4`

Wenn eine Welt bereits mit einer neueren Version geöffnet wurde, kann sie Daten enthalten, die eine ältere Version nicht versteht. Dadurch können Fehler entstehen.

Mögliche Folgen:

* Welt lädt nicht mehr korrekt
* Blöcke oder Items fehlen
* Chunks sind beschädigt
* Server startet nicht
* Spieler-Daten verursachen Fehler

**Wichtig:** Führe ein Downgrade nur durch, wenn du ein Backup aus der älteren Version hast.

### Forge oder Fabric auswählen

Forge und Fabric werden für Mods und Modpacks verwendet.

Du solltest Forge oder Fabric nur auswählen, wenn du auch Mods verwenden möchtest oder ein Modpack dies voraussetzt.

Achte dabei auf drei Dinge:

* Minecraft Version
* Modloader
* Mod-Version

Diese drei Punkte müssen zusammenpassen.

Beispiel:

Ein Fabric-Mod für Minecraft `1.20.1` funktioniert nicht automatisch auf Forge und nicht automatisch auf Minecraft `1.21.1`.

### Plugins, Mods und Versionen

Nach einem Versionswechsel können Plugins oder Mods nicht mehr funktionieren.

Das ist normal, wenn sie nicht zur neuen Version passen.

Prüfe deshalb nach dem Wechsel:

* sind alle Plugins für die neue Version geeignet?
* sind alle Mods für die neue Version geeignet?
* fehlen Abhängigkeiten?
* gibt es Fehlermeldungen in der Konsole?
* gibt es neue Versionen der Plugins oder Mods?

### Wann sollte ich die Version wechseln?

Ein Versionswechsel ist sinnvoll, wenn:

* du eine neuere Minecraft-Version nutzen möchtest
* Spieler mit einer bestimmten Version verbinden sollen
* ein Plugin eine bestimmte Version benötigt
* ein Modpack eine bestimmte Version benötigt
* du von Vanilla auf Paper wechseln möchtest
* du Performance verbessern möchtest
* du eine alte Version für ein bestimmtes Projekt brauchst

### Wann sollte ich nicht wechseln?

Wechsle die Version nicht ohne Backup, wenn:

* viele Spieler aktiv auf dem Server spielen
* wichtige Weltdaten vorhanden sind
* du viele Plugins oder Mods installiert hast
* du nicht weißt, ob deine Erweiterungen kompatibel sind
* du auf eine ältere Version zurückgehen möchtest

### Häufige Probleme

#### Server startet nach dem Wechsel nicht

Prüfe zuerst die Konsole und die Logs im INSTANTPANEL.

Häufige Ursachen:

* Plugin ist nicht mit der neuen Version kompatibel
* Mod ist nicht mit der neuen Version kompatibel
* falsche Java-Version
* beschädigte Serverdatei
* Welt wurde mit einer anderen Version erstellt
* fehlende Mod-Abhängigkeit

Entferne testweise zuletzt hinzugefügte Plugins oder Mods und starte den Server erneut.

#### Spieler können nicht mehr verbinden

Prüfe:

* nutzen die Spieler die richtige Minecraft-Version?
* wurde die Server-Version wirklich gewechselt?
* ist der Server vollständig gestartet?
* wird eine Fehlermeldung angezeigt?
* ist die Whitelist aktiv?

Typische Meldungen sind:

* `Outdated server`
* `Outdated client`
* `Incompatible version`

#### Plugins laden nicht mehr

Plugins funktionieren nur auf Server-Software mit Plugin-Unterstützung, zum Beispiel Paper oder Spigot.

Prüfe:

* läuft der Server wirklich auf Paper oder Spigot?
* ist das Plugin für die neue Minecraft-Version geeignet?
* fehlt eine Abhängigkeit wie Vault oder ProtocolLib?
* steht ein Fehler in der Konsole?

#### Mods laden nicht mehr

Mods funktionieren nur mit dem passenden Modloader.

Prüfe:

* nutzt du Forge oder Fabric?
* passt die Mod zur Minecraft-Version?
* passt die Mod zum Modloader?
* fehlt eine Library oder Abhängigkeit?
* ist die Mod auch auf dem Client installiert, falls erforderlich?

#### Welt lädt nicht richtig

Wenn die Welt nach einem Versionswechsel nicht richtig lädt, kann eine Inkompatibilität vorliegen.

Mögliche Ursachen:

* Welt wurde bereits mit einer neueren Version geöffnet
* Downgrade wurde durchgeführt
* Mods wurden entfernt
* Welt enthält Blöcke oder Items aus Mods
* Weltdateien sind beschädigt

Stelle in diesem Fall ein Backup wieder her.

### Support kontaktieren

Wenn der Versionswechsel nicht funktioniert oder dein Server danach nicht startet, kontaktiere den Support.

Gib bitte folgende Informationen an:

* aktuelle Server-Version
* gewünschte Server-Version
* verwendete Server-Software, zum Beispiel Vanilla, Paper, Forge oder Fabric
* genaue Fehlermeldung aus der Konsole
* ob Plugins oder Mods installiert sind
* ob vor dem Wechsel ein Backup erstellt wurde
* was du bereits versucht hast

**Sicherheit:** Sende niemals Passwörter, private Zugangsdaten oder Tokens an den Support.
