Solucionar errores del generador SteamTools (manifest y Lua)
Guía para los cuatro errores más frecuentes del generador SteamTools —App ID inválido, archivos faltantes o ZIP vacío— y la solución que resuelve la mayoría.
El generador es una capa ligera sobre las API públicas de Steam, por lo que los errores que devuelve suelen ser una traducción directa de los errores de origen. Aquí tienes la lista resumida de lo que es más probable que veas, qué significa realmente cada mensaje y qué hacer en cada caso.
1. "A valid numeric App ID is required"
Es el error más frecuente con diferencia («se requiere un App ID numérico válido»). Suele deberse a tres motivos:
- Escribiste un nombre en el campo en lugar de un número y pulsaste Generar antes de que la lista desplegable pudiera resolver el juego. El menú se cierra al perder el foco y se envía un App ID vacío.
- El App ID que escribiste contiene un error tipográfico (una letra, un cero inicial o un espacio).
- El campo está vacío: el formulario permite enviar una consulta vacía si pulsas Enter muy rápido.
Solución: escribe o pega únicamente los dígitos. Sin letras, sin ceros a la izquierda y sin espacios.
2. "App <id> was not found in the Steam store"
El App ID que introdujiste tiene un formato válido, pero el endpoint appdetails de Steam no devolvió ningún registro («la aplicación <id> no se encontró en la tienda de Steam»). Casi siempre significa una de estas tres cosas:
- El ID está equivocado por uno o dos dígitos. SteamDB es la forma más rápida de comprobarlo.
- El ID corresponde a una aplicación que solo está disponible en una región distinta de
cc=us. Algunos títulos están restringidos a una única tienda regional. Estamos añadiendo más regiones; por ahora, prueba ese mismo ID en la URL de la tienda regional desde tu navegador para confirmar que la aplicación existe. - El ID pertenece a una aplicación que ha sido retirada por completo de Steam. SteamDB conserva el registro, pero
appdetailsdeja de devolverla.
Solución: confirma el ID en SteamDB. Si aparece allí pero el generador sigue rechazándolo, déjanos un mensaje en Discord y añadiremos la región que falta.
3. "Steam search failed (429)"
Hemos alcanzado el límite de peticiones (429) de Steam. El generador aplica un intervalo mínimo de 300 ms por IP para las búsquedas y de 1,5 s para generar archivos, y los propios servidores de Steam también imponen límites de frecuencia. Si ves este error, lo mejor es esperar unos segundos y volver a intentarlo: el límite es por IP, no por cuenta, y se restablece rápidamente.
Solución: espera entre 5 y 10 segundos y vuelve a intentarlo. Si estás automatizando llamadas contra la API mediante scripts, consulta las cabeceras de límite de peticiones en Discord para implementar un retroceso (backoff) adecuado.
4. "App ID is too long"
Pegaste un texto con más de 10 dígitos («el App ID es demasiado largo»). Los App ID de Steam son enteros sin signo de 32 bits, por lo que el máximo teórico es 4.294.967.295, aunque en la práctica ningún ID real supera los 7 dígitos y la mayoría tiene entre 4 y 6. Si aparece "too long", probablemente pegaste un fragmento de URL o un trozo de un JSON de SteamDB en lugar de un ID.
Solución: copia únicamente el ID, no la URL completa ni el JSON.
La solución que arregla la mayoría de los casos
Alrededor del 80 % de todas las consultas de soporte que recibimos se resumen en: «el App ID que escribiste es incorrecto, el ID real es X». La causa más habitual es copiar el número equivocado desde una página de SteamDB. SteamDB muestra cuatro identificadores distintos en cada ficha: el App ID, el package ID, el depot ID y el build ID. El que necesitas es el App ID; los otros tres corresponden a elementos diferentes.
Si alguna vez dudas de qué número es cuál, la cabecera de la página en SteamDB siempre enlaza a la URL canónica de la tienda (store.steampowered.com/app/<APPID>/...): ese es el número que debes usar.
Si tu mensaje de error no aparece en esta lista
El generador funciona sobre una ruta de servidor de TanStack Start y devuelve el mensaje completo del error en el cuerpo de la respuesta con el formato { "code": -1, "message": "..." }. Si ves un mensaje que no está en la lista anterior, copia la cadena completa y publícala en Discord; normalmente tardamos menos de una hora en diagnosticarlo.
Fuente de datos: ManifestHub3 — la caché de código abierto con licencia MIT de claves de depot de Steam sobre la que funciona este generador. Audítala, haz un fork o monta tu propio mirror.