|
| 1 | +# 🔧 Guide de dépannage - Comptes Microsoft |
| 2 | + |
| 3 | +## Problème : Compte Microsoft affiché comme "undefined" |
| 4 | + |
| 5 | +### Symptômes |
| 6 | +- Le compte Microsoft apparaît avec le nom "undefined" dans la liste des comptes |
| 7 | +- Le bouton "Supprimer" est visible mais le nom du joueur n'apparaît pas |
| 8 | +- La connexion Microsoft semble réussir mais les données ne sont pas correctement affichées |
| 9 | + |
| 10 | +### Causes possibles |
| 11 | +1. **Données de profil incomplètes** : Les données retournées par Microsoft ne contiennent pas le nom du joueur |
| 12 | +2. **Problème de sauvegarde** : Les données sont mal sauvegardées dans la base de données |
| 13 | +3. **Corruption des données** : Les données stockées sont corrompues |
| 14 | +4. **Problème de synchronisation** : Décalage entre les données Microsoft et l'affichage |
| 15 | + |
| 16 | +### Solutions |
| 17 | + |
| 18 | +#### 🔄 Solution 1 : Diagnostic automatique (Recommandé) |
| 19 | +1. Ouvrez la console développeur (`F12`) |
| 20 | +2. Tapez : `launcherDiagnostic.diagnoseAccounts()` |
| 21 | +3. Puis : `launcherDiagnostic.fixAccounts()` |
| 22 | +4. Redémarrez le launcher |
| 23 | + |
| 24 | +#### 🔄 Solution 2 : Suppression et reconnexion |
| 25 | +1. Supprimez le compte "undefined" avec le bouton Supprimer |
| 26 | +2. Redémarrez le launcher |
| 27 | +3. Reconnectez-vous avec votre compte Microsoft |
| 28 | + |
| 29 | +#### 🔄 Solution 3 : Nettoyage complet |
| 30 | +1. Ouvrez la console développeur (`F12`) |
| 31 | +2. Tapez : `launcherDiagnostic.clearBrokenAccounts()` |
| 32 | +3. Redémarrez le launcher |
| 33 | +4. Reconnectez-vous |
| 34 | + |
| 35 | +#### 🔄 Solution 4 : Réinitialisation manuelle |
| 36 | +1. Fermez complètement le launcher |
| 37 | +2. Naviguez vers : `%APPDATA%/Launcher/databases/` (ou `data/Launcher/databases/` en mode dev) |
| 38 | +3. Supprimez ou renommez le fichier de base de données |
| 39 | +4. Redémarrez le launcher |
| 40 | +5. Reconnectez-vous |
| 41 | + |
| 42 | +### Prévention |
| 43 | + |
| 44 | +#### Vérifications avant connexion |
| 45 | +- Assurez-vous d'avoir une connexion internet stable |
| 46 | +- Vérifiez que votre compte Microsoft/Xbox est actif |
| 47 | +- Patientez pendant le processus de connexion |
| 48 | + |
| 49 | +#### Bonnes pratiques |
| 50 | +- Ne fermez pas le launcher pendant la connexion |
| 51 | +- Attendez que le popup de chargement disparaisse |
| 52 | +- Vérifiez que le nom apparaît correctement avant de continuer |
| 53 | + |
| 54 | +### Informations techniques |
| 55 | + |
| 56 | +#### Structure des données Microsoft |
| 57 | +```javascript |
| 58 | +{ |
| 59 | + "name": "NomDuJoueur", |
| 60 | + "profile": { |
| 61 | + "name": "NomDuJoueur", |
| 62 | + "id": "uuid-du-joueur" |
| 63 | + }, |
| 64 | + "meta": { |
| 65 | + "type": "Xbox" |
| 66 | + }, |
| 67 | + "access_token": "token...", |
| 68 | + "refresh_token": "token..." |
| 69 | +} |
| 70 | +``` |
| 71 | + |
| 72 | +#### Points de vérification |
| 73 | +- ✅ `data.name` doit être défini |
| 74 | +- ✅ `data.profile.name` doit être défini |
| 75 | +- ✅ `data.meta.type` doit être "Xbox" |
| 76 | +- ✅ Les tokens doivent être présents |
| 77 | + |
| 78 | +### Logs utiles |
| 79 | + |
| 80 | +Pour diagnostiquer le problème, recherchez ces messages dans la console : |
| 81 | + |
| 82 | +``` |
| 83 | +✅ Messages normaux : |
| 84 | +- "Ajout du compte: [nom] Type: Xbox" |
| 85 | +- "Compte sauvegardé avec succès: [nom]" |
| 86 | +- "Compte Xbox rafraîchi avec succès: [nom]" |
| 87 | +
|
| 88 | +❌ Messages d'erreur : |
| 89 | +- "Données de compte invalides" |
| 90 | +- "Nom de compte Microsoft manquant" |
| 91 | +- "Nom principal incorrect" |
| 92 | +``` |
| 93 | + |
| 94 | +### Support avancé |
| 95 | + |
| 96 | +#### Commandes de diagnostic |
| 97 | +```javascript |
| 98 | +// Dans la console F12 : |
| 99 | + |
| 100 | +// Voir tous les comptes stockés |
| 101 | +launcherDiagnostic.diagnoseAccounts() |
| 102 | + |
| 103 | +// Réparer automatiquement |
| 104 | +launcherDiagnostic.fixAccounts() |
| 105 | + |
| 106 | +// Nettoyer les comptes cassés |
| 107 | +launcherDiagnostic.clearBrokenAccounts() |
| 108 | + |
| 109 | +// Voir les données brutes d'un compte |
| 110 | +const launcher = new Launcher(); |
| 111 | +launcher.db = new database(); |
| 112 | +launcher.db.readAllData('accounts').then(console.log); |
| 113 | +``` |
| 114 | + |
| 115 | +#### Exportation des erreurs |
| 116 | +Si le problème persiste : |
| 117 | +1. Ouvrez la console (`F12`) |
| 118 | +2. Tapez : `errorHandler.exportErrors()` |
| 119 | +3. Un fichier JSON sera téléchargé avec les détails des erreurs |
| 120 | + |
| 121 | +### Cas spéciaux |
| 122 | + |
| 123 | +#### Compte Microsoft sans profil Minecraft |
| 124 | +Si votre compte Microsoft n'a pas de profil Minecraft : |
| 125 | +- Le launcher peut ne pas récupérer le nom correctement |
| 126 | +- Solution : Créez un profil Minecraft sur minecraft.net |
| 127 | +- Puis reconnectez-vous au launcher |
| 128 | + |
| 129 | +#### Comptes avec caractères spéciaux |
| 130 | +- Certains noms avec caractères spéciaux peuvent causer des problèmes |
| 131 | +- Le launcher tente de les corriger automatiquement |
| 132 | +- En cas de problème, le nom sera remplacé par "Joueur_[timestamp]" |
| 133 | + |
| 134 | +--- |
| 135 | + |
| 136 | +**Version** : 1.2.1+optimized |
| 137 | +**Dernière mise à jour** : Octobre 2025 |
| 138 | + |
| 139 | +Si le problème persiste après toutes ces solutions, contactez le support avec les logs d'erreur exportés. |
0 commit comments