Green Games / Documentación
Documentación
Todo lo que se puede hacer hoy en Green Games y con Green Games Studio, paso a paso y con capturas de las aplicaciones reales: jugar, crear un juego sin programar y fabricar uno con código.
Versión preliminar: cada guía dice a qué versión corresponde. Lo que todavía no existe está en la hoja de ruta, sin fechas.
Quiero jugar
Jugar
En el navegador, sin instalar nada, o sin conexión con el launcher.
Empezar a jugarQuiero crear sin programar
Crear
Un juego completo con piezas y reglas, en quince minutos, con Green Games Studio.
Tu primer juegoQuiero escribir código
Programar
El paquete, la API del SDK, el validador, el bot de pruebas y la herramienta de consola.
Fabricar con código
Secciones
GG-D15 páginas
Empezar
Cómo es la plataforma, cómo jugar en la web y cómo instalar el launcher Green Games y el editor Green Games Studio.
- Qué es la plataformaLas tres piezas (el portal, el launcher Green Games y el editor Green Games Studio), qué es un juego, qué funciona hoy y qué no existe todavía.
- Jugar en la webCómo jugar en play.green.games desde el navegador, con teclado, pantalla táctil o mando, y dónde quedan tus marcas.
- RequisitosQué necesita tu equipo para jugar en el portal y para usar el launcher y el editor en Windows, Linux y macOS (el editor en Mac todavía no está en el portal).
- Descargar e instalarBajar el launcher y el editor, comprobar que el archivo es el original, abrirlo en Windows o Linux (y el launcher en macOS), actualizar desde una versión anterior y desinstalarlo.
- Primeros pasosLo primero que hacer después de instalar. Jugar una partida en el launcher, abrir el editor y llevar tu juego al launcher.
GG-D27 páginas
Launcher
Instalar juegos, jugar sin conexión, importar archivos .ggx y dónde queda tu progreso.
- BibliotecaVer los juegos, abrir su ficha, instalarlos, jugarlos sin conexión y desinstalarlos en el launcher.
- JugarLa pantalla de inicio de un juego, la dificultad, el modo con bots, la pausa, los mundos abiertos, jugar de a varios en el mismo equipo, el fin de la partida y la pantalla completa.
- ControlesCómo se juega con teclado y ratón, pantalla táctil o mando, los controles de un mundo abierto, cómo se reparte el teclado entre dos personas y cómo manejar sin ratón el launcher y los menús de un juego.
- Importar un .ggxAbrir en el launcher un juego guardado en un archivo .ggx, jugarlo, qué revisa el launcher antes de aceptarlo y qué pasa si lo rechaza.
- Historial y progresoQué anota el launcher de tus partidas, cómo funcionan las mejores marcas, qué guardan los juegos y qué pasa con todo eso al desinstalar.
- AjustesCada ajuste del launcher (idioma, pantalla completa, volumen, nombre) y qué hay dentro de la carpeta de datos.
- Problemas frecuentesQué hacer si el launcher no abre en Windows, Linux o macOS, si el sistema advierte, si un .ggx es rechazado, si falta un mando, si no hay sonido o si no encuentras tu progreso.
GG-D322 páginas
Editor
Green Games Studio: crear juegos sin programar, con escena, reglas, pruebas con bot y exportar.
- Recorrido por el editorLa pantalla de inicio y la ventana del editor 0.4.0 zona por zona, con sus menús, buscadores, paneles, el visor y la barra de estado, más los Ajustes, la cámara, el guardado y el deshacer.
- Modo Simple y modo CompletoQué muestra cada modo del editor 0.4.0, cómo cambiar entre ellos, el tema claro y oscuro, las tres disposiciones ya armadas y cómo acoplar, ocultar y medir los paneles.
- Tu primer juegoTutorial paso a paso con el editor 0.4.0: un patio con monedas, muros, lava y meta, probado con el bot, exportado a .ggx y jugado hasta ganar en el launcher.
- Nuevo juego, proyectos y plantillasEl diálogo Nuevo juego paso a paso, con Reglas o código o Bloques y los siete tipos de juego; las plantillas, qué es un proyecto y qué archivos trae, y cómo abrirlo, duplicarlo, renombrarlo o mandarlo a la papelera.
- Tipos de juegoLos siete tipos que ofrece Nuevo juego en el editor 0.4.0, con su vista, sus controles, lo que trae su plantilla y lo que todavía no se puede editar dentro del editor.
- Escena y DetallesColocar formas, prefabricados y materiales, mover, girar y cambiar el tamaño de las piezas, las vistas y el sombreado del visor, el Esquema con ojo y candado y el panel Detalles de una pieza y de la escena.
- Explorador de contenidoEl panel que reúne prefabricados, materiales, paletas, sonidos, modelos, texturas, láminas, escenas y scripts del editor 0.4.0, con sus filtros, cómo arrastrar un prefabricado al visor y cómo guardar los tuyos.
- Taller de assetsDibujos, texturas, modelos de cubos, animaciones y mapas de baldosas hechos dentro del editor 0.4.0. Cómo se abre cada herramienta, dónde queda lo que creas y cómo se usa en el juego.
- Importar assetsEl importador del editor 0.4.0 convierte modelos, texturas, sonidos, paquetes y escenas hechos con otras herramientas. Formatos y grado, licencia obligatoria, límites, cancelar y deshacer.
- Modelos en la escenaColocar un modelo 3D, elegir su animación, usarlo como jugador, poner texturas y sonidos grabados, y revisar los límites del paquete y los créditos en el editor 0.4.0.
- Reglas sin códigoCómo darle lógica a tu juego eligiendo opciones en el editor 0.4.0, con los ajustes de la Partida, los 10 disparadores, las 23 acciones, los personajes y las reglas en juegos hechos con código.
- Modo BloquesProgramar un juego encajando bloques en el editor 0.4.0, con el código a la vista. Cómo se crea un proyecto de bloques, el lienzo, la paleta, su relación con la escena, pasar a código y lo que todavía no hace.
- CódigoEl editor de código del editor 0.4.0, con la disposición Código, los paneles Estructura y Proyecto, el bloque que escriben las Reglas, el autocompletado de la API y los errores con su botón Llévame.
- Jugar dentro del editorCómo jugar tu juego sin salir del editor 0.4.0, con la franja Jugando, Reiniciar y Detener, el desplegable para jugar aquí o ver al bot, la dificultad y la Consola.
- Bot de pruebaQué comprueba Probar con bot en el editor 0.4.0, cómo arma su ruta desde las reglas, qué sabe hacer y qué no, cómo marcarle pasos y cómo leer el panel cuando la prueba falla.
- Multijugador localCómo hacer con el editor 0.4.0 un juego para varias personas en el mismo equipo, activarlo en la Ficha, probarlo con 2, 3 o 4 jugadores en pantalla dividida, pasarlo por el bot y jugarlo en el launcher.
- Asistente de IAPedir cambios escribiendo en el editor 0.4.0: qué paquetes traen la capa de IA, cómo instalar un modelo en tu equipo, cuánto acierta de verdad y cómo revisar cada propuesta.
- Ficha, exportar y compartirLa Ficha del juego en el editor 0.4.0: tipo de juego, jugadores, dificultades, controles, portada, límites y créditos, y cómo exportar un archivo .ggx, compartirlo y abrirlo en el launcher.
- Tu segundo juego: una sala isométricaTutorial corto con el editor 0.4.0 sobre el ejemplo isométrico: cambiar la vista, sumar monedas y una regla a un juego con código, ver el código que escribe esa regla, exportar y ganarlo en el launcher.
- Tu primer modelo, paso a pasoGuía para el editor 0.4.0. Dibujas una textura de ladrillo, armas un robot de cubos, le das una animación, lo pones en un juego, lo pruebas con el bot y lo exportas.
- Problemas frecuentes del editorCausas y arreglos de los tropiezos más comunes del editor 0.4.0, desde la ventana que no abre y el bot que no termina hasta dónde quedaron tus proyectos al actualizar.
- Qué falta en el editor 0.4.0Lo que el editor 0.4.0 todavía no hace, cómo lo muestra la interfaz y qué puedes hacer mientras tanto, para que no busques un botón que no existe.
GG-D424 páginas
Fabricar juegos con código
El paquete, el manifiesto, las escenas, la API del SDK, el validador, el bot y la herramienta de línea de comandos.
- Estructura de un paqueteQué archivos forman un juego de Green Games, en qué unidades se mide el mundo, cómo transcurre una partida y el camino completo desde la carpeta vacía hasta el archivo .ggx.
- El manifiesto (juego.json)Todas las propiedades de juego.json con un ejemplo real, y las reglas de id, portada, controles, dificultades, tablas de puntajes y textos en dos idiomas.
- EscenasEl archivo escenas/<id>.json completo: piezas, formas, materiales, movimiento automático, apariciones, zonas, luces, ambiente, vistas 2D y 3D, láminas y mapas de baldosas.
- ScriptsCómo es el script de un juego: dónde corre, cómo se importa la API, las ocho reglas, un esqueleto, selectores, textos traducibles, varios jugadores y lo que la API todavía no ofrece.
- Referencia de la APIEl objeto greengames y sus once servicios: qué hace cada uno, en qué versiones está disponible, los tipos comunes y cómo leer las páginas de la referencia.
- Servicio juegoReferencia del servicio juego. La partida: en qué dificultad y escena está, cuándo empieza, qué pasa en cada cuadro y cómo termina.
- Servicio mundoReferencia del servicio mundo. Lo que hay en la escena: piezas, zonas, apariciones, luces y mapas de baldosas, y los eventos de tocar, entrar y chocar.
- Servicio jugadoresReferencia del servicio jugadores. Quiénes están en la sala, humanos y bots: su posición, sus habilidades, sus acciones, su vista y su estado.
- Servicio interfazReferencia del servicio interfaz. Lo que ve cada jugador sobre el juego: HUD, mensajes, cronómetros, marcador, menús y rótulos en el mundo.
- Servicio sonidoReferencia del servicio sonido. Sonidos sintetizados: predefinidos, tonos, ruido y secuencias de notas.
- Servicio progresoReferencia del servicio progreso. Lo que se guarda de cada jugador entre una partida y la siguiente, por juego.
- Servicio puntajesReferencia del servicio puntajes. Las tablas de mejores marcas que el juego declara en su manifiesto.
- Servicio azarReferencia del servicio azar. Números y elecciones al azar que salen de la semilla de la partida, para que la partida se pueda repetir igual.
- Servicio relojReferencia del servicio reloj. El tiempo de la partida y los temporizadores.
- Servicio actoresReferencia del servicio actores. Personajes de bloques que maneja el script: rivales, vecinos, enemigos.
- Servicio camaraReferencia del servicio camara. La cámara de cada jugador: la vista (tercera persona, primera persona, 2D, isométrica), distancia, inclinación, a quién sigue y tomas temporales.
- Límites vigentesTodos los límites del formato 1: tamaños del paquete, piezas por escena, tiempo de script por cuadro, interfaz, sonido y guardado, con su clave y su valor.
- El validador y sus códigosQué revisa greengames validar y en qué orden, la forma de un problema y la lista completa de códigos GB con su nivel, su mensaje y cómo resolver cada uno.
- Pruebas con el botEl guion del bot (pruebas/bot.json): pasos, condiciones, señales, enrutador, varios guiones, y qué exige greengames probar para dar una partida por aprobada.
- La herramienta greengamesLas órdenes crear, validar, probar, empaquetar, previsualizar, capturar y limites, con su sintaxis, sus opciones, sus códigos de salida, la salida en JSON y salidas reales de consola.
- Buenas prácticas y lista de calidadLo que conviene hacer al fabricar un juego, la lista de comprobación de calidad con casillas para marcar y la tabla de errores frecuentes con su causa y su arreglo.
- Caso de estudio: Circuito Luz VerdeRecorrido comentado del juego de referencia de Green Games: la idea, el manifiesto, la escena, el script por partes con fragmentos reales, el guion del bot y qué prueba cada cosa.
- Mundo abiertoEl tipo de juego de cubos generados, con su tabla de biomas, cómo se rompen y se ponen bloques, qué se guarda y cómo partir de la plantilla.
- Modelos, texturas y sonidosLa versión 1.2 del contrato: modelos 3D en .glb, texturas de imagen y sonidos grabados en un juego, cómo se usan desde la escena y desde el script, sus límites y los créditos.
GG-D54 páginas
Conceptos
Por qué los juegos corren aislados, qué es el determinismo, cuánto rinde y cómo es un .ggx por dentro.
- Aislamiento: por qué un juego no puede tocar tu equipoDónde corre el script de un juego, qué puede y qué no puede hacer, las barreras del portal, del launcher y del editor, la prueba con un paquete malicioso y el riesgo que queda.
- Determinismo: la misma partida, dos vecesPor qué una partida de Green Games se repite igual con la misma semilla y las mismas entradas, qué lo rompe, cómo se comprueba y qué hacer si el juego no es reproducible.
- Rendimiento medidoCuadros por segundo, tiempos de carga y tiempo de script de seis juegos del portal, medidos con y sin tarjeta gráfica, con la clase de equipo y las condiciones de cada cifra.
- El formato .ggxQué hay dentro de un archivo .ggx, cómo se arma, cómo abrirlo y leerlo con herramientas comunes, sus límites de tamaño y qué garantiza el número de formato.
GG-D65 páginas
Referencia
Glosario, atajos, preguntas frecuentes, registro de cambios y hoja de ruta.
- GlosarioLos términos de la plataforma, cada uno en una o dos frases, con enlace a la página donde se explica.
- AtajosTodas las teclas del editor 0.4.0, del launcher 0.4.0 y de una partida, en tablas, incluido el reparto del teclado para dos jugadores.
- Preguntas frecuentesRespuestas cortas sobre cuentas, precio, publicación, macOS, el instalador de Windows, actualizar desde la versión anterior, privacidad, multijugador, el asistente con IA, los bloques, las versiones y el lenguaje.
- Registro de cambiosLas versiones publicadas del launcher y del editor, qué motor trae cada pieza, qué cambió con la 0.5.0 del editor, con las 0.4.0, con las 0.3.0 y con las 0.2.0, y qué cambió en el formato y la API.
- Hoja de rutaLo que ya salió, lo que está en desarrollo, lo que está pendiente y lo que todavía no existe en la plataforma, sin fechas.