Arquivos de manifesto Steam e Lua explicados
O que contêm os arquivos .manifest e Lua do Steam, por que o SteamTools precisa dos dois e como um gerador gratuito cria o par a partir de qualquer App ID.

Um arquivo .manifest é uma das partes menos documentadas do ecossistema Steam. Ele não faz parte do cliente Steam, não é baixado junto com o jogo e você nunca vai vê-lo na interface do Steam. Mas, para o SteamTools, ele é indispensável. Este artigo traz a explicação direta do que realmente existe dentro dele.
O que um manifesto faz
Um manifesto é um pequeno arquivo de texto (geralmente de 1 a 4 KB) que lista cada depot que compõe um jogo no Steam, além da chave criptografada de que o SteamTools precisa para se comunicar com a CDN do Steam para aquele depot.
Um exemplo real (trecho) para um aplicativo de depot único:
"appbuild"
{
"appid" "400"
"name" "Portal"
"buildid" "1234567"
"depots"
{
"400"
{
"manifest" "1234567890abcdef..."
"size" "9876543210"
}
}
}
Essa longa sequência hexadecimal é a chave de descriptografia do depot. Sem ela, o SteamTools não tem como saber quais blocos do jogo solicitar, e a CDN do Steam recusa a requisição.
Por que o nome do arquivo importa
O SteamTools procura arquivos nomeados exatamente como <AppID>_<branch>.manifest dentro da pasta depotcache. Se você renomear um manifesto funcional de 400_public.manifest para 400-beta.manifest e colocá-lo na pasta da branch errada, o SteamTools se recusará a instalar — o próprio nome funciona como índice.
É por isso que o nosso gerador sempre retorna um par com o nome da branch no arquivo. Se você precisa apenas da branch padrão public, deixe o campo como está; se quiser especificamente beta ou experimental, digite o nome da branch antes de clicar em gerar.
Por que o manifesto é por aplicativo e por branch
Cada branch do Steam (public, beta, experimental, internal, …) recebe seu próprio buildid e suas próprias chaves de descriptografia. O mesmo App ID pode ter meia dúzia de manifestos diferentes, um para cada branch ativa. O script Lua é o que indica ao SteamTools qual branch priorizar quando há mais de uma disponível localmente.
Quando os manifestos ficam desatualizados
Os manifestos são vinculados a uma build específica. No momento em que um jogo recebe uma atualização, o manifesto antigo perde a utilidade — a nova build traz novos blocos de arquivos, novos tamanhos e, muitas vezes, novas chaves. Se você tentar instalar um jogo com um manifesto desatualizado, o SteamTools vai baixar os arquivos errados ou falhar no meio do processo.
Também é por isso que a lista de jogos populares é atualizada a cada cinco minutos: os jogos recebem patches o tempo todo, e o motivo mais provável para quebrar uma configuração que funcionava é usar um manifesto da semana passada.
Quando o gerador não consegue encontrar um manifesto
Três motivos comuns:
- O App ID está errado. O SteamDB é a forma mais rápida de confirmar.
- O aplicativo tem bloqueio regional. Algumas publicadoras restringem manifestos a lojas regionais específicas. No momento usamos
cc=us&l=english; estamos adicionando mais regiões no roadmap. - O aplicativo foi removido do Steam por completo. A Valve ocasionalmente aposenta um app e remove os dados dos seus depots. O App ID ainda é resolvido, mas não há nada para baixar.
Se o gerador retornar um erro, a mensagem normalmente indica em qual desses três casos você caiu. A página de FAQ tem um checklist para as mensagens de erro mais comuns.
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.