Troubleshooting

Unity: open Tools ▸ Majacloud ▸ Setup and save; the asset must be at Assets/Resources/MajacloudSettings.asset. Godot: fill in Project Settings ▸ Majacloud. Web: pass baseUrl, projectId and clientKey.

Only localhost may use http://. Use HTTPS, or for development only set ALLOW_INSECURE_HTTP in config.local.php.

Serve the game over HTTPS too: browsers block http:// calls from an https:// page. The API already sends the CORS headers.

Every error has a request ID. Search for it on the Logs page of your project.

Check the Project ID and client key on the API keys page. If you rotated the client key, older builds stop working.

A session that is not used for 30 days expires. If two copies of the game share one session and both refresh it, the reuse protection signs it out: let one SDK instance own the session.

Browsers block tabs that are not opened from a click. Start linking from a button handler.

The stored public key does not match the server, usually after moving to a new server or losing storage/keys/. Run Test connection again (or update configPublicKey) and ship an update.

The SDKs fetch at startup. Call fetch again (for example when returning to the menu) to pick up changes during a session.

A plan limit was reached. Nothing is deleted; upgrade or remove unused items in the dashboard.

Wait the Retry-After seconds. Avoid fetching in Update() or game loops; cache results instead.

Enable the plugin under Project Settings ▸ Plugins; it adds the autoload. Check that the folder is exactly res://addons/majacloud.

The server's HTTPS certificate is not trusted (often a self-signed certificate). Use a certificate from a public authority such as Let's Encrypt.

The page is served over plain HTTP from another host. Serve it over HTTPS (localhost is fine while developing).