¿Qué es un archivo de manifiesto Steam y cómo se utiliza con SteamTools?

Si alguna vez buscó "cómo usar SteamTools" o "qué es un manifiesto de Steam" y terminó leyendo cinco Discord diferentes y tres números de GitHub, esta página es para usted. Es la puerta de entrada al resto del recinto. Responde a las dos preguntas que todo el mundo hace primero, enlaza a las páginas de análisis profundo para todo lo demás y le deja con un archivo de trabajo en su disco al final de la sección que importa.

La respuesta de 30 segundos

Un archivo de manifiesto Steam es un pequeño archivo de texto en formato "ACF" de Valve que le indica al cliente de escritorio SteamTools qué depósitos de un juego Steam descargar y cómo verificarlos. Un archivo de manifiesto siempre se combina con un pequeño script Lua que le indica a SteamTools qué rama preferir y cómo autenticarse en los servidores de Steam. Juntos, los dos archivos permiten a SteamTools instalar un juego para jugar sin conexión sin pasar por el cliente oficial Steam.

Puede generar un par manifiesto + Lua para cualquier Steam App ID en la página de inicio. El resto de esta guía explica qué son los archivos, cómo funcionan, dónde colocarlos y qué hacer cuando algo se rompe.

¿Qué es un archivo de manifiesto Steam?

Un archivo de manifiesto es un archivo de texto llamado appmanifest_<APPID>.acf. Se ve así para 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 forma está fijada por Valve. Los campos interesantes son appid (qué juego), installdir (donde SteamTools debería colocar los archivos), buildid (qué compilación del juego) y el bloque InstalledDepots (qué ID de depósito para descargar y los ID de manifiesto que los desbloquean). Todos los demás campos son la contabilidad que SteamTools ignora en su mayoría.

Si desea el desglose completo campo por campo (qué hace realmente StateFlags, por qué LastOwner parece un número de 17 dígitos y cómo se relacionan los ID del manifiesto en el bloque InstalledDepots con el CDN de Steam), la inmersión profunda se encuentra en la página explicación de archivos de manifiesto. La versión corta: si appid, installdir, buildid y InstalledDepots son correctos, SteamTools instalará el juego. Todo lo demás son metadatos.

¿Para qué sirve el archivo Lua?

El archivo Lua es el socio del manifiesto. Es un pequeño script (normalmente de 10 a 30 líneas) que le dice a SteamTools tres cosas:

1. Qué rama preferir. Los juegos Steam tienen varias ramas: public, beta, ptb, experimental, staging. El archivo Lua le dice a SteamTools para cuál se generó el manifiesto. Si no especifica una rama, el generador predeterminado es public.
2. Cómo autenticarse en la CDN de Steam. El script le pide a SteamTools que firme el manifiesto en los servidores de contenido público de Steam y confirme que los ID de depósito en el manifiesto coinciden con una compilación real descargable.
3. Qué hacer con los datos del depósito después de la descarga. Algunos juegos necesitan un pequeño paso posterior a la instalación (desempaquetar un archivo, mover un archivo al lugar correcto, establecer una configuración). El archivo Lua puede incluir ese paso.

El archivo Lua no es opcional. SteamTools se negará a instalar un juego si el manifiesto está presente pero falta el archivo Lua. Los dos archivos siempre vienen en pareja desde este generador.

El flujo de trabajo de un extremo a otro (qué hace realmente el archivo Lua, qué significa cada línea y qué sucede cuando un script Lua genera un error) se encuentra en la página cómo funciona. La página también tiene un diagrama de flujo de cuatro pasos que puede seguir.

Cómo funcionan juntos los dos archivos

El modelo mental es: el manifiesto dice qué instalar, Lua dice cómo instalarlo. SteamTools lee el manifiesto primero para saber qué depósitos de qué compilación recuperar. Luego ejecuta el script Lua para saber qué rama, qué ruta de autenticación y qué pasos posteriores a la instalación aplicar. Si falta alguno de los archivos, SteamTools sale temprano y escribe una línea en su directorio de registro explicando lo que falta.

Los dos archivos también están bloqueados entre sí. Un manifiesto generado en la rama public no funcionará con un script Lua generado para la rama beta y viceversa. El generador siempre devuelve los dos archivos como un par coincidente; no mezcle ni combine archivos de diferentes fuentes.

Paso a paso: de AppID al juego instalado

El flujo de trabajo completo demora aproximadamente tres minutos una vez que tenga su AppID. La versión condensada:

1. Busque App ID. Es el número en la URL de la tienda Steam; por ejemplo, Portal es https://store.steampowered.com/app/400/, so the App ID is 400. Si no puede encontrarlo en la URL, la página cómo encontrar un Steam App ID tiene tres métodos confiables.
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. Generar. Presione el botón. El generador consulta la caché ascendente ManifestHub3 y devuelve un ZIP que contiene los archivos .acf y .lua. La respuesta suele ser inferior a 1,5 segundos.
4. Place the files. Drop the .acf file into <SteamTools>/depotcache/ and the .lua junto al binario SteamTools. Reinicie SteamTools. El juego aparece en tu biblioteca.

El tutorial detallado, que incluye dónde vive <SteamTools> en Windows, macOS y Linux, qué hacer si SteamTools no ve los archivos y cómo leer el registro de SteamTools, se encuentra en la página cómo funciona.

Cómo encontrar un Steam App ID

Tres métodos confiables, en orden de frecuencia de funcionamiento:

1. Desde la URL de la tienda Steam. Abre la página de la tienda del juego. El número entre /app/ y el siguiente / es el App ID. Ejemplo: https://store.steampowered.com/app/400/Portal/ → 400.
2. De SteamDB. Busca el juego en steamdb.info. La URL de la tienda canónica en la parte superior de la página contiene 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 en ese directorio. El número en el nombre del archivo es App ID.

La guía completa, que incluye cómo encontrar App ID para juegos eliminados de la lista, DLC, bandas sonoras y aplicaciones no enumeradas pero publicadas, se encuentra en la página cómo encontrar un Steam App ID.

Problemas comunes y soluciones

Las cinco cosas que salen mal con más frecuencia, en orden de frecuencia:

1. El ZIP descargado está vacío. Generalmente una de tres cosas. O el AppID está en el catálogo Steam pero aún no en el caché ManifestHub3 (la página debería mostrar un aviso de "aún no está en nuestra base de datos de descarga" con un enlace Discord), el cliente SteamTools está filtrando el archivo (verifique el directorio de registro) o una herramienta de seguridad local está eliminando la respuesta. Si ninguno de ellos encaja, abra una edición con el App ID y una copia del ZIP.

2. SteamTools no ve los archivos después de colocarlos. La causa más común es la carpeta incorrecta. En Windows, la ruta es <SteamTools>\depotcache\ para .acf y <SteamTools>\ para .lua. En macOS y Linux las rutas son análogas. Reinicie SteamTools después de copiar; no se recarga en caliente.

3. Error "Aplicación no encontrada en la tienda Steam". El número suele ser un ID de paquete, un ID de depósito o un ID de compilación, no un App ID. Confirmar con la tienda canónica URL. Los juegos eliminados de la lista cuyos AppID ya no se resuelven en /appdetails no se pueden generar en absoluto.

4. Error de "límite de velocidad 429". El generador impone 1,5 segundos entre llamadas por IP. Si está escribiendo un script, el retroceso exponencial con un límite de 10 segundos es el patrón correcto. No hay una clave API ni un nivel elevado.

5. El script Lua genera un error al iniciarlo. El archivo está dañado (se vuelve a descargar) o se generó para una rama diferente a la del manifiesto. Utilice siempre el par coincidente de una única llamada de generador.

Para conocer la larga lista de problemas (desajustes de ramas, bloqueos regionales, interacciones anti-trampas, casos extremos con protones, qué hacer cuando una compilación se elimina de la lista entre la generación del manifiesto y el reinicio de SteamTools), las Preguntas frecuentes tienen 20 entradas que cubren la larga cola de "Probé X, ¿qué hago ahora?".

SteamTools frente a alternativas

Las preguntas "vs" más comunes, brevemente:

• SteamTools frente al cliente oficial Steam. SteamTools es una bifurcación no oficial de código abierto Steam mantenida por BeyondDimension. No está distribuido ni respaldado por Valve. Amplía el cliente oficial con administración de bibliotecas fuera de línea, cambio de cuentas múltiples y la capacidad de aplicar manifiestos publicados por la comunidad + desbloqueos de Lua. Este sitio (SteamTools.games) es un generador independiente que produce el par manifiesto + Lua que consume SteamTools; no es una bifurcación ni un cliente.
• Watt Toolkit vs Steam++ vs SteamTools. Son el mismo proyecto en diferentes momentos. SteamTools era el nombre original; la comunidad de habla china lo llamó Steam++; Posteriormente pasó a llamarse Watt Toolkit. Los tres nombres hacen referencia al mismo cliente de escritorio en github.com/BeyondDimension/SteamTools.
• SteamTools vs GreenLuma. GreenLuma es un proyecto comunitario independiente con un manifiesto diferente + formato Lua. Los dos ecosistemas no son intercambiables. SteamTools.games produce archivos específicamente para el cliente SteamTools; Si es usuario de GreenLuma, este generador no es la herramienta adecuada para usted.
• SteamTools en 2026. Para nuevos usuarios, SteamTools + este generador es la opción más liviana. El otro ecosistema (GreenLuma y una pequeña cantidad de desbloqueadores pagos) no se recomienda para nuevos usuarios; las herramientas reciben menos mantenimiento, están menos documentadas y tienen un mayor riesgo de malware.

La comparación completa, incluyendo por qué algunos desbloqueadores pagos parecen funcionar pero no se debe confiar en ellos, se encuentra en la página Preguntas frecuentes.

Para desarrolladores

El generador expone un REST público API en /api/search (busque un AppID a partir del nombre de un juego) y /api/generate (produzca el par manifiesto + Lua). Ambos no están autenticados, ambos están sujetos a un límite de velocidad por IP y ambos están documentados en la página de desarrolladores. Se puede descargar una especificación OpenAPI 3.1 desde la misma página.

Si está integrando SteamTools en una automatización más grande, el patrón correcto es:

• Utilice /api/search para resolver el nombre de un juego escrito por el usuario en un App ID.
• Utilice /api/generate con ese App ID y un parámetro de rama.
• Respetar el límite de velocidad de 1,5 segundos. Retroceso exponencial con un límite de 10 segundos.
• Almacenar en caché el resultado. Los pares manifiesto + Lua están versionados según el ID de compilación ascendente; no es necesario volver a recuperarlos a menos que cambie la caché ascendente.

Para la generación por lotes de más de 50 títulos a la vez, la ruta más rápida es preguntar en Discord y hacer que los mantenedores los agreguen a ManifestHub3 de una sola vez, que es lo que refleja la lista seleccionada de "Juegos populares" en la página de inicio.

El conjunto completo de páginas relacionadas.

Si desea leer una página más, elija entre estas según lo que necesite:

• Acerca de SteamTools.games: qué es este sitio, quién lo administra y qué no es. Lee esto si quieres saber quién está detrás del generador.
• Cómo funciona: el flujo completo de cuatro pasos con el diagrama, la imagen de cuatro pasos y la inmersión profunda en lo que hace el script Lua línea por línea. Lea esto si desea comprender el flujo de trabajo antes de hacerlo.
• Explicación de los archivos de manifiesto: cada campo del archivo appmanifest_*.acf, qué hace y por qué SteamTools necesita cada uno. Lea esto si desea leer su manifiesto a mano.
• Cómo encontrar un Steam App ID: tres métodos confiables, además de los casos extremos (eliminados de la lista, DLC, bandas sonoras). Lee esto si tienes un juego pero no tienes App ID.
• Preguntas frecuentes: 20 preguntas largas que cubren "Probé X, ¿qué hago ahora?" superficie. Lea esto cuando algo se rompa.
• Cita: la tarjeta de identidad canónica legible por máquina para este sitio. Lea esto si está citando SteamTools.games en un artículo de investigación o en una respuesta de IA.
• Desarrolladores: la documentación de API, la especificación OpenAPI y los detalles del límite de velocidad. Lea esto si está escribiendo un guión.
• Changelog — qué cambió y cuándo. Lea esto si desea saber si una actualización reciente del sitio afecta su flujo de trabajo.
• Blog: guías, inmersiones profundas y notas de productos. Lee esto si quieres profundizar en un tema específico.

Antecedentes: qué es realmente SteamTools

SteamTools (también llamado Watt Toolkit, anteriormente llamado Steam++) es una bifurcación Steam de código abierto mantenida por el BeyondDimension. No es un complemento para el cliente oficial Steam; es una bifurcación completa que reemplaza el binario Steam en su máquina. Se ejecuta en Windows, macOS y Linux.

SteamTools amplía el cliente oficial Steam de tres formas importantes para esta guía:

1. Administración de biblioteca sin conexión. SteamTools puede mantener una biblioteca Steam sin conexión completamente funcional, incluidos los juegos que ya ha comenzado a jugar en línea. Cuando no se puede acceder a los servidores Steam, SteamTools recurre a su copia local de los datos del depósito más los archivos de manifiesto + Lua que ha colocado en su directorio de configuración.
2. Cambio de cuentas múltiples. SteamTools puede ejecutar múltiples cuentas Steam en paralelo en la misma máquina, con depósitos aislados y datos guardados aislados. El cliente oficial Steam no admite esto.
3. Desbloqueos publicados por la comunidad. Esta es la parte que necesita archivos de manifiesto + Lua. SteamTools lee un archivo de manifiesto desde su directorio depotcache, ejecuta el script Lua para autenticarse en los servidores de contenido públicos de Steam y descarga los datos del depósito en una carpeta que el cliente oficial Steam puede usar más adelante como "servidor de contenido local". Los pares de manifiesto publicado por la comunidad + Lua (y el caché de datos que los respalda) son lo que proporciona el proyecto ascendente ManifestHub3.

Si desea un artículo más extenso sobre qué es SteamTools, quién lo mantiene, cómo se relaciona con Steam++ y Watt Toolkit, y dónde están los límites entre este generador y el cliente de escritorio, la página acerca de tiene la definición completa de la entidad.

Malentendidos comunes

Algunas cosas que surgen con suficiente frecuencia como para prevenir:

"Un ​​archivo de manifiesto es un crack o un hack". Es un archivo de configuración. Los datos a los que apunta ya están en la CDN pública de Steam; el manifiesto es una receta que le indica a SteamTools qué depósitos buscar y cómo verificarlos. El manifiesto en sí no contiene ningún contenido protegido por derechos de autor.

"Si tengo un manifiesto, puedo obtener cualquier juego gratis". No. Un manifiesto solo funciona para juegos que hayas comprado legítimamente en Steam. El modo fuera de línea de SteamTools requiere que los datos del depósito subyacente sean aquellos por los que ya haya pagado; el manifiesto es un indicador, no un sustituto de la compra.

"SteamTools y este sitio son el mismo proyecto." No lo son. SteamTools es el cliente de escritorio, mantenido por BeyondDimension en github.com/BeyondDimension. Este sitio es un generador independiente, mantenido por el equipo SteamTools.games, que produce uno de los insumos que consume SteamTools. Los dos proyectos comparten un nombre y un objetivo, pero tienen bases de código distintas, mantenedores distintos y cadencias de lanzamiento distintas.

"Si un juego no está en el caché ascendente, debería rendirme". No, la página te lo dirá explícitamente y te vinculará al Discord para solicitarlo. Los títulos más populares terminan en el caché a los pocos días de ser solicitados; Los títulos especializados pueden tardar un ciclo de lanzamiento. El mensaje "aún no está en la caché" es la señal correcta, no un callejón sin salida.

"Puedo usar un manifiesto GreenLuma con SteamTools." No, los formatos son diferentes. Los dos ecosistemas no son intercambiables. Un manifiesto GreenLuma no se cargará en SteamTools y un manifiesto SteamTools no se cargará en GreenLuma.

Cuándo NO usar este generador

El generador es la herramienta adecuada cuando quieres utilizar SteamTools para instalar un juego que ya tienes para jugar sin conexión. Es la herramienta equivocada cuando:

• No has comprado el juego. El manifiesto solo describe cómo obtener datos del depósito; no pasa por alto la compra. No existe un "manifiesto gratuito": los manifiestos describen contenido ya comprado.
• Estás utilizando GreenLuma, Goldberg u otro cliente que no sea SteamTools. Esos ecosistemas tienen sus propios formatos de manifiesto. Los archivos que produce este generador son específicos de SteamTools.
• Quieres jugar en línea. El modo sin conexión de SteamTools es para jugar sin conexión. El juego en línea se realiza a través del cliente oficial Steam como de costumbre; La función de SteamTools allí es solo el cambio de cuentas múltiples.
• El juego se elimina de la lista y el App ID ya no se resuelve. El punto final /appdetails de Steam es la fuente de la verdad; Si el App ID no devuelve nada, el generador no puede ayudar. SteamDB mantiene un registro, pero los datos reales del depósito ya no se pueden recuperar de Steam.

Glosario

Una breve referencia de los términos utilizados en esta guía y las páginas vinculadas.

App ID. Un número de 6 a 8 dígitos que identifica de forma única una aplicación Steam. Es el número en la tienda Steam URL después de /app/. Ejemplo: 400 para Portal.

Rama. Los juegos Steam pueden tener múltiples ramas de compilación: public es la predeterminada y la que normalmente deseas; beta, ptb, experimental y staging son alternativas comunes. El archivo Lua le dice a SteamTools para qué rama se generó el manifiesto.

ID de compilación. Un número de 6 a 10 dígitos que identifica una compilación específica de un juego. El manifiesto incluye el ID de compilación; SteamTools descarga los datos del depósito exactamente para esa compilación.

Depósito. Una unidad de contenido descargable dentro de una aplicación Steam. Un juego típico tiene entre 1 y 5 depósitos (el juego principal, el OST, paquetes de idiomas, etc.). El manifiesto nombra cada depósito y el ID del manifiesto que lo desbloquea.

ID de manifiesto. Un número de 19 dígitos que identifica una versión específica de un depósito específico. El bloque InstalledDepots en el manifiesto asigna ID de depósito a ID de manifiesto.

ManifestHub3. El caché comunitario de código abierto y con licencia MIT de pares manifiesto + Lua. El generador lee desde ManifestHub3. Los datos son auditables, bifurcables y no dependen de este sitio.

SteamTools. El cliente de escritorio. Mantenido por BeyondDimension en github.com/BeyondDimension. Distinto de este sitio.

SteamTools.games. Este sitio. Se consume un generador delgado que produce el par manifiesto + Lua SteamTools. No afiliado al equipo SteamTools.

Watt Toolkit. El nombre actual en chino del cliente SteamTools. El proyecto se llamaba anteriormente Steam++.

ACF. Formato "Archivo de configuración de la aplicación" de Valve. Un formato de texto clave-valor con encabezados de sección, similar a INI. Los manifiestos utilizan ACF.

Véalo en acción

El flujo de trabajo manifiesto + Lua funciona para todos los juegos del catálogo Steam. Para ver cómo se ve un archivo generado, el índice de juegos populares en la página de inicio tiene AppID conocidos listos para generar. Algunos de los más solicitados:

• Portal (AppID 400) — el caso de prueba canónico. Manifiesto + Lua en 1,4 segundos, cada vez.
• Counter-Strike 2 (AppID 730) — gran número de depósitos, ejercita la ruta del código de múltiples depósitos.
• Half-Life 2 (AppID 220) — juego antiguo, manifiesto más pequeño, buena base para "cómo se ve un archivo pequeño".
• Terraria (AppID 105600): ejemplo de un juego con una rama beta a la que puedes apuntar.
• Stardew Valley (AppID 413150): ejemplo de un pequeño juego independiente en el que todo el juego cabe en un solo depósito.

Si su juego no está en esa lista, búsquelo en la página de inicio; si está en el catálogo Steam, el generador arrojará un resultado. Si el caché ManifestHub3 ascendente aún no lo tiene, la página lo indicará y le brindará un enlace Discord para solicitarlo.