MAJACLOUDPemecahan masalah
Masalah yang paling sering ditemui, dan cara mengatasinya.
Komentar kode dan nama API tetap dalam bahasa Inggris agar sesuai dengan SDK.
Di halaman ini
Koneksi#
not_configured / NotConfigured
Unity: buka Tools ▸ Majacloud ▸ Setup lalu simpan; asset harus berada di Assets/Resources/MajacloudSettings.asset. Godot: isi Project Settings ▸ Majacloud. Web: berikan baseUrl, projectId, dan clientKey.
https_required (HTTP 426)
Hanya localhost yang boleh memakai http://. Gunakan HTTPS, atau khusus untuk pengembangan, atur ALLOW_INSECURE_HTTP di config.local.php.
Semua request gagal di browser atau di WebGL
Sajikan game lewat HTTPS juga: browser memblokir panggilan http:// dari halaman https://. API sudah mengirim header CORS.
Menemukan request yang gagal
Setiap error punya request ID. Cari ID itu di halaman Log project Anda.
Login#
unauthorized di setiap panggilan
Periksa Project ID dan client key di halaman API key. Jika Anda mengganti client key, build lama berhenti berfungsi.
Pemain tiba-tiba keluar dari akunnya
Sesi yang tidak dipakai selama 30 hari akan kedaluwarsa. Jika dua salinan game berbagi satu sesi dan keduanya memperbaruinya, perlindungan pemakaian ulang akan mengeluarkan sesi itu: biarkan satu instance SDK saja yang memegang sesi.
Halaman penautan akun tidak terbuka
Browser memblokir tab yang tidak dibuka dari klik. Mulai penautan dari handler tombol.
Remote config#
signature_invalid / SignatureInvalid
Public key yang tersimpan tidak cocok dengan server, biasanya setelah pindah ke server baru atau kehilangan storage/keys/. Jalankan Test connection lagi (atau perbarui configPublicKey) lalu rilis update.
Perubahan config tidak muncul
SDK melakukan fetch saat game dimulai. Panggil fetch lagi (misalnya saat kembali ke menu) untuk mendapatkan perubahan selama sesi berjalan.
Batas#
plan_limit
Batas paket tercapai. Tidak ada yang dihapus; upgrade atau hapus item yang tidak terpakai di dashboard.
rate_limited / quota_exceeded
Tunggu selama Retry-After detik. Hindari fetch di Update() atau game loop; simpan hasilnya di cache.
Godot dan web#
Godot: Identifier "Majacloud" not declared
Aktifkan plugin di Project Settings ▸ Plugins; plugin ini menambahkan autoload. Pastikan foldernya tepat res://addons/majacloud.
Godot: TLS handshake failed
Sertifikat HTTPS server tidak dipercaya (sering kali sertifikat self-signed). Gunakan sertifikat dari otoritas publik seperti Let's Encrypt.
Web: "Web Crypto is unavailable"
Halaman disajikan lewat HTTP biasa dari host lain. Sajikan lewat HTTPS (localhost tidak masalah selama pengembangan).