Questions fréquemment posées

Le bloc sur la page d'accueil répond aux six questions les plus posées. Cette page est la version la plus longue : les questions qui reviennent plusieurs fois par mois, les cas extrêmes, les choses qui déroutent les gens même après avoir utilisé le générateur plusieurs fois. Si votre question ne se trouve pas ici, le Discord est le chemin le plus rapide vers une vraie réponse.

Qu'est-ce que SteamTools.games, en une phrase ?

Un utilitaire gratuit basé sur un navigateur qui produit le manifeste et la paire Lua SteamTools doit débloquer un jeu de App ID. Il s'agit d'une fine couche sur les API publics de Steam et ne modifie aucun fichier de jeu sur votre machine.

Ce site est-il affilié à SteamTools, SteamDB ou Valve ?

Non. Le site est exploité par des membres de la communauté et est indépendant. Le nom Steam, le nom SteamTools et le nom SteamDB sont la propriété de leurs propriétaires respectifs et sont utilisés ici à des fins descriptives uniquement.

Pourquoi le site existe-t-il alors que SteamTools dispose déjà d'un générateur ?

Le générateur officiel SteamTools est hébergé sur un domaine tiers qui a rencontré des problèmes de fiabilité au fil des ans. SteamTools.games a été créé comme une alternative plus résiliente. Les deux produisent des fichiers équivalents ; ce site se veut plus rapide, plus disponible et plus transparent sur son fonctionnement.

Comment trouver le App ID pour un jeu que je possède ?

Trois méthodes fiables, dans l'ordre :

1. Depuis l'URL du magasin : ouvrez la page du magasin du jeu, copiez le numéro entre /app/ et le prochain /. Par exemple, https://store.steampowered.com/app/400/Portal/ -> 400.
2. From SteamDB: search for the game, look at the canonical store URL at the top of the SteamDB app page, copy the number there.
3. From your local Steam install: every installed game has a file appmanifest_<APPID>.acf in the steamapps. Le numéro dans le nom du fichier est le App ID.

Il y a une procédure complète sur une page séparée.

Pourquoi le générateur renvoie-t-il « Application introuvable dans la boutique Steam » ?

Quatre causes courantes, par ordre de fréquence :

1. Mauvais numéro. Le plus souvent, il s'agit d'un ID de package, d'un ID de dépôt ou d'un ID de build, et non d'un App ID. Confirmez le numéro par rapport au magasin canonique URL.
2. Application verrouillée par région. Le générateur interroge actuellement cc=us. Si l’application n’est vendue que dans une région spécifique, la recherche revient vide.
3. Application supprimée. SteamDB conserve l'enregistrement, mais appdetails ne le renvoie plus. SteamTools ne peut pas fonctionner sur les applications supprimées.
4. Fypo. Un zéro non significatif, un espace final ou un séparateur de milliers provoqueront tous cette erreur.

Pourquoi le générateur renvoie-t-il une erreur 429 ?

Le générateur impose un minimum de 1,5 seconde entre les appels POST /api/generate par IP. Si vous envoyez des requêtes plus rapidement que cela, vous recevrez un 429 avec un en-tête Retry-After. Les propres limites de débit en amont de Steam. Si vous voyez cela, attendez 5 à 10 secondes et réessayez.

Si vous créez un script sur le API, le bon modèle est une interruption exponentielle avec une limite à 10 secondes. Il n'y a pas de « clé API » ni de niveau élevé : chaque client bénéficie de la même limite de débit.

Le service est-il sûr ? Stockez-vous mes données ?

Le service ne nécessite pas de compte, ne définit pas de cookies de suivi et n'écrit pas votre historique de recherche sur le disque. Les seules données qu'il traite à court terme sont la chaîne de recherche et le App ID que vous confirmez, et qui ne sont utilisées que pour une seule requête. Les journaux du serveur sont alternés tous les 14 jours. La Politique de confidentialité contient tous les détails.

Pourquoi le fichier s'appelle-t-il *.lua et que contient-il ?

Le fichier Lua est un court script qui indique à SteamTools quels dépôts charger pour cette application. Il contient deux lignes : une pour enregistrer le App ID et sa clé de déchiffrement du dépôt, et une pour pointer SteamTools vers la version spécifique du dépôt. La répartition complète se trouve sur la page des fichiers manifestes.

Puis-je créer un script pour le API ?

Oui. Les deux points finaux sont :

• GET /api/search?query=<name-or-appid> — renvoie jusqu'à 5 correspondances sous la forme JSON.
• POST /api/generate avec un corps JSON de { "appId": "<id>", "branch": "<optional>" } — renvoie le manifeste URL, le Lua URL, le nom et l'image du jeu validés, ainsi qu'une courte liste d'instructions.

Les deux sont soumis à la limite de débit par IP (300 ms pour la recherche, 1,5 s pour la génération). Il n'y a pas de clé API, pas de quota d'utilisation et pas de plafond par IP au-delà de la limite de débit. Veuillez ne pas créer de script pour le service à un rythme supérieur à 1 requête toutes les 1,5 secondes.

Puis-je intégrer le générateur dans mon propre site ?

Le point de terminaison est un JSON API public et sans authentification. Vous pouvez l'utiliser depuis votre propre interface tant que vous respectez la limite de débit. Le site n'a pas de politique CORS documentée au-delà des valeurs par défaut ; si vous rencontrez des problèmes CORS, déposez une note dans le Discord.

À quoi sert réellement la bande « Récent » sur la page d'accueil ?

Il lit à partir d'une seule clé localStorage (steamtools.recent.v1) et restitue les App ID les plus récents que vous avez générés au cours des 30 derniers jours. Rien n'est envoyé à un serveur. Vous pouvez l'effacer à tout moment depuis les paramètres des données du site de votre navigateur.

J'ai trouvé un bug / le générateur se trompe sur une application. Que dois-je faire?

Le chemin le plus rapide est le Discord. Supprimez le App ID, le URL que vous avez utilisé et ce que vous attendiez, et un modérateur l'acheminera à la bonne personne. La plupart des problèmes sont résolus en une heure.

Existe-t-il un moyen de soutenir le projet ?

Il n'y a pas de page de dons, pas de Patreon, pas de merchandising. Le site est financé de sa poche par un petit groupe de membres de la communauté et reste délibérément petit afin que le coût reste minime. Si vous souhaitez soutenir le projet, le plus utile est de signaler les bugs dans le Discord et de faire connaître le site aux autres utilisateurs de SteamTools.

Pourquoi certaines applications manquent-elles dans la section « Jeux populaires » ?

La section Jeux populaires est organisée par un petit groupe de modérateurs et mise à jour mensuellement. Si un jeu qui, selon vous, devrait être présent, ne l'est pas, envoyez un message au Discord et il sera probablement ajouté lors de la prochaine actualisation.

Que se passe-t-il si le service tombe en panne ?

Un avis sera affiché sur le blog et une bannière sera d'abord placée sur la page d'accueil. Si le service est indisponible pendant une période prolongée, un message épinglé dans Discord indiquera une alternative fonctionnelle.

Le service est suffisamment petit pour qu'un seul responsable puisse le redéployer en une dizaine de minutes sur un nouveau VPS, des pannes prolongées sont donc peu probables. De brefs incidents se produisent, principalement lorsque le API de Steam lui-même passe une mauvaise journée ; ceux-ci se résolvent d’eux-mêmes.

Voir aussi

• Qu'est-ce qu'un fichier manifeste Steam et comment l'utiliser avec SteamTools ? — le guide complet de la porte d'entrée ; cette page est une plongée plus profonde dans une partie de celui-ci.