Skip to main content
Retour au blog

Comprendre les fichiers manifeste Steam et Lua

Ce que contiennent les fichiers .manifest et Lua, pourquoi SteamTools en a besoin et comment un générateur gratuit crée la paire depuis un App ID.

17 août 2026SteamTools Team
Comprendre les fichiers manifeste Steam et Lua

Un fichier .manifest est l'un des éléments les moins documentés de l'écosystème Steam. Il ne fait pas partie du client Steam officiel, il n'est pas téléchargé directement avec le jeu, et vous ne le verrez jamais dans l'interface de Steam. Pourtant, pour SteamTools, il est indispensable. Voici l'essentiel de ce qui se trouve réellement à l'intérieur.

Ce que fait un fichier manifeste

Un manifeste est un petit fichier texte (généralement de 1 à 4 Ko) qui répertorie chaque dépôt composant un jeu sur Steam, ainsi que la clé chiffrée dont SteamTools a besoin pour dialoguer avec le CDN de Steam pour ce dépôt.

Voici un exemple réel (extrait) pour une application à dépôt unique :

"appbuild"
{
  "appid"  "400"
  "name"   "Portal"
  "buildid"  "1234567"
  "depots"
  {
    "400"
    {
      "manifest"  "1234567890abcdef..."
      "size"  "9876543210"
    }
  }
}

La longue chaîne hexadécimale est la clé de déchiffrement du dépôt. Sans elle, SteamTools n'a aucun moyen de savoir quels fragments du jeu demander, et le CDN de Steam refuse la requête.

Pourquoi le nom du fichier est important

SteamTools recherche des fichiers nommés exactement <AppID>_<branch>.manifest dans son dossier depotcache. Si vous renommez un manifeste fonctionnel de 400_public.manifest en 400-beta.manifest et que vous le placez dans le mauvais dossier de branche, SteamTools refusera l'installation — le nom sert directement d'index.

C'est pourquoi notre générateur renvoie toujours une paire incluant la branche dans le nom de fichier. Si vous n'avez besoin que de la branche public par défaut, laissez le champ tel quel ; si vous voulez précisément beta ou experimental, saisissez le nom de la branche avant de cliquer sur Générer.

Pourquoi le manifeste est propre à chaque application et à chaque branche

Chaque branche Steam (public, beta, experimental, internal, …) possède son propre buildid et ses propres clés de déchiffrement. Un même App ID peut donc avoir une demi-douzaine de manifestes différents, un par branche active. Le script Lua est justement ce qui indique à SteamTools quelle branche privilégier lorsque plusieurs sont présentes localement.

Quand les manifestes deviennent obsolètes

Les manifestes sont liés à un build spécifique. Dès qu'un jeu reçoit une mise à jour, l'ancien manifeste devient inutilisable — le nouveau build comporte de nouveaux fragments de fichiers, de nouvelles tailles et (souvent) de nouvelles clés. Si vous essayez d'installer un jeu avec un manifeste obsolète, SteamTools téléchargera soit les mauvais fichiers, soit échouera en cours de route.

C'est aussi la raison pour laquelle la liste des jeux populaires est actualisée toutes les cinq minutes : les jeux reçoivent des correctifs en permanence, et la cause la plus fréquente d'une configuration qui ne fonctionne plus est l'utilisation d'un manifeste datant d'une semaine.

Quand le générateur ne trouve pas de manifeste

Trois raisons courantes :

  1. L'App ID est erroné. SteamDB est le moyen le plus rapide de vérifier.
  2. L'application est restreinte à une région. Certains éditeurs limitent l'accès aux manifestes à des boutiques régionales précises. Pour l'instant, nous utilisons cc=us&l=english ; nous ajoutons d'autres régions sur la feuille de route.
  3. L'application a été entièrement retirée de Steam. Valve retire parfois une application et supprime les données de ses dépôts. L'App ID continue d'être résolu, mais il n'y a plus rien à télécharger.

Si le générateur renvoie une erreur, le message indique généralement lequel de ces trois cas vous rencontrez. La page FAQ propose une liste de contrôle pour les messages d'erreur les plus fréquents.


Source des données : ManifestHub3 — le cache open source de clés de dépôt Steam sous licence MIT sur lequel ce générateur s'appuie. Auditez-le, forkez-le ou hébergez votre propre miroir.

Essayer le générateur →