MAJACLOUDFehlerbehebung
Die häufigsten Probleme und wie Sie sie lösen.
Codekommentare und API-Namen bleiben auf Englisch, damit sie zu den SDKs passen.
Auf dieser Seite
Verbindung#
not_configured / NotConfigured
Unity: Öffnen Sie Tools ▸ Majacloud ▸ Setup und speichern Sie; das Asset muss unter Assets/Resources/MajacloudSettings.asset liegen. Godot: Füllen Sie Project Settings ▸ Majacloud aus. Web: Übergeben Sie baseUrl, projectId und clientKey.
https_required (HTTP 426)
Nur localhost darf http:// verwenden. Nutzen Sie HTTPS oder setzen Sie, nur für die Entwicklung, ALLOW_INSECURE_HTTP in config.local.php.
Im Browser oder unter WebGL schlägt jede Anfrage fehl
Liefern Sie auch das Spiel über HTTPS aus: Browser blockieren http://-Aufrufe von einer https://-Seite. Die API sendet die CORS-Header bereits.
Eine fehlgeschlagene Anfrage finden
Jeder Fehler hat eine Anfrage-ID. Suchen Sie danach auf der Seite Logs Ihres Projekts.
Anmeldung#
unauthorized bei jedem Aufruf
Prüfen Sie Projekt-ID und Client-Schlüssel auf der Seite API-Schlüssel. Wenn Sie den Client-Schlüssel rotiert haben, funktionieren ältere Builds nicht mehr.
Spieler werden unerwartet abgemeldet
Eine Sitzung, die 30 Tage nicht genutzt wird, läuft ab. Teilen sich zwei Kopien des Spiels eine Sitzung und erneuern beide sie, meldet der Wiederverwendungsschutz sie ab: Lassen Sie nur eine SDK-Instanz die Sitzung verwalten.
Die Seite zur Kontoverknüpfung öffnet sich nicht
Browser blockieren Tabs, die nicht durch einen Klick geöffnet werden. Starten Sie die Verknüpfung aus einem Button-Handler.
Remote-Konfiguration#
signature_invalid / SignatureInvalid
Der gespeicherte öffentliche Schlüssel passt nicht zum Server, meist nach einem Serverumzug oder wenn storage/keys/ verloren gegangen ist. Führen Sie Test connection erneut aus (oder aktualisieren Sie configPublicKey) und veröffentlichen Sie ein Update.
Konfigurationsänderungen kommen nicht an
Die SDKs rufen die Konfiguration beim Start ab. Rufen Sie fetch erneut auf (zum Beispiel bei der Rückkehr ins Menü), um Änderungen während einer Sitzung zu übernehmen.
Limits#
plan_limit
Ein Tariflimit wurde erreicht. Es wird nichts gelöscht; führen Sie ein Upgrade durch oder entfernen Sie ungenutzte Elemente im Dashboard.
rate_limited / quota_exceeded
Warten Sie die in Retry-After angegebenen Sekunden ab. Vermeiden Sie Abrufe in Update() oder in Spielschleifen; speichern Sie Ergebnisse stattdessen zwischen.
Godot und Web#
Godot: Identifier "Majacloud" not declared
Aktivieren Sie das Plugin unter Project Settings ▸ Plugins; es fügt den Autoload hinzu. Prüfen Sie, ob der Ordner genau res://addons/majacloud heißt.
Godot: TLS handshake failed
Dem HTTPS-Zertifikat des Servers wird nicht vertraut (oft ein selbst signiertes Zertifikat). Verwenden Sie ein Zertifikat einer öffentlichen Zertifizierungsstelle wie Let's Encrypt.
Web: „Web Crypto is unavailable“
Die Seite wird über unverschlüsseltes HTTP von einem anderen Host ausgeliefert. Liefern Sie sie über HTTPS aus (localhost genügt während der Entwicklung).