Corriger les erreurs du générateur SteamTools (manifeste & Lua)
Checklist des quatre erreurs les plus fréquentes du générateur SteamTools — App ID invalide, fichiers manquants, ZIP vide — et la solution clé.
Le générateur est une couche légère au-dessus des API publiques de Steam ; les erreurs qu'il renvoie sont donc généralement une traduction directe des erreurs en amont. Voici la liste concise de ce que vous risquez de rencontrer, ce que cela signifie réellement et comment réagir dans chaque cas.
1. « A valid numeric App ID is required »
Cette erreur (« Un App ID numérique valide est requis ») est de loin la plus fréquente. Trois choses la provoquent généralement :
- Vous avez tapé un nom dans le champ au lieu d'un numéro, puis cliqué sur Générer avant que la liste déroulante ait eu le temps de résoudre le jeu. La liste se ferme à la perte de focus et un App ID vide est envoyé.
- L'App ID saisi comporte une faute de frappe (une lettre, un zéro initial, un espace).
- Le champ est vide — le formulaire autorise un envoi vide si vous appuyez très vite sur Entrée.
Solution : saisissez ou collez uniquement des chiffres. Aucune lettre, aucun zéro au début, aucun espace.
2. « App <id> was not found in the Steam store »
Cette erreur (« L'application <id> est introuvable dans le magasin Steam ») indique que l'App ID saisi est bien formé, mais que le point de terminaison appdetails de Steam n'a renvoyé aucun enregistrement. Cela signifie presque toujours l'une de ces trois choses :
- L'identifiant est erroné d'un chiffre ou deux. SteamDB est le moyen le plus rapide de vérifier.
- L'identifiant correspond à une application disponible uniquement dans une autre région que
cc=us. Certaines applications sont restreintes à une seule boutique régionale. Nous ajoutons progressivement d'autres régions ; en attendant, essayez le même identifiant avec l'URL régionale de la boutique dans votre navigateur pour confirmer que l'application existe. - L'identifiant correspond à une application entièrement retirée de Steam. SteamDB conserve sa fiche, mais
appdetailsne la renvoie plus.
Solution : vérifiez l'identifiant sur SteamDB. S'il y figure mais que le générateur continue de le rejeter, laissez un message sur Discord et nous ajouterons la région manquante.
3. « Steam search failed (429) »
Nous avons atteint la limite de débit de Steam. Le générateur applique un intervalle minimum de 300 ms par IP pour la recherche et de 1,5 s pour la génération, et les serveurs de Steam appliquent également leurs propres limites en amont. Si vous voyez ce message (« Échec de la recherche Steam (429) »), le bon réflexe est d'attendre quelques secondes puis de réessayer — la limite s'applique par IP, et non par compte, et se réinitialise rapidement.
Solution : attendez 5 à 10 secondes et réessayez. Si vous automatisez des appels vers l'API, passez sur Discord pour connaître les en-têtes de limitation de débit afin de mettre en place un délai d'attente adapté.
4. « App ID is too long »
Ce message (« L'App ID est trop long ») apparaît lorsque vous avez collé une valeur de plus de 10 chiffres. Les Steam App ID sont des entiers non signés sur 32 bits, le maximum théorique est donc 4 294 967 295 — mais en pratique, aucune application réelle ne dépasse 7 chiffres, et la plupart en comptent 4 à 6. Si vous voyez « too long », vous avez probablement collé un fragment d'URL ou un extrait de JSON SteamDB au lieu d'un simple identifiant.
Solution : copiez uniquement l'identifiant lui-même, pas l'URL ni le JSON.
La solution qui règle la majorité des problèmes
Environ 80 % de tous les messages de support que nous recevons se résument à : « l'App ID que vous avez tapé est incorrect, le véritable ID est X ». La cause la plus fréquente consiste à copier le mauvais numéro sur une page SteamDB. SteamDB affiche quatre identifiants sur chaque page d'application : l'App ID, le package ID, le depot ID et le build ID. C'est l'App ID qu'il vous faut. Les trois autres désignent tout autre chose.
Si vous avez le moindre doute sur le bon numéro, l'en-tête de la page sur SteamDB renvoie toujours vers l'URL canonique du magasin (store.steampowered.com/app/<APPID>/...) — c'est celui-ci qu'il faut utiliser.
Si votre message d'erreur ne figure pas dans cette liste
Le générateur est une route serveur TanStack Start ; le message d'erreur complet est renvoyé dans le corps de la réponse sous la forme { "code": -1, "message": "..." }. Si vous voyez un message absent de la liste ci-dessus, copiez la chaîne complète et postez-la sur Discord — le diagnostic prend généralement moins d'une heure.
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.