Guía de integración para desarrolladores

Lleva tu juego a Combos, tanto si trabajas en un estudio como si lo creaste con Codex, Claude Code o Cursor. El recorrido es preparar una versión para navegador → probarla localmente → subirla con Combos CLI → jugar en línea → actualizarla.

Elige una ruta

¿Ya tienes una versión Web? Lee Antes de empezar y Publicar y actualizar.
¿Necesitas generarla? Sigue H5, Unity o Roblox y después publica.
Para seguir un proyecto real, consulta los tres ejemplos completos, con capturas, código y resultados documentados.
Si algo falla, revisa Solución de problemas.

Versiones y alcance

La guía original se revisó el 2026-10-08 con Combos CLI v1.14.2, usando macOS 15.3, Node.js 25.7.0 y Unity 6.3 LTS 6000.3.25f1. Los resultados corresponden a esas ejecuciones. Las rutas, ajustes y parches de cada ejemplo no son requisitos universales. Subida completada, versión publicada y juego realmente jugable se comprueban por separado.

Antes de empezar

Combos aloja juegos que funcionan en el navegador. Sube un sitio estático completo, normalmente en dist. La carpeta puede tener otro nombre: indica su ruta real. La herramienta de creación no cambia el formato final.

Prepara la salida adecuada

Proyecto	Qué preparar
H5 terminado	`index.html` y todos los archivos referenciados
HTML + JavaScript	HTML, JS, CSS y recursos; sin compilación
Vite / Webpack	Salida estática del comando de compilación del proyecto
Unity	Exportación WebGL nativa completa
Roblox	Recursos y mecánicas adaptados o reimplementados en un motor Web

Instalar Combos CLI no exige Node.js, un plugin Unity ni SDK. Vite necesita su entorno Node.js; Unity, el módulo oficial Web Build Support.

Ubica tus archivos


my-game/
├── source/
├── dist/
│   ├── index.html
│   └── assets/
├── cover.png
└── combos.json

La raíz contiene el código editable. ./dist es relativo al directorio actual de la terminal. Conserva cover.png y el combos.json generado en la raíz. Este último vincula el proyecto con el juego publicado; no es código fuente.

Abre el proyecto completo y su terminal en Codex, o usa la terminal del sistema. Sustituye la ruta entre comillas y consérvalas si hay espacios. Comprueba que aparecen dist y cover.png; si faltan, prepáralos antes.


cd "/path/to/project"
pwd
ls


Set-Location "C:\path\to\project"
Get-Location
Get-ChildItem

Entornos locales y en la nube

Codex y Cursor crean archivos en el espacio seleccionado. Antes de publicar, pide al agente la ruta completa, el comando de compilación, la carpeta de salida, la dirección de vista previa y una comprobación de la mecánica principal.

En la nube puedes compilar y subir donde esté instalado el CLI, o descargar el proyecto y trabajar localmente. Su 127.0.0.1 no es tu computadora: usa la vista previa de la herramienta o inicia un servidor local tras descargar. La vista previa local depende del servidor; el enlace Combos funciona por su cuenta.

Cómo leer los ejemplos

Ejecuta los comandos en el entorno y directorio indicados. Cambia rutas, títulos, portadas y dispositivos por los tuyos. El commit y parche BoatAttack y las coordenadas Ball Game pertenecen solo a esos ejemplos. Los fragmentos Lua/JavaScript explican el código; no son comandos de terminal ni conversores universales.

Publicar y actualizar

1. Instala e inicia sesión

Pide al agente instalar Combos CLI y su skill según las instrucciones oficiales , comprobar la instalación y guiarte al iniciar sesión. También puedes empezar en la página del CLI .


combos --version
combos account status
combos account login

Usa combos account login solo si no hay sesión y complétala en el navegador. Comprueba versión y cuenta antes de subir. combos update --check busca actualizaciones; combos update las instala.

2. Prepara la versión y la portada

Coloca index.html en la raíz de la salida completa y prepara cover.png con una captura real. HTML/JS puede ser ya la versión final. Para Vite, Webpack o Unity, sube los archivos generados, sin node_modules, Library ni todo el proyecto de desarrollo. Excluye credenciales, secretos del servidor y combos.json de la salida del navegador.

Límites: total descomprimido ≤ 200 MiB, cada archivo ≤ 100 MiB y un máximo de 2.000 archivos. No hay un límite de producto adicional para ZIP; el ZIP documentado de BoatAttack tenía 124,88 MiB.

El juego se aloja en una subruta. Usa direcciones locales relativas, como ./assets/game.js; en Vite, base: './'. Unity ya genera Build/... y StreamingAssets/... como rutas relativas. Conserva las URL HTTPS externas; evita reemplazos indiscriminados en la salida validada del motor.

3. Prueba la salida exacta

Con Python instalado, ejecuta el comando apropiado desde la raíz y deja el servidor abierto. Visita http://127.0.0.1:8000/.


python3 -m http.server 8000 --bind 127.0.0.1 --directory dist


py -m http.server 8000 --bind 127.0.0.1 --directory dist

También sirven preview de Vite o Build And Run de Unity. Prueba la carpeta que subirás, no solo el servidor de desarrollo. No abras el HTML Unity con file://. Comprueba inicio, movimiento/acción principal, final y reinicio. Revisa Console/Network por errores o recursos ausentes. Pide al agente servir la misma salida desde una subruta, corregir problemas y recompilar antes de subir.

4. Crea tu juego

Sustituye título y rutas. Elige pc, mobile o pc,mobile, y landscape o portrait, según lo que hayas verificado.


combos post create --dir ./dist --title "My Game" --cover ./cover.png --platform pc --screen-orientation landscape
combos post get

La primera creación exige portada; una nueva compilación exige --platform. Los parámetros de dispositivo y orientación no agregan controles táctiles ni cambian el diseño. El CLI devuelve enlace, código de búsqueda Canvas, Post y resultado, y crea combos.json en la raíz.

El CLI comprime automáticamente. Para un ZIP manual, comprime todo el contenido de dist, con index.html en la raíz al extraer. En macOS/Linux con zip:


cd dist
zip -r ../game-dist.zip .
cd ..

En Windows, selecciona todos los archivos y carpetas dentro de dist y comprímelos.

5. Comprueba el enlace público

Detén la vista previa con Ctrl+C, abre el enlace devuelto y vuelve a jugar. Busca el código Canvas de cinco dígitos conservando ceros iniciales. Revisa status, revision y submission_is_current. Si el envío aún no es la versión actual, sigue la respuesta real y verifica la versión pública.


short_url: https://share.combos.game/p/0875954
game_code: 08759
status: POST_STATUS_PUBLISHED
revision: 2
submission_is_current: true

6. Actualiza el mismo juego

Conserva tu combos.json, modifica el código, genera la salida y repite las pruebas locales antes de actualizar:


combos post update --dir ./dist --platform pc --screen-orientation landscape
combos post get

Confirma la nueva revisión y prueba el mismo enlace en línea. No crees otro Post con cada cambio. Si partes del código de otra persona, crea primero tu propio juego. Título y portada pueden actualizarse como metadatos; un nuevo dist sigue exigiendo platform.

Encarga el proceso a un agente

Localiza el proyecto y comprueba la sesión del CLI. Genera una salida estática completa con rutas relativas. Inicia la vista previa, informa su dirección y verifica la mecánica principal. Prepara una portada real. Crea mi primer juego o actualiza el vinculado a mi propio combos.json, indicando dispositivos y orientación realmente compatibles. Detén el servidor local, juega desde Combos y devuelve enlace, código Canvas, revisión y resultado. En Unity usa WebGL nativo, sin plugin Combos Editor.

Fuente: Guía de integración de Combos , revisada el 2026-10-08 con CLI v1.14.2. Los resultados corresponden a las pruebas documentadas en la guía original.