Skip to main content
Voltar ao blog

Corrigir erros do gerador SteamTools (manifesto e Lua)

Checklist para os quatro erros mais comuns no gerador do SteamTools — App ID inválido, arquivos ausentes, ZIP vazio — e a solução que resolve a maioria deles.

17 de ago. de 2026SteamTools Team
Corrigir erros do gerador SteamTools (manifesto e Lua)

O gerador é uma camada fina sobre as APIs públicas do Steam, então os erros que ele retorna costumam ser uma tradução direta dos erros vindos do servidor de origem. Veja abaixo a lista resumida do que você provavelmente vai encontrar, o que cada mensagem realmente significa e o que fazer em cada caso.

1. "A valid numeric App ID is required" (App ID numérico obrigatório)

De longe o erro mais comum. Três situações costumam causá-lo:

  • Você digitou um nome no campo, em vez de um número, e clicou em Gerar antes de o menu suspenso carregar os resultados. O menu fecha quando o campo perde o foco, e o App ID vazio acaba sendo enviado.
  • O App ID digitado contém um erro de digitação (uma letra, um zero à esquerda ou um espaço).
  • O campo está vazio — o formulário permite enviar em branco se você apertar Enter muito rápido.

Correção: digite ou cole apenas os números. Sem letras, sem zeros à esquerda e sem espaços em branco.

2. "App <id> was not found in the Steam store" (não encontrado na loja Steam)

O App ID informado tem o formato válido, mas o endpoint appdetails do Steam não retornou nenhum registro para ele. Isso quase sempre significa uma de três coisas:

  • O ID está errado por um ou dois dígitos. O SteamDB é a forma mais rápida de confirmar.
  • O ID pertence a um aplicativo disponível apenas em uma região diferente de cc=us. Alguns apps são restritos a uma única loja regional. Estamos adicionando mais regiões; por enquanto, teste o mesmo ID na URL da loja regional pelo navegador para confirmar se o app existe.
  • O ID pertence a um aplicativo que foi removido do Steam por completo (delisted). O SteamDB mantém o histórico do registro, mas o appdetails deixa de retorná-lo.

Correção: confirme o ID no SteamDB. Se ele aparecer por lá, mas o gerador continuar recusando, deixe uma mensagem no Discord para adicionarmos a região que falta.

3. "Steam search failed (429)" (falha na busca do Steam — 429)

Atingimos o limite de requisições (rate limit) do Steam. O gerador impõe um intervalo mínimo de 300 ms por IP para busca e 1,5 s para geração, além de o próprio servidor de origem do Steam também aplicar limitação de taxa. Se você vir esse erro, a melhor saída é aguardar alguns segundos e tentar novamente — o limite é por IP, não por conta, e zera rapidamente.

Correção: aguarde de 5 a 10 segundos e tente novamente. Se estiver escrevendo um script contra a API, confira no Discord os cabeçalhos de rate limit para implementar um recuo (backoff) limpo.

4. "App ID is too long" (App ID longo demais)

Você colou algo com mais de 10 dígitos. Os App IDs do Steam são inteiros sem sinal de 32 bits, então o máximo teórico é 4.294.967.295 — mas, na prática, nenhum aplicativo real passa de 7 dígitos, e a maioria tem de 4 a 6. Se aparecer a mensagem "too long" ("longo demais"), você provavelmente colou um trecho de URL ou um pedaço de JSON do SteamDB, e não apenas o ID.

Correção: copie somente o número do ID, e não a URL ou o JSON.

A única correção que resolve a maioria dos casos

Cerca de 80% de todas as mensagens de suporte que recebemos se resumem a: "o App ID que você digitou está errado, o ID real é X". A causa mais comum é copiar o número errado em uma página do SteamDB. O SteamDB exibe quatro números em toda página de aplicativo: o App ID, o Package ID, o Depot ID e o Build ID. Você precisa do App ID. Os outros três são coisas diferentes.

Se estiver em dúvida sobre qual número é qual, o cabeçalho da página no SteamDB sempre traz o link para a URL canônica da loja (store.steampowered.com/app/<APPID>/...) — esse é o número que você deve usar.

Se a mensagem de erro não estiver nesta lista

O gerador funciona em uma rota de servidor do TanStack Start; a mensagem de erro completa é retornada no corpo da resposta como { "code": -1, "message": "..." }. Se você encontrar uma mensagem que não esteja na lista acima, copie o texto completo e envie no Discord — normalmente levamos menos de uma hora para diagnosticar.


Fonte de dados: ManifestHub3 — o cache de código aberto, licenciado sob a licença MIT, com chaves de depot do Steam sobre o qual este gerador funciona. Audite o código, faça um fork ou rode seu próprio mirror.

Experimente o gerador →