Server startet nicht oder stürzt sofort wieder ab?
Wenn dein Minecraft-Server nach dem Start sofort wieder auf offline springt oder gar nicht erst hochkommt, ist die Ursache fast immer im Startup-Log sichtbar — du musst nur wissen, wo du nachsiehst.
So findest du das Log: Öffne im mcfreehost-Panel deinen Server und wechsle auf den Tab Konsole. Dort siehst du die kompletten Ausgaben des letzten Start-Versuchs von oben nach unten. Interessant ist meist der letzte Abschnitt vor dem Absturz — such nach Zeilen mit ERROR, FATAL oder Exception.
Die zwei mit Abstand häufigsten Ursachen, wenn dein Server (Fabric, Forge oder ein Modpack) nicht startet, drehen sich um Mods: entweder ist ein Mod auf dem Server gelandet, der da gar nicht hingehört, oder eine Mod-Abhängigkeit fehlt bzw. passt nicht zur Minecraft-Version. Beide erkennst du an typischen Log-Mustern — dieser Guide zeigt dir, welche das sind und wie du sie behebst.
Fehlerklasse 1: Ein Client-Mod ist auf dem Server gelandet
Erkennungsmerkmal im Log:
[main/ERROR]: Failed to start the minecraft server
java.lang.RuntimeException: Could not execute entrypoint stage 'main' due to errors, provided by 'modname'
Steht in deinem Log genau diese Zeile (oder sehr ähnlich), ist die Diagnose eindeutig: einer deiner installierten Mods ist ein Client-only-Mod — er gehört auf den PC des Spielers, nicht auf den Server.
Warum das passiert
Viele Mods gibt es nur für den Client (dein Spiel-Fenster), weil sie rein optische oder Komfortfunktionen bieten, die der Server gar nicht ausführen kann. Installierst du so einen Mod trotzdem im Server-/mods-Ordner, versucht Fabric bzw. Forge, seinen Einstiegspunkt (entrypoint) zu laden — und scheitert, weil der Mod Client-Klassen erwartet, die auf einem Server-Prozess (ohne Grafik, ohne Fenster) schlicht nicht existieren. Der Server bricht dann komplett ab, nicht nur der einzelne Mod.
Typische Client-only-Mods, die immer wieder versehentlich auf Server landen:
| Kategorie | Beispiele | Warum Client-only |
|---|---|---|
| Minimaps | Xaero's Minimap, JourneyMap (Client-Modus) | Rendert die Karte im Spielfenster |
| Shader/Grafik | Iris, Oculus, reine Optik-Mods | Verändert nur die lokale Darstellung |
| HUD/UI | Better-HUD-Mods, Inventory-Overlays | Zeigt Zusatzinfos im Client-Interface |
| Sound/Musik-Packs | Client-seitige Ambient-Sound-Mods | Spielt Audio nur lokal ab |
So behebst du es
- Modname aus der Log-Zeile ablesen — direkt nach
provided by '...'steht der technische Mod-Slug (z. B.xaerominimap). - Dateimanager öffnen — im Panel unter Dateien in den Ordner
/modswechseln. - Passende
.jar-Datei suchen und löschen — Dateinamen enthalten meist den Mod-Namen; bei Unsicherheit den Mod-Slug googeln, um den offiziellen Dateinamen zu bestätigen. - Server neu starten — über den Power-Button im Panel.
Prüfe danach das Log erneut: Steht dort ein weiterer Could not execute entrypoint-Fehler zu einem anderen Mod, wiederhole die Schritte — häufig landen mehrere Client-Mods gemeinsam im falschen Ordner (z. B. wenn ein komplettes lokales mods-Verzeichnis 1:1 hochgeladen wurde, statt nur die serverkompatiblen Mods auszuwählen).
Tipp: Auf der Moddingplattform (Modrinth, CurseForge) steht bei jedem Mod ein Environment-Hinweis (Client, Server, Client and Server). Nur Server oder Client and Server gehören in den Server-/mods-Ordner.
Fehlerklasse 2: Mod-Abhängigkeiten und Registry-Fehler
Startet dein Server, ohne dass die entrypoint-Zeile von oben auftaucht, siehst du stattdessen aber Fehler beim Laden von Registries (Items, Blöcke, Rezepte) oder Meldungen zu fehlenden Abhängigkeiten, liegt meist eine der folgenden Ursachen vor:
- Fehlende Fabric API / Forge-Bibliothek — viele Mods bauen auf einer Basis-Bibliothek auf (z. B. Fabric API). Fehlt sie im
/mods-Ordner, bricht jeder Mod ab, der sie voraussetzt. - Inkompatible Minecraft-Version — ein Mod für MC 1.20.4 lädt nicht zuverlässig auf einem 1.20.1-Server (und umgekehrt), selbst wenn die Versionsnummern ähnlich aussehen.
- Mod-Paare, die zusammengehören — manche Mods bestehen aus zwei Teilen (z. B. ein Hauptmod plus ein separates Kompatibilitäts-Addon). Fehlt einer der beiden, schlägt die Registry-Initialisierung des anderen fehl.
So gehst du vor
- Versionen prüfen — vergleiche die Minecraft-Version deines Servers (Panel → Konfiguration) mit der Version, für die jeder Mod laut Downloadseite gebaut wurde. Bei Fabric/Forge muss außerdem der Loader übereinstimmen (Fabric-Mods laufen nicht auf Forge und umgekehrt, NeoForge ist wiederum ein eigener Loader).
- Fehlende Abhängigkeit nachinstallieren — steht im Log ein Hinweis wie „requires fabric-api" oder ein ähnlicher Dependency-Fehler, lade genau diese Bibliothek in der passenden Version nach und leg sie ebenfalls in
/mods. - Notfalls halbieren (Bisect) — findest du keine eindeutige Fehlerursache, verschiebe testweise die Hälfte deiner Mods aus
/modsin einen anderen Ordner (z. B./mods-disabled) und starte neu. Startet der Server jetzt, liegt der Fehler in der entfernten Hälfte — wiederhole das Verfahren mit dieser Hälfte, bis du den einzelnen Übeltäter isoliert hast. - Server neu starten und Log erneut prüfen.
Diese Fehlerklasse braucht oft etwas mehr Geduld als Fehlerklasse 1, weil die Fehlermeldung seltener den exakten Modnamen nennt — das Bisect-Verfahren aus Schritt 3 ist dafür zuverlässig, auch wenn das Log selbst wenig hergibt.
Welt- oder Datenfehler: wann du uns kontaktierst
Nicht jeder Startfehler hat mit Mods zu tun. Zeigt dein Log stattdessen eine Zeile wie:
Unable to read or access the world gen settings file! Falling back to the default settings with a random world seed.
oder allgemeiner „Unable to read or access ..." bezogen auf Welt- oder Konfigurationsdateien, deutet das auf ein beschädigtes Welt- oder Datenverzeichnis hin — das ist keine Mod-Ursache und lässt sich nicht durch Entfernen von Mods lösen.
In diesem Fall: kontaktiere unseren Support über das Ticket-System im Panel und gib den genauen Log-Ausschnitt mit an. Lösche in diesem Fall bitte nichts selbst im Dateimanager, bevor der Support sich das Log angesehen hat — das erschwert die Diagnose unnötig.
FAQ
Woran erkenne ich Client-only-Mods, bevor ich sie hochlade?
Auf der Downloadseite jedes Mods (Modrinth, CurseForge) steht ein Environment-Feld mit den Werten Client, Server oder Client and Server. Nur Mods mit Server oder Client and Server gehören in den Server-/mods-Ordner. Steht dort nur Client, installiere den Mod ausschließlich lokal in deinem Spiel-Client, nicht auf dem Server.
Warum startet mein Server nach einem Mod-Update plötzlich nicht mehr?
Mod-Updates ändern manchmal ihre Minecraft-Versions-Anforderung oder ihre Abhängigkeiten, ohne dass du das aktiv mitbekommst — vor allem, wenn ein Modpack-Ersteller automatische Updates aktiviert hat. Prüfe im Log die genaue Fehlermeldung: Bezieht sie sich auf eine Registry oder eine fehlende Abhängigkeit, hilft Fehlerklasse 2 aus diesem Guide. Am sichersten ist, vor größeren Mod-Updates ein Backup über das Panel anzulegen.
Muss ich alle Mods einzeln testen, wenn ich den Übeltäter nicht finde?
Nicht einzeln — halbiere stattdessen deine Mod-Liste (Bisect-Verfahren, siehe Fehlerklasse 2). Damit brauchst du bei z. B. 40 Mods im schlechtesten Fall nur rund 6 Neustarts, um den einzelnen fehlerhaften Mod einzugrenzen, statt 40 einzelne Tests durchzuführen.
Kann ein Client-Mod auf dem Server auch Daten beschädigen?
Nein. Ein Client-only-Mod, der auf dem Server landet, verhindert nur, dass der Server-Prozess startet — er greift nicht auf deine Welt zu und beschädigt keine Daten. Sobald du die .jar-Datei aus /mods entfernst, startet der Server wieder normal mit deiner unveränderten Welt.