Skip to main content

​
Builds

Una build es una versión empaquetada del juego publicada en una rama específica. Launcher Forge almacena el manifiesto, los hashes de archivos, los metadatos de la release, el ejecutable principal y los artefactos necesarios para que el launcher pueda instalar o actualizar el juego.
Las builds se publican mediante la CLI interactiva de Launcher Forge. El dashboard se utiliza para revisar ramas, versiones, changelogs, almacenamiento y comparaciones.

​
Modelo de publicación

​
Tipos de release

Es una base completa de publicación.Launcher Forge sube la build empaquetada completa, incluyendo archivos que pueden existir en versiones anteriores.Utiliza STABLE para:
  • La primera versión publicada.
  • Una nueva base completa.
  • Cambios importantes en el empaquetado.
  • Reconstruir el estado completo de la rama.
El tipo de release describe el propósito y el comportamiento de subida. No reemplaza la rama. Cada build se publica en una rama seleccionada, como main, beta o una rama privada.

​
Comparación de tipos

​
Antes de publicar

Confirma lo siguiente:
  • El juego existe en el Catálogo.
  • La ficha del juego está publicada.
  • La validación launcher-juego está configurada.
  • La rama de destino existe.
  • La build empaquetada funciona correctamente.
  • La carpeta contiene todos los archivos de ejecución.
  • El ejecutable correcto está incluido.
  • El número de versión no fue utilizado en la rama.
  • El workspace tiene almacenamiento suficiente.

Publicar mediante la CLI interactiva

Revisa el flujo completo de la CLI antes de subir tu primera versión.

​
1. Selecciona el tipo de release

Durante el flujo interactivo, ingresa el número de versión y selecciona STABLE, PATCH o HOTFIX.
Launcher Forge CLI mostrando STABLE, PATCH y HOTFIX

Selecciona la versión y el tipo de release

Se recomienda utilizar versionamiento semántico:
Ejemplos:
Utiliza un número nuevo para cada publicación dentro de la rama seleccionada.

​
2. Añade el changelog

La CLI solicita notas opcionales para la release. El changelog debe explicar los cambios visibles incluidos en la versión. Ejemplo:
Un changelog útil debe ser específico, fácil de revisar, escrito para jugadores o testers y coherente con los archivos incluidos. No incluyas contraseñas, tokens, URLs privadas, credenciales internas ni datos sensibles de depuración.

​
3. Selecciona la carpeta empaquetada

Selecciona la carpeta raíz del juego compilado. Ejemplo:
No selecciones la carpeta del proyecto del motor, el código fuente, la caché del editor ni archivos temporales.
No modifiques, renombres ni muevas la carpeta mientras la CLI genera el manifiesto o sube los archivos.

​
4. Manifiesto y hashes

Launcher Forge escanea la carpeta y genera un manifiesto. El manifiesto registra:
  • Ruta relativa.
  • Tamaño.
  • Hash SHA-256.
  • Cantidad total de archivos.
  • Cantidad de hashes únicos.
  • Ejecutables detectados.
Los hashes permiten identificar archivos nuevos, modificados, sin cambios o eliminados entre versiones.

​
5. Selecciona el ejecutable principal

Después de generar el manifiesto, la CLI muestra los ejecutables detectados. Launcher Forge puede marcar uno como Recommended. Selecciona el ejecutable que inicia el juego real.
Launcher Forge CLI mostrando el manifiesto y el ejecutable principal

Revisa el manifiesto y selecciona el ejecutable principal

Seleccionar el ejecutable incorrecto puede permitir que la build se descargue e instale, pero impedir que el juego se inicie.
El ejecutable seleccionado queda asociado con la versión y será utilizado por el launcher.

​
6. Sube la build

Después de confirmar, Launcher Forge sube los artefactos necesarios. En una release STABLE, la CLI indica que se subirá el conjunto completo de archivos.
Launcher Forge CLI subiendo archivos de una build STABLE

Sube los archivos del juego empaquetado

Mantén abierta la CLI y una conexión estable hasta terminar.

​
7. Confirma la publicación

Cuando termina correctamente, la CLI confirma:
  • Número de versión.
  • Tipo de release.
  • Rama de destino.
  • Ejecutable principal.
  • Creación de la build.
  • Subida exitosa.
Launcher Forge CLI confirmando una build publicada correctamente

Confirma la build publicada correctamente

Presiona Enter para volver al menú.

​
Revisar builds en el dashboard

Abre Branches y selecciona el juego. El resumen muestra:
  • Cantidad de ramas.
  • Total de builds.
  • Uso de almacenamiento.
  • Última versión.
  • Historial de cada rama.
Resumen de ramas mostrando builds, almacenamiento y última versión

Revisa builds, almacenamiento y última versión

​
Historial de versiones

Cada rama muestra sus versiones publicadas.
Historial de builds con versión, tipo, changelog y acciones

Revisa el historial y las acciones disponibles

La tabla puede incluir: La versión más reciente se marca con LATEST. Las versiones elegibles también pueden mostrar una acción Default en la interfaz actual.

​
Editar una build

La acción Edit modifica solamente el changelog o las release notes. No reemplaza:
  • Archivos.
  • Manifiesto.
  • Hashes.
  • Número de versión.
  • Tipo.
  • Rama.
  • Ejecutable principal.
Para cambiar el contenido, publica una nueva versión mediante la CLI.
No edites el changelog para afirmar que existe un archivo o corrección que no fue incluido en la build.

​
Comparar versiones

Selecciona Compare desde una versión. Elige una versión anterior como build base y compárala con la build actual. Launcher Forge compara los manifiestos y agrupa los archivos en:
Comparación de builds mostrando archivos Added, Modified y Deleted

Revisa diferencias de archivos entre versiones

Los resultados pueden mostrar:
  • Ruta relativa.
  • Tamaño.
  • Hash SHA-256.
  • Descarga individual, cuando esté disponible.
Esto permite confirmar el contenido de un patch, detectar cambios inesperados, verificar archivos eliminados e investigar actualizaciones demasiado grandes.

​
Ejemplo de comparación

Una cantidad alta de archivos añadidos puede ser normal al comparar builds completas muy diferentes.

​
Historial y actualizaciones del launcher

Cuando se publica una versión más nueva en la rama utilizada por el jugador:
  1. El launcher consulta la información de la rama.
  2. Detecta la nueva versión.
  3. Compara el estado instalado con el manifiesto publicado.
  4. Descarga los archivos necesarios.
  5. Elimina archivos obsoletos cuando la transición lo requiere.
  6. Actualiza el juego instalado.
  7. Inicia el juego mediante el ejecutable principal configurado.
Los archivos transferidos dependen de los manifiestos, hashes, tipo de release y versión instalada.

​
Uso de almacenamiento

Los artefactos de builds consumen almacenamiento del workspace. El resumen muestra:
  • Almacenamiento utilizado.
  • Capacidad total del plan.
  • Porcentaje de uso.
  • Espacio restante.
Cuando se alcanza el límite, la CLI puede rechazar la subida hasta liberar espacio o aumentar la capacidad.

​
Publicaciones fallidas

Una build puede fallar por motivos como:
  • Sesión de CLI inválida o vencida.
  • Falta de permisos.
  • Número de versión duplicado.
  • Carpeta empaquetada inválida.
  • Ningún ejecutable detectado.
  • Límite de almacenamiento.
  • Interrupción de red.
  • Archivos modificados durante el escaneo o subida.
  • Respuesta inesperada del backend.
Corrige la causa y vuelve a publicar. Una subida incompleta no debe considerarse una versión válida.

​
Estrategia recomendada

Elige la rama según quién debe recibir la versión. Elige el tipo según el propósito y el comportamiento de subida.

​
Lista de verificación

Antes de considerar una build lista, confirma:
  • Seleccionaste el juego correcto.
  • Seleccionaste la rama correcta.
  • El número de versión es único.
  • El tipo coincide con la actualización.
  • El changelog es correcto.
  • La carpeta contiene el runtime completo.
  • El ejecutable principal es correcto.
  • La CLI terminó correctamente.
  • La versión aparece en el historial.
  • El tamaño es razonable.
  • La comparación muestra los cambios esperados.
  • El launcher puede descargar, actualizar e iniciar el juego.
Una build está lista cuando aparece en la rama correcta, su manifiesto está completo, el ejecutable es válido y el launcher puede instalarla e iniciarla correctamente.

​
Guías relacionadas

Ramas

Crea canales públicos y privados y administra sus accesos.

Publicar una build

Sigue el flujo completo de publicación mediante la CLI.

Probar tu launcher

Verifica adquisición, descarga, instalación, actualizaciones e inicio.