Skip to main content

Qu'est-ce qu'un fichier manifeste Steam et comment l'utiliser avec SteamTools ?

Le guide complet des fichiers manifestes Steam, le script de déverrouillage Lua correspondant et le flux de travail en quatre étapes pour intégrer un jeu dans SteamTools. Conçu comme la porte d'entrée pour les nouveaux utilisateurs ; des plongées approfondies en direct sur les pages liées.

Dernière mise à jour: 2026-07-05

Si vous avez déjà recherché « comment utiliser SteamTools » ou « qu'est-ce qu'un manifeste Steam » et avez fini par lire cinq Discord différents et trois numéros GitHub, cette page est pour vous. C'est la porte d'entrée vers le reste du site. Il répond aux deux questions que tout le monde pose en premier, renvoie aux pages approfondies pour tout le reste et vous laisse avec un fichier de travail sur votre disque à la fin de la section qui compte.

La réponse en 30 secondes

Un fichier manifeste Steam est un petit fichier texte au format "ACF" de Valve qui indique au client de bureau SteamTools quels dépôts d'un jeu Steam télécharger et comment les vérifier. Un fichier manifeste est toujours associé à un petit script Lua qui indique à SteamTools quelle branche préférer et comment s'authentifier auprès des serveurs de Steam. Ensemble, les deux fichiers permettent à SteamTools d'installer un jeu pour jouer hors ligne sans passer par le client officiel Steam.

Vous pouvez générer une paire manifeste + Lua pour n'importe quel Steam App ID sur la page d'accueil. Le reste de ce guide explique ce que sont les fichiers, comment ils fonctionnent, où les placer et que faire en cas de panne.

Qu'est-ce qu'un fichier manifeste Steam ?

Un fichier manifeste est un fichier texte nommé appmanifest_<APPID>.acf. Cela ressemble à ceci pour 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"
    }
}

La forme est fixée par Valve. Les champs intéressants sont appid (quel jeu), installdir (où SteamTools doit placer les fichiers), buildid (quelle version du jeu) et le bloc InstalledDepots (quels identifiants de dépôt à télécharger et les identifiants manifestes qui les déverrouillent). Tous les autres domaines sont la comptabilité que SteamTools ignore pour la plupart.

Si vous voulez une répartition complète champ par champ - ce que fait réellement StateFlags, pourquoi LastOwner ressemble à un numéro à 17 chiffres et comment les ID de manifeste dans le bloc InstalledDepots se rapportent au CDN de Steam - l'analyse approfondie se trouve sur la page [fichiers manifestes expliqués] (/manifest-files). La version courte : si appid, installdir, buildid et InstalledDepots sont corrects, SteamTools installera le jeu. Tout le reste est des métadonnées.

A quoi sert le fichier Lua ?

Le fichier Lua est le partenaire du manifeste. Il s'agit d'un petit script (généralement 10 à 30 lignes) qui indique trois choses à SteamTools :

  1. Quelle branche préférer. Les jeux Steam ont plusieurs branches : public, beta, ptb, experimental, staging. Le fichier Lua indique à SteamTools pour lequel le manifeste a été généré. Si vous ne spécifiez pas de branche, le générateur est par défaut public.
  2. Comment s'authentifier auprès du CDN de Steam. Le script demande à SteamTools de signer le manifeste auprès des serveurs de contenu public de Steam et de confirmer que les ID de dépôt dans le manifeste correspondent à une version réelle téléchargeable.
  3. Que faire des données du dépôt après le téléchargement. Certains jeux nécessitent une petite étape post-installation (décompresser une archive, déplacer un fichier au bon endroit, définir une configuration). Le fichier Lua peut inclure cette étape.

Le fichier Lua n'est pas facultatif. SteamTools refusera d'installer un jeu si le manifeste est présent mais que le fichier Lua est manquant. Les deux fichiers proviennent toujours par paire de ce générateur.

Le flux de travail de bout en bout – ce que fait réellement le fichier Lua, ce que signifie chaque ligne et ce qui se passe lorsqu'un script Lua renvoie une erreur – se trouve sur la page comment ça marche. La page contient également un organigramme en quatre étapes que vous pouvez suivre.

Comment les deux fichiers fonctionnent ensemble

Le modèle mental est le suivant : le manifeste indique quoi installer, le Lua indique comment l'installer. SteamTools lit d'abord le manifeste pour savoir quels dépôts et quelle version récupérer. Ensuite, il exécute le script Lua pour savoir quelle branche, quel chemin d'authentification et quelles étapes de post-installation appliquer. Si l'un des fichiers est manquant, SteamTools se retire plus tôt et écrit une ligne dans son répertoire de journaux expliquant ce qui manquait.

Les deux fichiers sont également verrouillés en version l'un par rapport à l'autre. Un manifeste généré pour la branche public ne fonctionnera pas avec un script Lua généré pour la branche beta, et vice versa. Le générateur renvoie toujours les deux fichiers sous forme de paire correspondante ; ne mélangez pas et ne faites pas correspondre des fichiers provenant de différentes sources.

Pas à pas : de AppID au jeu installé

Le flux de travail complet prend environ trois minutes une fois que vous avez votre AppID. La version condensée :

  1. Recherchez le App ID. Il s'agit du numéro dans l'URL du magasin Steam — par exemple, le portail est https://store.steampowered.com/app/400/, so the App ID is 400. Si vous ne le trouvez pas dans l'URL, la page comment trouver un Steam App ID propose trois méthodes fiables.
  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. Générer. Appuyez sur le bouton. Le générateur interroge le cache ManifestHub3 en amont et renvoie un ZIP contenant les fichiers .acf et .lua. La réponse est généralement inférieure à 1,5 seconde.
  4. Place the files. Drop the .acf file into <SteamTools>/depotcache/ and the .lua à côté du binaire SteamTools. Redémarrez SteamTools. Le jeu apparaît dans votre bibliothèque.

La procédure pas à pas détaillée – y compris où se trouve <SteamTools> sur Windows, macOS et Linux, que faire si SteamTools ne voit pas les fichiers et comment lire le journal SteamTools – se trouve sur la page [comment ça marche] (/comment-ça-fonctionne).

Comment trouver un Steam App ID

Trois méthodes fiables, par ordre de fréquence d'efficacité :

  1. À partir de l'URL de la boutique Steam. Ouvrez la page de la boutique du jeu. Le numéro entre /app/ et le prochain / est le App ID. Exemple : https://store.steampowered.com/app/400/Portal/ → 400.
  2. Depuis SteamDB. Recherchez le jeu sur steamdb.info. L'URL canonique du magasin en haut de la page contient le 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 dans ce répertoire. Le numéro dans le nom de fichier est le App ID.

Le guide complet – comprenant comment trouver le App ID pour les jeux supprimés, les DLC, les bandes sonores et les applications non répertoriées mais publiées – se trouve sur la page comment trouver un Steam App ID.

Problèmes courants et correctifs

Les cinq choses qui ne vont pas le plus souvent, par ordre de fréquence :

1. Le ZIP téléchargé est vide. Généralement l'une des trois choses suivantes. Soit le AppID est dans le catalogue Steam mais pas encore dans le cache ManifestHub3 (la page devrait afficher un avis « pas encore dans notre base de données de téléchargement » avec un lien Discord), le client SteamTools filtre le fichier (vérifiez le répertoire des journaux), ou un outil de sécurité local supprime la réponse. Si aucun de ceux-ci ne vous convient, [ouvrez un problème] (https://discord.com/invite/FDKpJu5zgT) avec le App ID et une copie du ZIP.

2. SteamTools ne voit pas les fichiers une fois que je les ai déposés. La cause la plus courante est un mauvais dossier. Sur Windows, le chemin est <SteamTools>\depotcache\ pour le .acf et <SteamTools>\ pour le .lua. Sur macOS et Linux, les chemins sont analogues. Redémarrez SteamTools après la copie ; il ne recharge pas à chaud.

3. Erreur « Application introuvable dans le magasin Steam ». Le numéro est généralement un ID de package, un ID de dépôt ou un ID de build, et non un App ID. Confirmez par rapport au magasin canonique URL. Les jeux supprimés dont les AppID ne se résolvent plus en /appdetails ne peuvent pas du tout être générés.

4. Erreur « 429 rate limit ». Le générateur impose un intervalle de 1,5 seconde entre les appels par IP. Si vous créez un script, une interruption exponentielle avec une limite de 10 secondes est le bon modèle. Il n’existe pas de clé API ni de niveau élevé.

5. Le script Lua renvoie une erreur au lancement. Soit le fichier est corrompu (retélécharger), soit il a été généré pour une branche différente de celle du manifeste. Utilisez toujours la paire correspondante issue d’un seul appel générateur.

Pour toute la longue traîne de problèmes — incompatibilités de branches, verrous régionaux, interactions anti-triche, cas extrêmes avec proton, que faire lorsqu'une build est supprimée de la liste entre la génération du manifeste et le redémarrage de SteamTools — la FAQ contient 20 entrées couvrant la longue traîne de « J'ai essayé X, que dois-je faire maintenant ?

SteamTools par rapport aux alternatives

Les questions « vs » les plus courantes, brièvement :

  • SteamTools contre le client officiel Steam. SteamTools est un fork Steam non officiel et open source maintenu par [BeyondDimension] (https://github.com/BeyondDimension). Il n'est ni distribué ni approuvé par Valve. Il étend le client officiel avec une gestion de bibliothèque hors ligne, une commutation multi-compte et la possibilité d'appliquer un manifeste publié par la communauté + les déverrouillages Lua. Ce site (SteamTools.games) est un générateur indépendant qui produit la paire manifeste + Lua que SteamTools consomme — ce n'est pas un fork ni un client.
  • Watt Toolkit vs Steam++ vs SteamTools. Il s'agit du même projet à différents moments. SteamTools était le nom original ; la communauté de langue chinoise l'appelait Steam++ ; il a ensuite été renommé Watt Toolkit. Les trois noms font référence au même client de bureau sur github.com/BeyondDimension/SteamTools.
  • SteamTools vs GreenLuma. GreenLuma est un projet communautaire distinct avec un format manifeste + Lua différent. Les deux écosystèmes ne sont pas interchangeables. SteamTools.games produit des fichiers spécifiquement pour le client SteamTools ; si vous êtes un utilisateur du GreenLuma, ce générateur n'est pas le bon outil pour vous.
  • SteamTools en 2026. Pour les nouveaux utilisateurs, SteamTools + ce générateur est le chemin le plus léger. L'autre écosystème (GreenLuma et un petit nombre de déverrouillages payants) n'est pas recommandé aux nouveaux utilisateurs ; les outils sont moins entretenus, moins documentés et présentent un risque de malware plus élevé.

La comparaison complète, y compris pourquoi certains déverrouillages payants semblent fonctionner mais ne devraient pas être fiables, se trouve sur la page FAQ.

Pour les développeurs

Le générateur expose un REST public API à /api/search (recherche un AppID à partir d'un nom de jeu) et /api/generate (produit la paire manifeste + Lua). Les deux ne sont pas authentifiés, les deux sont soumis à une limite de débit par IP et les deux sont documentés sur la [page des développeurs] (/developers). Une spécification OpenAPI 3.1 est téléchargeable à partir de la même page.

Si vous intégrez SteamTools dans une automatisation plus grande, le bon modèle est :

  • Utilisez /api/search pour résoudre un nom de jeu saisi par l'utilisateur en App ID.
  • Utilisez /api/generate avec ce App ID et un paramètre de branche.
  • Respectez la limite de débit de 1,5 seconde. Interruption exponentielle avec un plafond de 10 secondes.
  • Cachez le résultat. Les paires Manifest + Lua sont versionnées selon l'ID de build en amont ; ils n'ont pas besoin d'être récupérés à moins que le cache en amont ne change.

Pour la génération par lots de plus de 50 titres à la fois, le chemin le plus rapide consiste à demander dans le Discord et à demander aux responsables de les ajouter à ManifestHub3 en une seule fois, ce que reflète la liste des « Jeux populaires » organisée sur la page d'accueil.

L'ensemble complet des pages associées

Si vous souhaitez lire une page supplémentaire, choisissez parmi celles-ci en fonction de vos besoins :

  • À propos de SteamTools.games — qu'est-ce que ce site, qui le gère, ce qu'il n'est pas. Lisez ceci si vous voulez savoir qui se cache derrière le générateur.
  • Comment ça marche — le flux complet en quatre étapes avec le diagramme, le visuel en quatre étapes et une analyse approfondie de ce que fait le script Lua ligne par ligne. Lisez ceci si vous souhaitez comprendre le flux de travail avant de le faire.
  • Fichiers manifestes expliqués — chaque champ du fichier appmanifest_*.acf, ce qu'il fait et pourquoi SteamTools a besoin de chacun d'eux. Lisez ceci si vous souhaitez lire votre manifeste à la main.
  • Comment trouver un Steam App ID — trois méthodes fiables, plus les cas extrêmes (supprimés, DLC, bandes sonores). Lisez ceci si vous avez un jeu mais pas de App ID.
  • FAQ — 20 questions à longue traîne couvrant la question « J'ai essayé X, que dois-je faire maintenant ? » surface. Lisez ceci quand quelque chose se brise.
  • Citation — la carte d'identité canonique et lisible par machine de ce site. Lisez ceci si vous citez SteamTools.games dans un document de recherche ou une réponse d'IA.
  • Développeurs — la documentation API, la spécification OpenAPI et les détails de la limite de débit. Lisez ceci si vous écrivez un script.
  • Changelog — ce qui a changé et quand. Lisez ceci si vous souhaitez savoir si une mise à jour récente du site affecte votre flux de travail.
  • Blog — guides, analyses approfondies et notes de produits. Lisez ceci si vous souhaitez approfondir un sujet spécifique.

Contexte : qu'est-ce que SteamTools ?

SteamTools (également appelé Watt Toolkit, anciennement appelé Steam++) est un fork open source Steam maintenu par l'[équipe SteamTools] (https://github.com/BeyondDimension). Ce n'est pas un plugin pour le client officiel Steam — c'est un fork complet qui remplace le binaire Steam sur votre machine. Il fonctionne sur Windows, macOS et Linux.

SteamTools étend le client officiel Steam de trois manières importantes pour ce guide :

  1. Gestion de bibliothèque hors ligne. SteamTools peut maintenir une bibliothèque Steam hors ligne entièrement fonctionnelle, y compris les jeux auxquels vous avez déjà commencé à jouer en ligne. Lorsque les serveurs Steam sont inaccessibles, SteamTools revient à sa copie locale des données du dépôt ainsi qu'aux fichiers manifeste + Lua que vous avez placés dans son répertoire de configuration.
  2. Commutation multi-comptes. SteamTools peut exécuter plusieurs comptes Steam en parallèle sur la même machine, avec des dépôts isolés et des données de sauvegarde isolées. Le client officiel Steam ne prend pas en charge cela.
  3. Déverrouillages publiés par la communauté. Il s'agit de la partie qui nécessite les fichiers manifeste + Lua. SteamTools lit un fichier manifeste à partir de son répertoire depotcache, exécute le script Lua pour s'authentifier auprès des serveurs de contenu public de Steam et télécharge les données du dépôt dans un dossier que le client officiel Steam pourra ensuite utiliser comme « serveur de contenu local ». Les paires manifeste publié par la communauté + Lua (et le cache de données qui les sauvegarde) sont ce que fournit le projet en amont ManifestHub3.

Si vous souhaitez un article plus long sur ce qu'est SteamTools, qui le gère, comment il se rapporte à Steam++ et Watt Toolkit, et où se situent les limites entre ce générateur et le client de bureau, la page à propos a la définition complète de l'entité.

Malentendus courants

Quelques éléments qui reviennent assez souvent pour anticiper :

"Un ​​fichier manifeste est un crack ou un hack." Il s'agit d'un fichier de configuration. Les données vers lesquelles il pointe se trouvent déjà sur le CDN public de Steam ; le manifeste est une recette qui indique à SteamTools quels dépôts récupérer et comment les vérifier. Le manifeste lui-même ne contient aucun contenu protégé par le droit d'auteur.

"Si j'ai un manifeste, je peux obtenir n'importe quel jeu gratuitement." Non. Un manifeste ne fonctionne que pour les jeux que vous avez légitimement achetés sur Steam. Le mode hors ligne de SteamTools nécessite que les données du dépôt sous-jacent soient celles que vous avez déjà payées ; le manifeste est un indicateur et ne remplace pas l’achat.

"SteamTools et ce site sont le même projet." Ce n'est pas le cas. SteamTools est le client de bureau, géré par BeyondDimension sur github.com/BeyondDimension. Ce site est un générateur indépendant, maintenu par l'équipe SteamTools.games, qui produit l'un des intrants consommés par SteamTools. Les deux projets partagent un nom et un objectif mais ont des bases de code distinctes, des responsables distincts et des cadences de publication distinctes.

"Si un jeu n'est pas dans le cache en amont, je devrais abandonner." Non : la page vous le dira explicitement et créera un lien vers le Discord pour le demander. Les titres les plus populaires se retrouvent dans le cache quelques jours après leur demande ; les titres de niche peuvent prendre un cycle de sortie. Le message "pas encore dans le cache" est le bon signal, pas une impasse.

"Je peux utiliser un manifeste GreenLuma avec SteamTools." Non, les formats sont différents. Les deux écosystèmes ne sont pas interchangeables. Un manifeste GreenLuma ne se chargera pas dans SteamTools et un manifeste SteamTools ne se chargera pas dans GreenLuma.

Quand NE PAS utiliser ce générateur

Le générateur est le bon outil lorsque vous souhaitez utiliser SteamTools pour installer un jeu que vous possédez déjà pour jouer hors ligne. Ce n'est pas le bon outil lorsque :

  • Vous n'avez pas acheté le jeu. Le manifeste décrit uniquement comment récupérer les données du dépôt ; cela ne contourne pas l’achat. Il n’existe pas de « manifeste gratuit » : les manifestes décrivent un contenu déjà acheté.
  • Vous utilisez GreenLuma, Goldberg ou un autre client non-SteamTools. Ces écosystèmes ont leurs propres formats de manifeste. Les fichiers produits par ce générateur sont spécifiques à SteamTools.
  • Vous souhaitez jouer en ligne. Le mode hors ligne de SteamTools est destiné au jeu hors ligne. Le jeu en ligne passe normalement par le client officiel Steam ; Le rôle de SteamTools est simplement la commutation multi-comptes.
  • Le jeu est supprimé de la liste et le App ID ne se résout plus. Le point de terminaison /appdetails de Steam est la source de vérité ; si le App ID ne renvoie rien, le générateur ne peut pas aider. SteamDB conserve un enregistrement, mais les données réelles du dépôt ne sont plus récupérables à partir de Steam.

Glossaire

Une courte référence pour les termes utilisés dans ce guide et les pages liées.

App ID. Un numéro de 6 à 8 chiffres qui identifie de manière unique une application Steam. Il s'agit du numéro dans le magasin Steam URL après /app/. Exemple : 400 pour Portal.

Branche. Les jeux Steam peuvent avoir plusieurs branches de construction — public est la valeur par défaut et ce que vous souhaitez habituellement ; beta, ptb, experimental et staging sont des alternatives courantes. Le fichier Lua indique à SteamTools pour quelle branche le manifeste a été généré.

Build ID. Un numéro de 6 à 10 chiffres qui identifie une version spécifique d'un jeu. Le manifeste inclut l’ID de build ; SteamTools télécharge les données du dépôt exactement pour cette version.

Dépôt. Une unité de contenu téléchargeable dans une application Steam. Un jeu typique comporte 1 à 5 dépôts (le jeu principal, l'OST, les packs de langue, etc.). Le manifeste nomme chaque dépôt et l'ID du manifeste qui le déverrouille.

ID du manifeste. Un numéro à 19 chiffres qui identifie une version spécifique d'un dépôt spécifique. Le bloc InstalledDepots dans le manifeste mappe les ID de dépôt aux ID de manifeste.

ManifestHub3. Le cache communautaire open source sous licence MIT de paires manifeste + Lua. Le générateur lit à partir de ManifestHub3. Les données sont vérifiables, exploitables et ne dépendent pas de ce site.

SteamTools. Le client de bureau. Maintenu par l'équipe SteamTools sur github.com/BeyondDimension. Distinct de ce site.

SteamTools.games. Ce site. Un générateur mince qui produit la paire manifeste + Lua consommée par SteamTools. Non affilié à l'équipe SteamTools.

Watt Toolkit. Nom chinois actuel du client SteamTools. Le projet s'appelait auparavant Steam++.

ACF. Format "Fichier de configuration d'application" de Valve. Un format de texte clé-valeur avec des en-têtes de section, similaire à INI. Les manifestes utilisent ACF.

Voyez-le en action

Le workflow manifest + Lua fonctionne pour tous les jeux du catalogue Steam. Pour voir à quoi ressemble un fichier généré, l'index des jeux populaires sur la page d'accueil contient des AppID bien connus prêts à être générés. Parmi les plus demandés :

Si votre jeu ne figure pas dans cette liste, recherchez-le sur la page d'accueil — s'il se trouve dans le catalogue Steam, le générateur renverra un résultat. Si le cache ManifestHub3 amont ne l'a pas encore, la page le dira et vous donnera un lien Discord pour le demander.