Preguntas frecuentes

El bloque de la página de inicio responde a las seis preguntas más frecuentes. Esta página es la versión más larga: las preguntas que surgen varias veces al mes, los casos extremos, las cosas que confunden a las personas incluso después de haber usado el generador varias veces. Si su pregunta no está aquí, Discord es el camino más rápido hacia una respuesta real.

¿Qué es SteamTools.games, en una frase?

Una utilidad gratuita basada en navegador que produce el manifiesto y el par Lua SteamTools necesita desbloquear un juego por App ID. Es una capa delgada sobre los API públicos de Steam y no modifica ningún archivo de juego en tu máquina.

¿Este sitio está afiliado a SteamTools, SteamDB o Valve?

No. El sitio es operado por miembros de la comunidad y es independiente. El nombre Steam, el nombre SteamTools y el nombre SteamDB son propiedad de sus respectivos dueños y se utilizan aquí únicamente con fines descriptivos.

¿Por qué existe el sitio cuando SteamTools ya tiene un generador?

El generador oficial SteamTools está alojado en un dominio de terceros que ha tenido problemas de confiabilidad a lo largo de los años. SteamTools.games se creó como una alternativa más resiliente. Ambos producen archivos equivalentes; Este sitio pretende ser más rápido, más disponible y más transparente sobre su funcionamiento.

¿Cómo encuentro el App ID para un juego que tengo?

Tres formas confiables, en orden:

1. Desde la URL de la tienda: abre la página de la tienda del juego, copia el número entre /app/ y el siguiente /. Por ejemplo, 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. El número en el nombre del archivo es App ID.

Hay un tutorial completo en una página separada.

¿Por qué el generador devuelve "Aplicación no encontrada en la tienda Steam"?

Cuatro causas comunes, en orden de frecuencia:

1. Número incorrecto. La mayoría de las veces se trata de un ID de paquete, un ID de depósito o un ID de compilación, no un App ID. Confirme el número con la tienda canónica URL.
2. Aplicación bloqueada por región. El generador actualmente consulta cc=us. Si la aplicación solo se vende en una región específica, la búsqueda aparece vacía.
3. Aplicación eliminada de la lista. SteamDB mantiene el registro, pero appdetails ya no lo devuelve. SteamTools no puede funcionar en aplicaciones eliminadas de la lista.
4. Error tipográfico. Un cero al principio, un espacio al final o un separador de miles causarán este error.

¿Por qué el generador devuelve un error 429?

El generador impone un mínimo de 1,5 segundos entre llamadas POST /api/generate por IP. Si envía solicitudes más rápido que eso, recibirá un 429 con un encabezado Retry-After. El propio upstream de Steam también tiene límites de velocidad. Si ve esto, espere entre 5 y 10 segundos y vuelva a intentarlo.

Si está escribiendo un script contra el API, el patrón correcto es un retroceso exponencial con un límite de 10 segundos. No existe una "clave API" ni un nivel elevado: todos los clientes obtienen el mismo límite de tarifa.

¿Es seguro el servicio? ¿Almacenáis mis datos?

El servicio no requiere una cuenta, no establece cookies de seguimiento y no escribe su historial de búsqueda en el disco. Los únicos datos que procesa a corto plazo son la cadena de búsqueda y el App ID que usted confirma, y ​​que se utilizan para una sola solicitud. Los registros del servidor se rotan cada 14 días. La Política de Privacidad tiene todos los detalles.

¿Por qué el archivo se llama *.lua y qué contiene?

El archivo Lua es un script breve que le indica a SteamTools qué depósitos cargar para esta aplicación. Contiene dos líneas: una para registrar el App ID y su clave de descifrado del depósito, y otra para señalar a SteamTools la compilación específica del depósito. El desglose completo se encuentra en la página de archivos de manifiesto.

¿Puedo programar el API?

Sí. Los dos puntos finales son:

• GET /api/search?query=<name-or-appid>: devuelve hasta 5 coincidencias como JSON.
• POST /api/generate con un cuerpo JSON de { "appId": "<id>", "branch": "<optional>" }: devuelve el manifiesto URL, Lua URL, el nombre y la imagen del juego validados y una breve lista de instrucciones.

Ambos están sujetos al límite de velocidad por IP (300 ms para búsqueda, 1,5 s para generación). No hay clave API, ni cuota de uso ni límite por IP más allá del límite de velocidad. No programe el servicio a una velocidad superior a 1 solicitud cada 1,5 segundos.

¿Puedo integrar el generador en mi propio sitio?

El punto final es un JSON público y sin autenticación API. Puedes usarlo desde tu propia interfaz siempre que respetes el límite de tarifa. El sitio no tiene una política CORS documentada más allá de las predeterminadas; Si tiene problemas con CORS, envíe una nota en Discord.

¿Qué hace realmente la tira "Recientes" de la página de inicio?

Lee desde una única clave de almacenamiento local (steamtools.recent.v1) y representa los App ID más recientes que haya generado en los últimos 30 días. No se envía nada a un servidor. Puede borrarlo en cualquier momento desde la configuración de datos del sitio de su navegador.

Encontré un error/el generador está equivocado en una aplicación. ¿Qué debo hacer?

La ruta más rápida es la Discord. Deje caer el App ID, el URL que utilizó y lo que esperaba que sucediera, y un moderador lo dirigirá a la persona adecuada. La mayoría de los problemas se solucionan en una hora.

¿Hay alguna manera de apoyar el proyecto?

No hay página de donaciones, ni Patreon, ni merchandising. El sitio es financiado de su bolsillo por un pequeño grupo de miembros de la comunidad y se mantiene deliberadamente pequeño para que el costo siga siendo trivial. Si quieres apoyar el proyecto, lo más útil es reportar errores en el Discord e informar a otros usuarios de SteamTools sobre el sitio.

¿Por qué faltan algunas aplicaciones en la sección "Juegos populares"?

La sección de Juegos populares está seleccionada por un pequeño grupo de moderadores y se actualiza mensualmente. Si un juego que crees que debería estar ahí no está, envía un mensaje a Discord y probablemente se agregará en la próxima actualización.

¿Qué pasa si el servicio se cae?

Aparecerá un aviso en el blog y primero aparecerá un banner en la página de inicio. Si el servicio no funciona durante un período prolongado, un mensaje fijado en Discord señalará una alternativa que funciona.

El servicio es lo suficientemente pequeño como para que un único mantenedor pueda volver a implementarlo en unos diez minutos en un VPS nuevo, por lo que es poco probable que se produzcan interrupciones prolongadas. Ocurren breves interrupciones, sobre todo cuando el propio API de Steam está teniendo un mal día; esos se resuelven por sí solos.

Ver también

• ¿Qué es un archivo de manifiesto Steam y cómo se usa con SteamTools?: la guía completa de acceso directo; Esta página es una inmersión más profunda en una parte de ella.