Guide de dépannage

Si cliquer sur Jouer ne donne aucune réponse ou si la fenêtre du jeu se ferme immédiatement, vérifie les étapes suivantes :

• Vérification des processus en arrière-plan : Si un processus Minecraft actif s'exécute déjà en arrière-plan (already_running), une nouvelle instance ne se lancera pas. Clique sur Arrêter sur l'écran d'accueil du lanceur ou mets fin au processus bloqué via le Gestionnaire des tâches de Windows.
• Allocation de mémoire (RAM) : Allouer trop peu de RAM (moins de 2 Go) ou plus de 75 % de la RAM totale de ton système peut empêcher la machine virtuelle Java de démarrer. Active RAM automatique dans les paramètres du profil ou ajuste le curseur à une quantité recommandée.
• Conflits de mods : Si des mods récemment ajoutés ont des API ou des versions en conflit, la séquence de démarrage peut se bloquer. Ouvre Performances > Outil de dépannage pour désactiver les mods suspects et réessaie.

Si Windows SmartScreen ou Windows Defender affiche une alerte lors du lancement de Kepler, suis ces instructions :

• Pourquoi l'avertissement apparaît : Kepler Client est un projet en cours de développement et les premières versions ne sont pas encore signées avec un certificat numérique commercial de signature de code (non signé). L'écran bleu Windows a protégé votre ordinateur affiché par Windows Defender SmartScreen ne signifie pas que l'application est malveillante ; il indique simplement que l'exécutable n'a pas encore acquis une large réputation.
• Étapes pour contourner SmartScreen : Clique sur le lien Informations complémentaires directement sous le message d'avertissement. Clique ensuite sur le bouton Exécuter quand même qui apparaît dans le coin inférieur droit pour démarrer le launcher.
• Ajouter une exclusion Windows Defender pour le dossier Kepler : Pour éviter que la protection en temps réel ne verrouille par erreur les fichiers du launcher, tu peux ajouter une exclusion :
  1. Ouvre Sécurité Windows depuis le menu Démarrer.
  2. Sélectionne Protection contre les virus & menaces.
  3. Sous Paramètres de protection contre les virus & menaces, clique sur Gérer les paramètres.
  4. Fais défiler jusqu'à la section Exclusions et clique sur Ajouter ou supprimer des exclusions.
  5. Clique sur Ajouter une exclusion, choisis Dossier et sélectionne ton dossier d'installation Kepler.

Kepler Client gère automatiquement les environnements d'exécution Java et ne nécessite aucune configuration manuelle dans des conditions normales.

• Gestion automatique de Java : Kepler détermine automatiquement la version exacte de Java requise par la version Minecraft de ton profil à l'aide du manifeste de versions officiel de Mojang, et la télécharge directement depuis des sources officielles. Tu n'as pas besoin d'installer Java manuellement.
• Que faire si le téléchargement échoue : Des pertes de connexion temporaires ou des règles de pare-feu peuvent interrompre le téléchargement.
  1. Vérifie ta connexion Internet et assure-toi que ton logiciel de sécurité ne bloque pas les points de terminaison officiels de Mojang.
  2. Ouvre Performances > Java dans le launcher et clique sur Détecter/télécharger automatiquement Java pour relancer le processus.
  3. Si tu as déjà un environnement d'exécution Java correspondant installé localement (Java 21 pour Minecraft 1.20.5+ et 1.21.x, ou Java 17 pour 1.18–1.20.4), tu peux sélectionner manuellement le binaire Java (javaw.exe) dans les paramètres du profil.

Les erreurs OpenGL, les dépassements de délai du pilote ou les fenêtres vides au lancement peuvent généralement être résolus en suivant les étapes suivantes :

• Mettre à jour les pilotes graphiques : La grande majorité des plantages en phase de rendu provient de pilotes graphiques obsolètes. Télécharge et installe le dernier pilote stable directement depuis les sites d'assistance officiels de NVIDIA, AMD ou Intel.
• Tester sans shaders : Les packs de shaders consomment d'importantes ressources GPU et peuvent rencontrer des problèmes de compatibilité avec certaines versions de pilotes. Si le jeu plante en entrant dans un monde, désactive les shaders dans les Paramètres vidéo et teste avec le rendu vanilla.
• Ordinateurs portables avec double GPU : Windows peut utiliser par défaut le processeur graphique intégré (iGPU). Ouvre les Paramètres graphiques de Windows et assure-toi que Kepler et javaw.exe sont explicitement assignés à ta carte graphique dédiée haute performance.

Si un fichier de mod que tu as ajouté n'apparaît pas dans Minecraft ou dans son menu de mods, vérifie ces critères de compatibilité :

• Prérequis du chargeur Fabric : Kepler Client fonctionne sur le chargeur de mods Fabric. Vérifie que le mod que tu as téléchargé est bien compilé pour Fabric ; les mods compatibles uniquement avec Forge ou NeoForge ne se chargeront pas dans un environnement Fabric.
• Version de Minecraft correspondante : Le fichier du mod doit correspondre strictement à la version de Minecraft de ton profil (par exemple, un mod conçu pour 1.21.x ne se chargera pas dans un profil 1.20.x). La recherche via le navigateur Modrinth intégré au launcher garantit automatiquement la compatibilité des versions.
• Dépendances requises : De nombreux mods Fabric nécessitent des bibliothèques auxiliaires telles que l'API Fabric pour se charger. Consulte la documentation du mod pour confirmer que toutes les bibliothèques complémentaires requises sont activées dans ton profil.

Si tu rencontres un plantage impossible à résoudre, tu peux consulter les journaux de diagnostic et envoyer un rapport :

• Affichage du rapport de plantage du launcher : Lorsque le jeu se ferme de manière inattendue, le superviseur de processus capture le code de sortie et les journaux stdout/stderr. Rends-toi dans Performances > Résolution des problèmes pour voir la cause principale et les conflits de mods identifiés.
• Masquage des données privées : Cliquer sur Copier le rapport ou Partager le journal supprime automatiquement ton nom d'utilisateur système et tes chemins de fichiers personnels du texte.
• Contacter l'assistance : Copie le rapport nettoyé et visite notre page d'assistance pour nous contacter ou faire un retour.