Leitfaden zur Fehlerbehebung

Wenn das Klicken auf Spielen keine Reaktion zeigt oder sich das Spielfenster sofort wieder schließt, überprüfe die folgenden Schritte:

• Überprüfung von Hintergrundprozessen: Wenn im Hintergrund bereits ein aktiver Minecraft-Prozess ausgeführt wird (already_running), wird keine neue Instanz gestartet. Klicke auf dem Startbildschirm des Launchers auf Stop oder beende den hängengebliebenen Prozess über den Windows Task-Manager.
• Speicherzuweisung (RAM): Die Zuweisung von zu wenig RAM (unter 2 GB) oder mehr als 75 % deines gesamten Systemspeichers kann verhindern, dass die Java Virtual Machine startet. Aktiviere Automatisches RAM in den Profileinstellungen oder passe den Schieberegler auf einen empfohlenen Wert an.
• Mod-Konflikte: Wenn kürzlich hinzugefügte Mods in Konflikt stehende APIs oder Versionen aufweisen, kann der Startvorgang hängen bleiben. Öffne Leistung > Fehlerbehebung, um verdächtige Mods zu deaktivieren, und versuche es erneut.

Wenn Windows SmartScreen oder Windows Defender beim Starten von Kepler eine Warnung anzeigt, befolge diese Anweisungen:

• Warum die Warnung erscheint: Kepler Client ist ein aktives Entwicklungsprojekt und frühe Veröffentlichungen sind noch nicht mit einem kommerziellen digitalen Code-Signing-Zertifikat signiert (unsigniert). Der von Windows Defender SmartScreen angezeigte blaue Bildschirm Der PC wurde durch Windows geschützt bedeutet nicht, dass die Anwendung bösartig ist; er weist lediglich darauf hin, dass die ausführbare Datei noch keine breite Reputation aufgebaut hat.
• Schritte zum Umgehen von SmartScreen: Klicke direkt unter der Warnmeldung auf den Link Weitere Informationen. Klicke dann auf die Schaltfläche Trotzdem ausführen, die in der unteren rechten Ecke erscheint, um den Launcher zu starten.
• Hinzufügen eines Windows Defender-Ausschlusses für den Kepler-Ordner: Um zu verhindern, dass der Echtzeitschutz versehentlich Launcher-Dateien sperrt, kannst du einen Ausschluss hinzufügen:
  1. Öffne Windows-Sicherheit aus dem Startmenü.
  2. Wähle Viren- & Bedrohungsschutz.
  3. Klicke unter Einstellungen für Viren- & Bedrohungsschutz auf Einstellungen verwalten.
  4. Scrolle nach unten zum Abschnitt Ausschlüsse und klicke auf Ausschlüsse hinzufügen oder entfernen.
  5. Klicke auf Ausschluss hinzufügen, wähle Ordner und wähle dein Kepler-Installationsverzeichnis aus.

Kepler Client verwaltet Java-Laufzeitumgebungen automatisch und erfordert unter normalen Bedingungen keine manuelle Konfiguration.

• Automatische Java-Verwaltung: Kepler ermittelt anhand des offiziellen Versionsmanifests von Mojang automatisch die genaue Java-Version, die für die Minecraft-Version deines Profils erforderlich ist, und lädt sie direkt von offiziellen Quellen herunter. Du musst Java nicht manuell installieren.
• Was zu tun ist, wenn der Download fehlschlägt: Vorübergehende Netzwerkausfälle oder Firewall-Regeln können den Download unterbrechen.
  1. Überprüfe deine Internetverbindung und stelle sicher, dass deine Sicherheitssoftware offizielle Mojang-Endpunkte nicht blockiert.
  2. Öffne Leistung > Java im Launcher und klicke auf Java automatisch erkennen/herunterladen, um den Vorgang neu zu starten.
  3. Wenn du bereits eine passende Java-Laufzeitumgebung lokal installiert hast (Java 21 für Minecraft 1.20.5+ und 1.21.x oder Java 17 für 1.18–1.20.4), kannst du die ausführbare Java-Datei (javaw.exe) in den Profileinstellungen manuell auswählen.

OpenGL-Fehler, Treiber-Timeouts oder leere Fenster beim Start können in der Regel mit folgenden Schritten behoben werden:

• Grafiktreiber aktualisieren: Die überwiegende Mehrheit der Abstürze während der Renderphase ist auf veraltete GPU-Treiber zurückzuführen. Lade den neuesten stabilen Treiber direkt von den offiziellen Support-Websites von NVIDIA, AMD oder Intel herunter und installiere ihn.
• Ohne Shader testen: Shader-Pakete verbrauchen viele GPU-Ressourcen und können bei bestimmten Treiberversionen zu Kompatibilitätsproblemen führen. Wenn das Spiel beim Betreten einer Welt abstürzt, schalte Shader in den Grafikeinstellungen aus und teste es mit Vanilla-Rendering.
• Laptops mit zwei GPUs: Windows verwendet möglicherweise standardmäßig die integrierte Prozessorgrafik (iGPU). Öffne die Windows-Grafikeinstellungen und stelle sicher, dass Kepler und javaw.exe explizit deiner dedizierten Hochleistungs-Grafikkarte zugewiesen sind.

Wenn eine von dir hinzugefügte Mod-Datei in Minecraft oder dessen Mod-Menü nicht angezeigt wird, überprüfe diese Kompatibilitätskriterien:

• Fabric-Loader-Anforderung: Kepler Client läuft auf dem Fabric-Mod-Loader. Vergewissere dich, dass die von dir heruntergeladene Mod für Fabric kompiliert ist; Mods, die ausschließlich für Forge oder NeoForge gedacht sind, werden in einer Fabric-Umgebung nicht geladen.
• Passende Minecraft-Version: Die Mod-Datei muss exakt mit der Minecraft-Version deines Profils übereinstimmen (beispielsweise wird eine für 1.21.x entwickelte Mod in einem 1.20.x-Profil nicht geladen). Die Suche über den im Launcher integrierten Modrinth-Browser stellt die Versionskompatibilität automatisch sicher.
• Zusätzliche Abhängigkeiten: Viele Fabric-Mods benötigen zum Laden Hilfsbibliotheken wie die Fabric-API. Sieh in der Mod-Dokumentation nach, um sicherzustellen, dass alle erforderlichen Begleitbibliotheken in deinem Profil aktiviert sind.

Wenn du auf einen nicht behebbaren Absturz stößt, kannst du die Diagnoseprotokolle einsehen und einen Bericht übermitteln:

• Ansicht des Absturzberichts im Launcher: Wenn das Spiel unerwartet beendet wird, erfasst die Prozessüberwachung den Exit-Code sowie die stdout/stderr-Protokolle. Navigiere zu Leistung > Fehlerbehebung, um die Ursache und identifizierte Mod-Konflikte einzusehen.
• Datenschutz-Maskierung: Durch Klicken auf Bericht kopieren oder Protokoll teilen werden dein System-Benutzername und private Dateipfade automatisch aus dem Text entfernt.
• Support kontaktieren: Kopiere den bereinigten Bericht und besuche unsere Support-Seite, um uns zu kontaktieren oder Feedback einzureichen.