MAJACLOUDDépannage
Les problèmes les plus fréquents, et comment les résoudre.
Les commentaires du code et les noms d'API restent en anglais pour correspondre aux SDK.
Connexion au serveur#
not_configured / NotConfigured
Unity : ouvrez Tools ▸ Majacloud ▸ Setup et enregistrez ; l'asset doit se trouver dans Assets/Resources/MajacloudSettings.asset. Godot : renseignez Project Settings ▸ Majacloud. Web : passez baseUrl, projectId et clientKey.
https_required (HTTP 426)
Seul localhost peut utiliser http://. Utilisez HTTPS ou, pour le développement uniquement, définissez ALLOW_INSECURE_HTTP dans config.local.php.
Toutes les requêtes échouent dans le navigateur ou sur WebGL
Servez aussi le jeu en HTTPS : les navigateurs bloquent les appels http:// depuis une page https://. L'API envoie déjà les en-têtes CORS.
Retrouver une requête en échec
Chaque erreur a un ID de requête. Recherchez-le sur la page Journaux de votre projet.
Connexion des joueurs#
unauthorized à chaque appel
Vérifiez l'ID du projet et la clé client sur la page Clés API. Si vous avez régénéré la clé client, les anciens builds cessent de fonctionner.
Des joueurs sont déconnectés de manière inattendue
Une session inutilisée pendant 30 jours expire. Si deux copies du jeu partagent une même session et la rafraîchissent toutes les deux, la protection contre la réutilisation la déconnecte : confiez la session à une seule instance du SDK.
La page de liaison de compte ne s'ouvre pas
Les navigateurs bloquent les onglets qui ne sont pas ouverts à la suite d'un clic. Démarrez la liaison depuis le gestionnaire de clic d'un bouton.
Configuration à distance#
signature_invalid / SignatureInvalid
La clé publique enregistrée ne correspond pas au serveur, généralement après un changement de serveur ou la perte de storage/keys/. Relancez Test connection (ou mettez à jour configPublicKey) et publiez une mise à jour.
Les modifications de configuration n'apparaissent pas
Les SDK récupèrent la configuration au démarrage. Relancez une récupération (par exemple au retour au menu) pour prendre en compte les modifications en cours de session.
Limites#
plan_limit
Une limite de l'offre a été atteinte. Rien n'est supprimé ; passez à une offre supérieure ou supprimez les éléments inutilisés dans le tableau de bord.
rate_limited / quota_exceeded
Attendez le nombre de secondes indiqué par Retry-After. Évitez les appels dans Update() ou dans les boucles de jeu ; mettez plutôt les résultats en cache.
Godot et web#
Godot : Identifier "Majacloud" not declared
Activez le plugin dans Project Settings ▸ Plugins ; il ajoute l'autoload. Vérifiez que le dossier est exactement res://addons/majacloud.
Godot : TLS handshake failed
Le certificat HTTPS du serveur n'est pas reconnu (souvent un certificat auto-signé). Utilisez un certificat délivré par une autorité publique comme Let's Encrypt.
Web : « Web Crypto is unavailable »
La page est servie en HTTP non chiffré depuis un autre hôte. Servez-la en HTTPS (localhost suffit pendant le développement).