Guide d'utilisation

Installation de Kepler Client, gestion des profils, mods Modrinth, sauvegardes et étapes de dépannage. Kepler est actuellement en cours de test privé et de développement.

Installation et avertissement SmartScreen

En cours de développement

Kepler est actuellement en cours de test privé et les téléchargements ne sont pas encore disponibles. À sa sortie, il fonctionnera sur Windows, macOS et Linux ; l'environnement d'exécution Java requis est sélectionné automatiquement depuis le manifeste de versions de Mojang et téléchargé depuis les sources officielles, aucune installation manuelle de Java n'est donc nécessaire.

  • Pourquoi le message SmartScreen s'affiche : Kepler est une nouvelle application et n'est pas encore signé avec un certificat numérique de signature de code. Windows Defender SmartScreen peut afficher l'écran bleu Windows a protégé votre ordinateur pour les nouveaux binaires ; il ne s'agit pas d'une détection de logiciel malveillant, mais simplement d'un avis d'éditeur non reconnu.
  • Installation étape par étape : Clique sur le lien Informations complémentaires situé sous le message dans la boîte de dialogue SmartScreen, puis clique sur le bouton Exécuter quand même dans le coin inférieur droit pour continuer.
  • Vérification SHA-256 : Pour vérifier l'intégrité du fichier, exécute Get-FileHash .\KeplerClient-Kurulum.exe -Algorithm SHA256 dans Windows PowerShell et compare le hachage obtenu avec la somme de contrôle officielle SHA-256 indiquée sur la page de téléchargement.

Premier profil et assistant de configuration

En cours de développement

Lors du premier lancement, l'assistant de configuration te guide à travers les préférences initiales. Tu peux réexécuter l'assistant à tout moment depuis Paramètres > Avancé > Relancer la configuration ou naviguer rapidement avec la palette de commandes Ctrl+K.

  • Ajout d'un compte : Ouvre le menu du compte dans le coin supérieur droit pour te connecter avec un compte officiel Microsoft/Xbox via OAuth2 PKCE dans ton navigateur système (les jetons d'actualisation sont stockés dans le trousseau de ton OS), ou crée un Compte hors ligne local de 3 à 16 caractères pour jouer en solo.
  • Profil prêt à l'emploi ou personnalisé : Commence avec le profil optimisé prêt à l'emploi ou crée une instance propre ou moddée (Fabric, Quilt) depuis Bibliothèque > + Nouveau profil. Minecraft 1.21.x avec Fabric est pris en charge en premier ; 6 versions du 1.20 au 26.3 sont en phase de test.
  • Importation depuis d'autres lanceurs : Analyse automatiquement les lanceurs installés (comme Prism Launcher ou l'application Modrinth) et importe les profils existants ainsi que leurs mondes.

Ajout de mods (Modrinth)

En cours de développement

Le catalogue de mods de Kepler débute avec Modrinth. Kepler ne distribue pas d'archives de jeu moddées préempaquetées ; tous les mods sont téléchargés directement depuis les sources officielles avec vérification SHA-1.

  • Recherche et installation de mods : Sélectionne ton profil cible sur l'écran Découvrir et effectue une recherche dans le catalogue Modrinth. La compatibilité des mods et les dépendances requises sont automatiquement résolues pour la version de jeu de ton profil.
  • Gestion et mise à jour des mods : Dans l'onglet Mods d'un profil sous Bibliothèque, filtre les mods installés par Tous, Activés ou Désactivés, et clique sur Vérifier les mises à jour pour voir les nouvelles versions.
  • Modpacks .mrpack : Importe des archives .mrpack de Modrinth et .zip compatibles avec une protection contre la traversée de répertoires et un filtrage des domaines autorisés, ou exporte ton profil sous forme de paquet.

Partage de profil (code KEPLER1)

En cours de développement

Partage la configuration de ton profil sans envoyer de volumineux fichiers d'archive en utilisant un code de partage de profil compact KEPLER1:.

  • Structure des données utiles : Préfixé par KEPLER1: suivi de JSON en Base64 sécurisé pour les URL, le code encode la version du schéma, le nom du profil, la version de Minecraft, les informations optionnelles du chargeur de mods et les identifiants de mods Modrinth (project_id, version_id, filename).
  • Confidentialité et limites de validation : Un code de partage n'inclut jamais le contenu des fichiers, les chemins du système de fichiers local, les identifiants de compte ou les paramètres privés. Les importations valident une taille maximale de 64 Ko et jusqu'à 500 mods.
  • Exportation des paramètres : Tu peux également exporter et importer la configuration du lanceur, les thèmes et les listes de serveurs sous la forme d'un fichier JSON autonome.

Mode configuration modeste

En cours de développement

Pour les ordinateurs dotés d'une mémoire limitée ou de processeurs modestes, Kepler fournit une analyse matérielle et des préréglages de lancement ajustés.

  • Préréglage configuration modeste : Dans les paramètres du profil sous Préréglage de performance, choisis entre les modèles d'arguments JVM Faible config (mode PC modeste), Équilibré ou Haute performance.
  • RAM automatique et calibration : L'allocation recommandée pour le tas (heap) est calculée à partir de la RAM totale/disponible de ton système, du nombre de cœurs CPU, du nombre de mods et de la version de Minecraft. La calibration de 2‑3 minute intégrée au lanceur teste 3 à 4 profils candidats et sélectionne le profil optimal pour ton matériel.
  • Options d'interface allégée : Désactive les animations du lanceur et active Vue compacte sous Paramètres > Jeu.

Captures d'écran

En cours de développement

Les captures d'écran en jeu de chaque profil sont enregistrées séparément dans le répertoire <profile>/screenshots de cette instance.

  • Parcours et aperçu : Le lanceur répertorie les captures d'écran .png du profil sélectionné triées de la plus récente à la plus ancienne (jusqu'à 500 captures d'écran par requête et 12 Mo par image).
  • Suppression et ouverture du dossier : Supprime les captures d'écran indésirables directement depuis le lanceur ou ouvre le répertoire screenshots du profil dans le gestionnaire de fichiers par défaut de ton système d'exploitation.

Sauvegardes

En cours de développement

Avant d'ajouter des mods ou de changer de version, protège tes données depuis l'onglet Sauvegardes situé dans n'importe quel profil sous Bibliothèque.

  • Sauvegardes .zip atomiques : Clique sur Créer une sauvegarde, sélectionne l'étendue Mondes uniquement ou Profil complet, ajoute une étiquette optionnelle et génère une archive .zip en un clic.
  • Restauration sécurisée : Affiche les sauvegardes existantes avec les métadonnées de date et de taille, supprime les anciennes archives ou lance Restaurer la sauvegarde—ce qui crée automatiquement une sauvegarde de sécurité avant la restauration.

Connexion directe au serveur (--server)

En cours de développement

Connecte-toi directement aux serveurs multijoueurs soit depuis l'écran Serveurs du lanceur, soit via les arguments de lancement en ligne de commande.

  • Liste de serveurs et ping SLP : Enregistre des serveurs multijoueurs, surveille le statut en ligne, le nombre de joueurs et la latence (ms) individuellement ou en bloc grâce au protocole Server List Ping (SLP), et clique sur Rejoindre pour lancer le jeu directement sur un serveur.
  • Arguments de lancement en ligne de commande : Démarre Kepler avec --server <host[:port]>, --port <n> et --profile <id> (ou --server=host:port) pour connecter directement le profil de ton choix au serveur cible.
  • Validation d'adresse : Les adresses malformées contenant des espaces et les adresses link-local/de métadonnées (169.254.x.x) sont rejetées pour des raisons de sécurité.

Rapport de crash

En cours de développement

Lorsque le jeu se ferme de manière inattendue, le superviseur de processus analyse le code de sortie et le tampon circulaire des dernières lignes de console stdout/stderr.

  • Détection de conflits : Sous Performance > Dépannage, Kepler répertorie les causes probables de crash et les mods suspects en conflit ; tu peux désactiver un mod en conflit en un clic via Désactiver le mod ou Essayer de corriger.
  • Masquage de confidentialité : Lors de l'utilisation de Copier le rapport ou Partager le journal, un filtre de confidentialité masque automatiquement ton nom d'utilisateur et les chemins de fichiers de ton système local.

Dépannage

Avertissements fréquents et comment les résoudre :

  • « Le jeu est déjà en cours d'exécution » (already_running) : Un processus Minecraft actif s'exécute en arrière-plan. Clique sur Arrêter sur l'écran d'accueil ou attends que le processus se termine avant de le relancer.
  • Le jeu plante au démarrage : Deux mods peuvent présenter un conflit de rendu ou d'API. Ouvre Performances > Outil de dépannage et désactive le mod suspect.
  • Mémoire insuffisante ou saccades : Trop peu de RAM ou plus de 75 % de la mémoire système est peut-être allouée au profil. Active RAM automatique dans les paramètres du profil ou relance le test de calibration.
  • Java non pris en charge (unsupported_java) : Ouvre Performances > Java et utilise Détecter automatiquement/télécharger Java pour la version de Minecraft sélectionnée.
  • La connexion Microsoft ne se termine pas : Si l'authentification dans le navigateur a expiré, clique sur Annuler et recommence la procédure de connexion.

Tu cherches des définitions techniques ?

Consulte le glossaire pour obtenir des explications concises sur Fabric, Modrinth, la JVM, le heap, le HUD et SmartScreen, ou visite notre page FAQ.