Skip to main content
Voltar ao blog

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.

17 de ago. de 2026SteamTools Team
Arquivos de manifesto Steam e Lua explicados

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:

  1. O App ID está errado. O SteamDB é a forma mais rápida de confirmar.
  2. 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.
  3. 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.

Experimente o gerador →