Skip to main content

O que é um arquivo de manifesto Steam e como usá-lo com SteamTools?

O guia completo para arquivos de manifesto Steam, o script de desbloqueio Lua correspondente e o fluxo de trabalho de quatro etapas para colocar um jogo em SteamTools. Projetado como porta de entrada para novos usuários; mergulhos profundos ao vivo nas páginas vinculadas.

Última atualização: 2026-07-05

Se você já pesquisou “como usar SteamTools” ou “o que é um manifesto Steam” e acabou lendo cinco Discords diferentes e três problemas de GitHub, esta página é para você. É a porta de entrada para o resto do site. Ele responde às duas perguntas que todos fazem primeiro, vincula as páginas de aprofundamento para todo o resto e deixa você com um arquivo funcional em seu disco no final da seção que importa.

A resposta de 30 segundos

Um arquivo de manifesto Steam é um pequeno arquivo de texto no formato "ACF" de Valve que informa ao cliente de desktop SteamTools quais depósitos de um jogo Steam devem ser baixados e como verificá-los. Um arquivo de manifesto é sempre emparelhado com um pequeno script Lua que informa ao SteamTools qual ramificação preferir e como autenticar nos servidores do Steam. Juntos, os dois arquivos permitem que SteamTools instale um jogo para jogar offline sem passar pelo cliente Steam oficial.

Você pode gerar um par manifesto + Lua para qualquer Steam App ID na página inicial. O restante deste guia explica o que são os arquivos, como funcionam, onde colocá-los e o que fazer quando algo quebra.

O que é um arquivo de manifesto Steam?

Um arquivo de manifesto é um arquivo de texto denominado appmanifest_<APPID>.acf. É assim para o Portal (AppID 400):

"AppState"
{
    "appid"         "400"
    "name"          "Portal"
    "installdir"    "Portal"
    "StateFlags"    "4"
    "UpdateLocalTime"   "Wed Jan  1 12:34:56 2025"
    "buildid"       "1234567"
    "LastOwner"     "12345678901234567"
    "BytesToDownload"   "1234567890"
    "BytesDownloaded"   "1234567890"
    "AutoUpdateBehavior"    "0"
    "AllowOtherDownloadsWhileRunning"  "0"
    "InstalledDepots"
    {
        "400"  "1234567890123456789"
    }
}

A forma é fixada por Valve. Os campos interessantes são appid (qual jogo), installdir (onde SteamTools deve colocar os arquivos), buildid (qual build do jogo) e o bloco InstalledDepots (quais IDs de depósito para download e os IDs de manifesto que os desbloqueiam). Todos os outros campos são contabilidade que SteamTools geralmente ignora.

Se você quiser o detalhamento completo campo por campo - o que StateFlags realmente faz, por que LastOwner se parece com um número de 17 dígitos e como os IDs de manifesto no bloco InstalledDepots se relacionam com o CDN de Steam - o mergulho profundo está na página arquivos de manifesto explicados. A versão resumida: se appid, installdir, buildid e InstalledDepots estiverem corretos, SteamTools instalará o jogo. Todo o resto são metadados.

Para que serve o arquivo Lua?

O arquivo Lua é o parceiro do manifesto. É um script pequeno (normalmente de 10 a 30 linhas) que informa três coisas ao SteamTools:

  1. Qual ramo preferir. Os jogos Steam têm vários ramos — public, beta, ptb, experimental, staging. O arquivo Lua informa ao SteamTools para qual deles o manifesto foi gerado. Se você não especificar uma ramificação, o gerador será padronizado como public.
  2. Como autenticar no CDN de Steam. O script solicita que SteamTools assine o manifesto nos servidores de conteúdo público de Steam e confirme se os IDs de depósito no manifesto correspondem a uma compilação real para download.
  3. O que fazer com os dados do depósito após o download. Alguns jogos precisam de uma pequena etapa pós-instalação (descompactar um arquivo, mover um arquivo para o lugar certo, definir uma configuração). O arquivo Lua pode incluir essa etapa.

O arquivo Lua não é opcional. SteamTools se recusará a instalar um jogo se o manifesto estiver presente, mas o arquivo Lua estiver faltando. Os dois arquivos sempre vêm como um par deste gerador.

O fluxo de trabalho completo — o que o arquivo Lua realmente faz, o que cada linha significa e o que acontece quando um script Lua gera um erro — está na página como funciona. A página também possui um diagrama de fluxo de quatro etapas que você pode seguir.

Como os dois arquivos funcionam juntos

O modelo mental é: o manifesto diz o que instalar, o Lua diz como instalá-lo. SteamTools lê o manifesto primeiro para saber quais depósitos de qual compilação buscar. Em seguida, ele executa o script Lua para saber qual ramificação, qual caminho de autenticação e quais etapas pós-instalação aplicar. Se algum dos arquivos estiver faltando, SteamTools sai mais cedo e grava uma linha em seu diretório de log explicando o que estava faltando.

Os dois arquivos também têm versão bloqueada entre si. Um manifesto gerado na ramificação public não funcionará com um script Lua gerado para a ramificação beta e vice-versa. O gerador sempre retorna os dois arquivos como um par correspondente; não misture e combine arquivos de fontes diferentes.

Passo a passo: do AppID ao jogo instalado

O fluxo de trabalho completo leva cerca de três minutos depois que você tiver seu AppID. A versão condensada:

  1. Encontre o App ID. É o número na URL da loja Steam — por exemplo, Portal é https://store.steampowered.com/app/400/, so the App ID is 400. Se você não conseguir encontrá-lo no URL, a página como encontrar um Steam App ID tem três métodos confiáveis.
  2. Search and confirm. Type the game name or App ID on the home page. The search runs against the live Steam store, so DLC, soundtracks, and unlisted-but-published apps all show up.
  3. Gerar. Pressione o botão. O gerador consulta o cache upstream ManifestHub3 e retorna um ZIP contendo os arquivos .acf e .lua. A resposta geralmente é inferior a 1,5 segundos.
  4. Place the files. Drop the .acf file into <SteamTools>/depotcache/ and the .lua próximo ao binário SteamTools. Reinicie SteamTools. O jogo aparece na sua biblioteca.

O passo a passo detalhado - incluindo onde <SteamTools> reside em Windows, macOS e Linux, o que fazer se SteamTools não vê os arquivos e como ler o log SteamTools - está na página como funciona.

Como encontrar um Steam App ID

Três métodos confiáveis, na ordem de frequência com que funcionam:

  1. No URL da loja Steam. Abra a página da loja do jogo. O número entre /app/ e o próximo / é App ID. Exemplo: https://store.steampowered.com/app/400/Portal/ → 400.
  2. De SteamDB. Pesquise o jogo em steamdb.info. O URL canônico da loja na parte superior da página contém App ID.
  3. From your local Steam install. If you have the game installed, look in <Steam>/steamapps/. Every installed game has a file called appmanifest_<APPID>.acf nesse diretório. O número no nome do arquivo é App ID.

O guia completo – incluindo como encontrar o App ID para jogos excluídos, DLC, trilhas sonoras e aplicativos não listados, mas publicados – está na página como encontrar um Steam App ID.

Problemas e soluções comuns

As cinco coisas que dão errado com mais frequência, em ordem de frequência:

1. O ZIP baixado está vazio. Geralmente uma de três coisas. Ou o AppID está no catálogo Steam, mas ainda não está no cache ManifestHub3 (a página deve mostrar um aviso "ainda não está em nosso banco de dados de download" com um link Discord), o cliente SteamTools está filtrando o arquivo (verifique o diretório de log) ou uma ferramenta de segurança local está removendo a resposta. Se nada disso servir, abra uma edição com o App ID e uma cópia do ZIP.

2. SteamTools não vê os arquivos depois que eu os coloco. A causa mais comum é a pasta errada. Em Windows o caminho é <SteamTools>\depotcache\ para .acf e <SteamTools>\ para .lua. Em macOS e Linux os caminhos são análogos. Reinicie SteamTools após copiar; ele não recarrega a quente.

3. Erro "Aplicativo não encontrado na loja Steam". O número geralmente é um ID de pacote, ID de depósito ou ID de compilação - não um App ID. Confirme no armazenamento canônico URL. Os jogos excluídos cujos AppIDs não são mais resolvidos em /appdetails não podem ser gerados.

4. Erro "limite de taxa 429". O gerador impõe 1,5 segundos entre chamadas por IP. Se você estiver criando scripts, a espera exponencial com limite de 10 segundos é o padrão certo. Não há chave API nem nível elevado.

5. O script Lua gera um erro na inicialização. O arquivo está corrompido (baixado novamente) ou foi gerado para uma ramificação diferente do manifesto. Sempre use o par correspondente de uma única chamada de gerador.

Para todos os problemas de cauda longa - incompatibilidades de ramificação, bloqueios regionais, interações anti-cheat, casos extremos com próton, o que fazer quando uma compilação é removida da lista entre a geração do manifesto e a reinicialização do SteamTools - o FAQ tem 20 entradas cobrindo a longa cauda de "Eu tentei o X, o que eu faço agora?".

SteamTools versus alternativas

As perguntas "vs" mais comuns, resumidamente:

  • SteamTools versus o cliente oficial Steam. SteamTools é um fork Steam não oficial e de código aberto mantido pela BeyondDimension. Não é distribuído ou endossado por Valve. Ele estende o cliente oficial com gerenciamento de biblioteca offline, troca de várias contas e a capacidade de aplicar manifesto publicado pela comunidade + desbloqueios Lua. Este site (SteamTools.games) é um gerador independente que produz o manifesto + par Lua que SteamTools consome — não é um fork e nem um cliente.
  • Watt Toolkit vs Steam++ vs SteamTools. Eles são o mesmo projeto em momentos diferentes. SteamTools era o nome original; a comunidade de língua chinesa chamou-o de Steam++; mais tarde foi renomeado para Watt Toolkit. Todos os três nomes referem-se ao mesmo cliente de desktop em github.com/BeyondDimension/SteamTools.
  • SteamTools vs GreenLuma. GreenLuma é um projeto comunitário separado com um formato de manifesto + Lua diferente. Os dois ecossistemas não são intercambiáveis. SteamTools.games produz arquivos especificamente para o cliente SteamTools; se você é um usuário GreenLuma, este gerador não é a ferramenta certa para você.
  • SteamTools em 2026. Para novos usuários, SteamTools + este gerador é o caminho mais leve. O outro ecossistema (GreenLuma e um pequeno número de desbloqueadores pagos) não é recomendado para novos usuários; as ferramentas são menos mantidas, menos documentadas e apresentam maior risco de malware.

A comparação completa, incluindo por que alguns desbloqueadores pagos parecem funcionar, mas não são confiáveis, está na página FAQ.

Para desenvolvedores

O gerador expõe um REST público API em /api/search (procure um AppID no nome de um jogo) e /api/generate (produza o par manifesto + Lua). Ambos não são autenticados, estão sujeitos a um limite de taxa por IP e estão documentados na página dos desenvolvedores. Uma especificação OpenAPI 3.1 pode ser baixada na mesma página.

Se você estiver integrando SteamTools em uma automação maior, o padrão certo é:

  • Use /api/search para resolver um nome de jogo digitado pelo usuário para App ID.
  • Use /api/generate com aquele App ID e um parâmetro de ramificação.
  • Respeite o limite de taxa de 1,5 segundo. Backoff exponencial com limite de 10 segundos.
  • Armazene em cache o resultado. Os pares Manifesto + Lua são versionados para o ID de compilação upstream; eles não precisam ser buscados novamente, a menos que o cache upstream seja alterado.

Para geração em lote de mais de 50 títulos de uma só vez, o caminho mais rápido é perguntar no Discord e fazer com que os mantenedores os adicionem ao ManifestHub3 de uma só vez, que é o que reflete a lista selecionada de "Jogos Populares" na página inicial.

O conjunto completo de páginas relacionadas

Se você quiser ler mais uma página, escolha uma destas com base no que você precisa:

  • Sobre SteamTools.games — o que é este site, quem o administra, o que não é. Leia isto se quiser saber quem está por trás do gerador.
  • Como funciona — o fluxo completo de quatro etapas com o diagrama, o visual de quatro etapas e um mergulho profundo no que o script Lua faz linha por linha. Leia isto se quiser entender o fluxo de trabalho antes de fazê-lo.
  • Arquivos de manifesto explicados — cada campo no arquivo appmanifest_*.acf, o que ele faz e por que SteamTools precisa de cada um. Leia isto se quiser ler seu manifesto manualmente.
  • Como encontrar um Steam App ID — três métodos confiáveis, além dos casos extremos (removidos da lista, DLC, trilhas sonoras). Leia isto se você tiver um jogo, mas não tiver App ID.
  • FAQ — 20 perguntas de cauda longa cobrindo "Eu tentei o X, o que faço agora?" superfície. Leia isto quando algo quebrar.
  • Citation — o cartão de identidade canônico e legível por máquina deste site. Leia isto se estiver citando SteamTools.games em um artigo de pesquisa ou resposta de IA.
  • Desenvolvedores — a documentação do API, a especificação OpenAPI e os detalhes do limite de taxa. Leia isto se você estiver escrevendo um script.
  • Changelog — o que mudou e quando. Leia isto se quiser saber se uma atualização recente do site afeta seu fluxo de trabalho.
  • Blog — guias, análises detalhadas e notas de produtos. Leia isto se quiser se aprofundar em um tópico específico.

Antecedentes: o que SteamTools realmente é

SteamTools (também chamado de Watt Toolkit, anteriormente chamado de Steam++) é um fork Steam de código aberto mantido pela BeyondDimension. Não é um plugin para o cliente Steam oficial — é um fork completo que substitui o binário Steam em sua máquina. Ele roda em Windows, macOS e Linux.

SteamTools estende o cliente Steam oficial de três maneiras importantes para este guia:

  1. Gerenciamento de biblioteca offline. SteamTools pode manter uma biblioteca Steam offline totalmente funcional, incluindo jogos que você já começou a jogar online. Quando os servidores Steam estão inacessíveis, SteamTools retorna para sua cópia local dos dados do depósito mais os arquivos de manifesto + Lua que você colocou em seu diretório de configuração.
  2. Comutação de várias contas. SteamTools pode executar várias contas Steam em paralelo na mesma máquina, com depósitos isolados e dados salvos isolados. O cliente Steam oficial não oferece suporte para isso.
  3. Desbloqueios publicados pela comunidade. Esta é a parte que precisa de arquivos de manifesto + Lua. SteamTools lê um arquivo de manifesto de seu diretório depotcache, executa o script Lua para autenticar nos servidores de conteúdo público de Steam e baixa os dados do depósito em uma pasta que o cliente Steam oficial pode usar posteriormente como um "servidor de conteúdo local". Os pares manifesto publicado pela comunidade + Lua (e o cache de dados que os apoia) são o que o projeto upstream ManifestHub3 fornece.

Se você quiser um artigo mais longo sobre o que é SteamTools, quem o mantém, como ele se relaciona com Steam++ e Watt Toolkit e onde estão os limites entre este gerador e o cliente de desktop, a página sobre tem a definição completa da entidade.

Mal-entendidos comuns

Algumas coisas que surgem com frequência suficiente para antecipar:

"Um arquivo de manifesto é um crack ou um hack." É um arquivo de configuração. Os dados apontados já estão no CDN público de Steam; o manifesto é uma receita que informa ao SteamTools quais depósitos buscar e como verificá-los. O manifesto em si não contém nenhum conteúdo protegido por direitos autorais.

"Se eu tiver um manifesto, posso obter qualquer jogo gratuitamente." Não. Um manifesto só funciona para jogos que você comprou legitimamente no Steam. O modo offline do SteamTools requer que os dados do depósito subjacente sejam aqueles pelos quais você já pagou; o manifesto é um indicador, não um substituto para a compra.

"SteamTools e este site são o mesmo projeto." Não são. SteamTools é o cliente de desktop, mantido por BeyondDimension em github.com/BeyondDimension. Este site é um gerador independente, mantido pela equipe SteamTools.games, que produz um dos insumos consumidos pelo SteamTools. Os dois projetos compartilham um nome e um objetivo, mas têm bases de código separadas, mantenedores separados e cadências de lançamento separadas.

"Se um jogo não estiver no cache upstream, devo desistir." Não - a página informará isso explicitamente e vinculará ao Discord para solicitá-lo. Os títulos mais populares acabam no cache poucos dias após a solicitação; títulos de nicho podem levar um ciclo de lançamento. A mensagem “ainda não está no cache” é o sinal certo, não um beco sem saída.

"Posso usar um manifesto GreenLuma com SteamTools." Não, os formatos são diferentes. Os dois ecossistemas não são intercambiáveis. Um manifesto GreenLuma não será carregado em SteamTools e um manifesto SteamTools não será carregado em GreenLuma.

Quando NÃO usar este gerador

O gerador é a ferramenta certa quando você deseja usar SteamTools para instalar um jogo que você já possui para jogar offline. É a ferramenta errada quando:

  • Você não comprou o jogo. O manifesto descreve apenas como buscar dados do depósito; não ignora a compra. Não existe “manifesto gratuito” – os manifestos descrevem o conteúdo já adquirido.
  • Você está usando GreenLuma, Goldberg ou outro cliente não SteamTools. Esses ecossistemas têm seus próprios formatos de manifesto. Os arquivos que este gerador produz são específicos do SteamTools.
  • Você quer jogar online. O modo offline do SteamTools é para jogar offline. O jogo online passa pelo cliente oficial Steam normalmente; A função de SteamTools é apenas a troca de várias contas.
  • O jogo foi removido da lista e App ID não é mais resolvido. O endpoint /appdetails de Steam é a fonte da verdade; se App ID não retornar nada, o gerador não poderá ajudar. SteamDB mantém um registro, mas os dados reais do depósito não podem mais ser obtidos de Steam.

Glossário

Uma breve referência para os termos usados ​​neste guia e nas páginas vinculadas.

App ID. Um número de 6 a 8 dígitos que identifica exclusivamente um aplicativo Steam. É o número na loja Steam URL após /app/. Exemplo: 400 para Portal.

Branch. Jogos Steam podem ter múltiplas ramificações de construção — public é o padrão e o que você geralmente deseja; beta, ptb, experimental e staging são alternativas comuns. O arquivo Lua informa ao SteamTools para qual ramificação o manifesto foi gerado.

ID da versão. Um número de 6 a 10 dígitos que identifica uma versão específica de um jogo. O manifesto inclui o ID do build; SteamTools baixa os dados do depósito exatamente para essa compilação.

Depósito. Uma unidade de conteúdo para download em um aplicativo Steam. Um jogo típico tem de 1 a 5 depósitos (o jogo principal, a OST, pacotes de idiomas, etc.). O manifesto nomeia cada depósito e o ID do manifesto que o desbloqueia.

ID do manifesto. Um número de 19 dígitos que identifica uma versão específica de um depósito específico. O bloco InstalledDepots no manifesto mapeia IDs de depósito para IDs de manifesto.

ManifestHub3. O cache da comunidade de código aberto e licenciado pelo MIT de pares manifesto + Lua. O gerador lê ManifestHub3. Os dados são auditáveis, bifurcáveis ​​e não dependem deste site.

SteamTools. O cliente de desktop. Mantido por BeyondDimension em github.com/BeyondDimension. Distinto deste site.

SteamTools.games. Este site. Um gerador fino que produz o par manifesto + Lua que SteamTools consome. Não afiliado ao BeyondDimension.

Watt Toolkit. O nome atual em chinês para o cliente SteamTools. O projeto era anteriormente denominado Steam++.

ACF. Formato "Arquivo de configuração do aplicativo" de Valve. Um formato de texto de valor-chave com cabeçalhos de seção, semelhante ao INI. Os manifestos usam ACF.

Veja em ação

O fluxo de trabalho manifesto + Lua funciona para todos os jogos do catálogo Steam. Para ver a aparência de um arquivo gerado, o índice de jogos populares na página inicial tem AppIDs conhecidos prontos para serem gerados. Alguns dos mais solicitados:

Se o seu jogo não estiver nessa lista, procure-o na página inicial — se estiver no catálogo Steam, o gerador retornará um resultado. Se o cache upstream ManifestHub3 ainda não o tiver, a página informará isso e fornecerá um link Discord para solicitá-lo.