MAJACLOUDSolução de problemas
Os problemas mais comuns e como resolvê-los.
Comentários de código e nomes da API ficam em inglês para corresponder aos SDKs.
Nesta página
Conexão#
not_configured / NotConfigured
Unity: abra Tools ▸ Majacloud ▸ Setup e salve; o asset precisa estar em Assets/Resources/MajacloudSettings.asset. Godot: preencha Project Settings ▸ Majacloud. Web: passe baseUrl, projectId e clientKey.
https_required (HTTP 426)
Somente localhost pode usar http://. Use HTTPS ou, apenas para desenvolvimento, defina ALLOW_INSECURE_HTTP em config.local.php.
Todas as requisições falham no navegador ou no WebGL
Sirva o jogo via HTTPS também: os navegadores bloqueiam chamadas http:// feitas de uma página https://. A API já envia os cabeçalhos CORS.
Encontre uma requisição com falha
Todo erro tem um ID de requisição. Busque-o na página Logs do seu projeto.
Login#
unauthorized em todas as chamadas
Confira o ID do projeto e a chave de cliente na página Chaves de API. Se você rotacionou a chave de cliente, as builds antigas param de funcionar.
Jogadores são desconectados inesperadamente
Uma sessão sem uso por 30 dias expira. Se duas cópias do jogo compartilham a mesma sessão e ambas a renovam, a proteção contra reutilização a encerra: deixe uma única instância do SDK controlar a sessão.
A página de vinculação de conta não abre
Os navegadores bloqueiam abas que não são abertas a partir de um clique. Inicie a vinculação no handler de um botão.
Configuração remota#
signature_invalid / SignatureInvalid
A chave pública salva não corresponde à do servidor, geralmente depois de migrar para um novo servidor ou perder storage/keys/. Execute Test connection de novo (ou atualize configPublicKey) e lance uma atualização.
As alterações de configuração não aparecem
Os SDKs buscam a configuração na inicialização. Chame fetch de novo (por exemplo, ao voltar para o menu) para receber alterações durante uma sessão.
Limites#
plan_limit
Um limite do plano foi atingido. Nada é excluído; faça upgrade ou remova itens não usados no painel.
rate_limited / quota_exceeded
Aguarde os segundos indicados em Retry-After. Evite buscar dados em Update() ou em loops do jogo; guarde os resultados em cache.
Godot e web#
Godot: Identifier "Majacloud" not declared
Ative o plugin em Project Settings ▸ Plugins; ele adiciona o autoload. Confira se a pasta é exatamente res://addons/majacloud.
Godot: TLS handshake failed
O certificado HTTPS do servidor não é confiável (muitas vezes, um certificado autoassinado). Use um certificado de uma autoridade pública, como o Let's Encrypt.
Web: "Web Crypto is unavailable"
A página é servida via HTTP puro a partir de outro host. Sirva-a via HTTPS (localhost funciona durante o desenvolvimento).