Perguntas frequentes

O bloco da página inicial responde às seis perguntas mais frequentes. Esta página é a versão mais longa – as perguntas que surgem algumas vezes por mês, os casos extremos, as coisas que confundem as pessoas mesmo depois de terem usado o gerador algumas vezes. Se sua pergunta não estiver aqui, o Discord é o caminho mais rápido para uma resposta real.

O que é SteamTools.games, em uma frase?

Um utilitário gratuito baseado em navegador que produz o manifesto e o par Lua SteamTools necessário para desbloquear um jogo por App ID. É uma camada fina sobre os Steams públicos de API e não modifica nenhum arquivo de jogo em sua máquina.

Este site é afiliado a SteamTools, SteamDB ou Valve?

Não. O site é operado por membros da comunidade e é independente. O nome Steam, o nome SteamTools e o nome SteamDB são propriedade de seus respectivos proprietários e são usados ​​aqui apenas para fins descritivos.

Por que o site existe quando SteamTools já possui um gerador?

O gerador SteamTools oficial está hospedado em um domínio de terceiros que teve problemas de confiabilidade ao longo dos anos. SteamTools.games foi configurado como uma alternativa mais resiliente. Ambos produzem arquivos equivalentes; este site pretende ser mais rápido, mais disponível e mais transparente sobre como funciona.

Como encontro o App ID de um jogo que possuo?

Três maneiras confiáveis, em ordem:

1. Na URL da loja: abra a página da loja do jogo, copie o número entre /app/ e o próximo /. Por exemplo, https://store.steampowered.com/app/400/Portal/ -> 400.
2. From SteamDB: search for the game, look at the canonical store URL at the top of the SteamDB app page, copy the number there.
3. From your local Steam install: every installed game has a file appmanifest_<APPID>.acf in the steamapps. O número no nome do arquivo é App ID.

Há um passo a passo completo em uma página separada.

Por que o gerador retorna "App não encontrado na loja Steam"?

Quatro causas comuns, em ordem de frequência:

1. Número errado. Na maioria das vezes, este é um ID de pacote, ID de depósito ou ID de compilação, não um App ID. Confirme o número na loja canônica URL.
2. Aplicativo bloqueado por região. O gerador atualmente consulta cc=us. Se o aplicativo for vendido apenas em uma região específica, a pesquisa retornará vazia.
3. Aplicativo removido. SteamDB mantém o registro, mas appdetails não o retorna mais. SteamTools não funciona em aplicativos excluídos.
4. Erro de digitação. Um zero à esquerda, um espaço à direita ou um separador de milhares causarão esse erro.

Por que o gerador retorna um erro 429?

O gerador impõe um mínimo de 1,5 segundos entre chamadas POST /api/generate por IP. Se você enviar solicitações mais rápido que isso, receberá de volta um 429 com um cabeçalho Retry-After. O próprio upstream do Steam também limita a taxa. Se você vir isso, espere de 5 a 10 segundos e tente novamente.

Se você estiver criando scripts no API, o padrão correto é a espera exponencial com limite de 10 segundos. Não há “chave API” ou nível elevado – cada cliente obtém o mesmo limite de taxa.

O serviço é seguro? Você armazena meus dados?

O serviço não requer uma conta, não define cookies de rastreamento e não grava seu histórico de pesquisa em disco. Os únicos dados que ele processa no curto prazo são a string de pesquisa e o App ID que você confirma, e isso é usado apenas para uma solicitação. Os logs do servidor são alternados a cada 14 dias. A Política de Privacidade contém todos os detalhes.

Por que o arquivo se chama *.lua e o que ele contém?

O arquivo Lua é um script curto que informa ao SteamTools quais depósitos carregar para este aplicativo. Ele contém duas linhas: uma para registrar App ID e sua chave de descriptografia do depósito, e outra para apontar SteamTools para a construção específica do depósito. A análise completa está na página de arquivos de manifesto.

Posso criar o script do API?

Sim. Os dois pontos finais são:

• GET /api/search?query=<name-or-appid> — retorna até 5 correspondências como JSON.
• POST /api/generate com um corpo JSON de { "appId": "<id>", "branch": "<optional>" } — retorna o manifesto URL, o Lua URL, o nome e imagem validados do jogo e uma pequena lista de instruções.

Ambos estão sujeitos ao limite de taxa por IP (300 ms para pesquisa, 1,5 s para geração). Não há chave API, nem cota de uso, nem limite por IP além do limite de taxa. Não crie scripts do serviço a uma taxa superior a 1 solicitação a cada 1,5 segundos.

Posso incorporar o gerador em meu próprio site?

O endpoint é um JSON API público e sem autenticação. Você pode usá-lo em seu próprio frontend, desde que respeite o limite de taxa. O site não possui uma política CORS documentada além dos padrões; se você tiver problemas de CORS, deixe uma nota no Discord.

O que a faixa "Recentes" na página inicial realmente faz?

Ele lê uma única chave localStorage (steamtools.recent.v1) e renderiza os App IDs mais recentes gerados nos últimos 30 dias. Nada é enviado para um servidor. Você pode limpá-lo a qualquer momento nas configurações de dados do site do seu navegador.

Encontrei um bug/o gerador está errado sobre um aplicativo. O que eu faço?

O caminho mais rápido é o Discord. Abandone o App ID, o URL que você usou e o que você esperava que acontecesse, e um moderador encaminhará isso para a pessoa certa. A maioria dos problemas é triada em uma hora.

Existe uma maneira de apoiar o projeto?

Não há página de doações, nem Patreon, nem produtos. O site é financiado por um pequeno grupo de membros da comunidade e mantido deliberadamente pequeno para que o custo permaneça trivial. Se você quiser apoiar o projeto, o mais útil é reportar bugs no Discord e informar outros usuários do SteamTools sobre o site.

Por que alguns aplicativos estão faltando na seção "Jogos populares"?

A seção Jogos Populares é organizada por um pequeno grupo de moderadores e atualizada mensalmente. Se um jogo que você acha que deveria existir não existe, envie uma mensagem para Discord e ele provavelmente será adicionado na próxima atualização.

O que acontece se o serviço cair?

Um aviso será colocado no blog e um banner será exibido primeiro na página inicial. Se o serviço ficar inativo por um longo período, uma mensagem fixada em Discord apontará para uma alternativa funcional.

O serviço é pequeno o suficiente para que um único mantenedor possa reimplantá-lo em cerca de dez minutos em um VPS novo, portanto, interrupções prolongadas são improváveis. Breves sinais acontecem, principalmente quando o próprio Steam de API está tendo um dia ruim; aqueles resolvem por conta própria.

Veja também

• O que é um arquivo de manifesto Steam e como usá-lo com SteamTools? — o guia completo da porta da frente; esta página é um mergulho mais profundo em uma parte dela.