Publica un juego en el marketplace
Un juego del marketplace es un juego que construyes una vez y cualquiera puede incrustar: publicas un repo público de GitHub, la plataforma lo indexa, y los usuarios lo alcanzan por su id de juego sin involucrarte a ti. Este es el extremo opuesto a un juego a medida, que solo tú puedes usar y que alojas tú mismo. Esta sección es la guía detallada de construir-y-publicar para el camino del marketplace.
Si solo quieres un juego para tus propias claves de sitio, quieres desarrollo de juegos a medida en su lugar. Ven aquí cuando quieras distribuir un juego a cada usuario de Caputchin.
El pipeline entero
Cada caja mapea a una página en esta sección:
| Pieza | Qué es | Página |
|---|---|---|
| El juego | Un bundle JS autocontenido construido contra el game SDK que corre en el iframe en sandbox del widget. | Construye un juego del marketplace, referencia del SDK |
| El manifiesto | Un caputchin.json en la raíz del repo que describe el juego, sus presets, y su bundle. | El manifiesto caputchin.json |
| El contrato de repetición | Un run(seed, trace) -> verdict determinista que el servidor vuelve a correr para llegar a la decisión autoritativa. | El contrato de repetición |
| El engine kit | Un kit de autoría opcional que produce un run conforme a partir de un reducer simple. | El engine-kit |
| Publicar | Etiqueta el repo, el indexador lo descubre y lo fija, opcionalmente automatiza con CI. | Publica en el marketplace |
Reproducible vs no reproducible
La idea más importante de este camino: un juego del marketplace puede ejercer de gate de la verificación solo si es reproducible en el servidor. Cuando el indexador ingiere tu juego corre una autocomprobación de repetición: carga tu artefacto run headless en un isolate sellado y confirma que produce un veredicto válido.
- La autocomprobación pasa → el juego es reproducible: la ronda de un jugador real se vuelve a correr en el servidor para llegar a la decisión, así que el juego puede ejercer de gate de una clave de sitio.
- La autocomprobación falla → el juego muestra No reproducible. Sigue listado y sigue incrustable, pero solo como UX (no un gate de seguridad) hasta que publiques una versión que pase. Los sitios que ya están en una versión reproducible anterior siguen corriendo esa instantánea exacta.
Por esto el determinismo no es un pulido opcional: es la línea entre un juego que puede proteger una clave de sitio y uno que es meramente decorativo.
En qué difiere un juego del marketplace de un juego a medida
| Juego del marketplace | Juego a medida | |
|---|---|---|
| Quién puede incrustarlo | Cualquiera, por id de juego | Solo tú |
| Alojamiento | Fijado por la plataforma desde tu GitHub / npm | Tú alojas el bundle (game-src) |
| Esquema de personalización | Declarado en caputchin.json | Declarado en el dashboard |
| Artefacto de repetición | Indexado del run del manifiesto | Subido en el dashboard |
| Descubrimiento | Marketplace navegable | Ninguno |
Por dónde empezar
Si nunca has construido un juego de Caputchin, lee Construye un juego del marketplace de arriba abajo, luego El contrato de repetición. Cuando estés listo para publicar, sigue Publica en el marketplace. El engine kit es opcional y se puede saltar por completo.
Véase también
- Construye un juego del marketplace: el tutorial de build.
- El contrato de repetición: qué hace reproducible un juego.
- Publica en el marketplace: etiqueta, indexa, automatiza.
- Desarrollo de juegos a medida: la alternativa autoalojada y solo-para-tus-claves.