Glosario
Los términos de la plataforma, cada uno en una o dos frases, con enlace a la página donde se explica.
Corresponde aFormato 1, API 1 Para todos
En esta página
Las piezas de la plataforma#
| Término | Qué es | Dónde se explica |
|---|---|---|
| Portal | El sitio https://play.green.games, donde se juega en el navegador sin instalar nada. | Jugar en la web |
| Green Games | Donde se juega: el portal y el launcher llevan ese nombre. También es el nombre del estudio. | Qué es la plataforma |
| Green Games Studio | El editor: el programa de escritorio para crear juegos. En esta documentación, «el editor». | Recorrido del editor |
| Launcher | Green Games en el escritorio: el programa para instalar juegos y jugarlos en tu equipo, también sin conexión. | Biblioteca |
| Editor | Green Games Studio. El programa de escritorio para crear juegos: escena, reglas, código, pruebas y exportación. | Recorrido del editor |
| Biblioteca | La pantalla del launcher con tus juegos instalados y los disponibles. | Biblioteca |
| Carpeta de datos | La carpeta de tu equipo donde el launcher guarda juegos instalados, progreso e historial. | Ajustes |
| Versión preliminar | El estado actual de la plataforma: funciona y le faltan piezas. | Qué es la plataforma |
El juego por dentro#
| Término | Qué es | Dónde se explica |
|---|---|---|
| Juego | Un paquete de datos y scripts. No es una página web ni un programa. | El paquete de un juego |
Paquete .ggx | El archivo único que contiene un juego completo: manifiesto, escenas, script, recursos y guion del bot, comprimidos. | Formato .ggx |
| Manifiesto | El archivo juego.json: la ficha del juego, con nombre, autor, jugadores, controles, dificultades, tablas de puntajes y textos. | Manifiesto |
| Ficha | Lo que ve quien abre un juego antes de jugar: nombre, descripción, portada y controles. Sale del manifiesto. | Ficha y exportar |
| Portada | La imagen del juego en el catálogo, en proporción 16:9. | Manifiesto |
| Escena | Un mundo del juego, descrito como datos: piezas, apariciones, zonas, luces, ambiente, la vista con que se juega y, si los usa, mapas de baldosas. Un juego tiene una o más. | Escenas |
| Pieza | Un objeto de la escena con forma, posición, tamaño y material: una caja, una rampa, una cuña, una esfera, un cilindro, una lámina o un modelo. | La escena |
| Vista | La cámara y la forma de moverse con que se juega una escena: tercera persona, primera persona, lateral (2D de plataformas), plano y cenital (desde arriba) o isométrica. Una zona puede cambiarla mientras el jugador está dentro. | Vistas |
| Tipo de juego | La vista con que nace un proyecto del editor: tercera persona, primera persona, isométrico, vista cenital, plataformas 2D, híbrido o mundo abierto. | Tipos de juego |
| Lámina | Un dibujo de píxeles guardado como datos, sin archivo de imagen. Se usa como pieza plana, como baldosa o como personaje. | Láminas |
| Mapa de baldosas | Un nivel escrito como una rejilla de texto, donde cada carácter es una baldosa. Sirve para niveles 2D y para pisos y muros vistos desde arriba. | Mapas de baldosas |
| Baldosa | Una celda de un mapa: un color o una lámina, y una forma de chocar (sólida, suelo, plataforma, peligro, escalera o ninguna). | Mapas de baldosas |
| Modelo | Un objeto 3D en un archivo .glb, con su malla, sus materiales y, si los tiene, esqueleto y clips. Se hace en el taller o se trae con el importador, y se coloca en la escena como una pieza con forma modelo. | Modelos en la escena |
| Clip | Una animación con nombre de un modelo, como caminar. Solo cambia cómo se ve el modelo: no lo mueve. | Taller de assets |
| Textura | Una imagen PNG, JPEG o WebP de la carpeta texturas/, que cubre una pieza desde su material o se muestra como imagen plana. | Modelos en la escena |
| Sonido grabado | Un archivo .wav o .mp3 de la carpeta sonidos/. Los demás sonidos del juego son sintetizados. | Modelos, texturas y sonidos |
| Crédito | El autor, la licencia y el origen de un modelo, una textura o un sonido, en creditos.json. Viaja dentro del .ggx. | Importar assets |
| Taller de assets | La parte del editor donde se dibujan láminas y texturas, se arman modelos de cubos con sus animaciones y se pintan mapas de baldosas. | Taller de assets |
| Importador | La parte del editor que convierte modelos, texturas y sonidos de otras herramientas al formato del juego. | Importar assets |
| Mundo abierto | Un tipo de juego que no se arma pieza por pieza: el motor genera un mundo de cubos a partir de una semilla y una tabla de biomas, y se rompen y se ponen bloques. | Mundo abierto |
| Terreno de cubos | El mundo generado de un juego de mundo abierto, hecho de bloques de 1 x 1 x 1. Va en la propiedad terreno de la escena. | Mundo abierto |
| Bioma | Una fila de la tabla del terreno: en qué clima aparece, qué tan alto es, de qué está hecho y qué crece. | Mundo abierto |
| Material | Cómo se ve una pieza: un color de la paleta, un acabado (mate, brillante, neón, cristal) y un patrón (liso, cuadros, franjas, rejilla). | Escenas |
| Paleta (de colores) | La lista de colores con nombre que pueden usar las piezas. Una escena puede agregar los suyos. | Escenas |
| Prefabricado | Un conjunto de piezas ya armado que el editor coloca de una vez (moneda, meta, puerta con botón), a veces con la regla que lo hace funcionar. | La escena |
| Zona | Un volumen invisible que avisa cuando alguien entra o sale. Sirve para metas, botones y puntos de control. | Escenas |
| Aparición | Un punto de la escena donde aparecen los jugadores. La primera es el inicio; las demás sirven de puntos de control. | Escenas |
| Punto de control | La aparición a la que vuelve un jugador cuando reaparece. | Reglas |
| Etiqueta | Una palabra que se pone a piezas o zonas para tratarlas juntas: "todo lo que tenga la etiqueta moneda". | Escenas |
| Grupo | Varias piezas que se eligen y se mueven juntas. Se guarda en la propiedad grupo de cada pieza, la misma que el script maneja con mundo.grupo. | La escena |
| Ambiente | Los ajustes generales de una escena: cielo, luz ambiente, niebla, gravedad y altura de caída. | Escenas |
| Recurso | Un archivo empaquetado con el juego. Hoy solo se usa para la portada. | El paquete de un juego |
| Avatar | El personaje que maneja un jugador. Es de bloques, salvo que la escena lo dibuje con una lámina. | API de jugadores |
Reglas y código#
| Término | Qué es | Dónde se explica |
|---|---|---|
| Regla | Una frase "Cuando… entonces…" que se arma en el editor sin escribir código. | Reglas |
| Disparador | La parte "Cuando" de una regla: lo que tiene que pasar (el jugador toca algo, pasa el tiempo, empieza la partida). | Reglas |
| Acción (de una regla) | La parte "entonces" de una regla: lo que hace el juego (sumar puntos, mostrar un mensaje, terminar la partida). | Reglas |
| Acción (botón) | Uno de los botones del jugador además de moverse: saltar, acción y segunda acción, y en los juegos que los declaran, los dos del puntero (los clics del ratón). Cada juego dice qué hacen. | Controles |
| Modo Bloques | La manera de programar un juego del editor encajando bloques como piezas, con el código que escriben a la vista. Un proyecto se hace con Reglas o con Bloques, no con las dos. | Bloques |
| Lienzo | La zona de la pestaña Bloques donde se arman los programas, con una pestaña por objeto. | Bloques |
| Paleta (de bloques) | La lista de bloques del modo Bloques, por categorías, a la izquierda del lienzo. | Bloques |
| Script | El programa con la lógica del juego, en TypeScript o JavaScript. Solo puede usar la API de Green Games. | Scripts |
| Bloque de reglas | La parte del script que escribe el editor a partir de tus reglas, entre // <reglas> y // </reglas>. Tu código va fuera. | Código en el editor |
| SDK | El conjunto de definiciones que describe el formato de un juego y la API que usa su script. | Referencia de la API |
| API | Las funciones que un script puede llamar. Lleva el número 1. | Referencia de la API |
| Servicio | Cada una de las once partes de la API: juego, mundo, jugadores, interfaz, sonido, progreso, puntajes, azar, reloj, actores y camara. | Referencia de la API |
| Actor | Un personaje que maneja el script: un rival, un vecino, un enemigo. | API de actores |
| Rótulo | Un texto o una barra que el script dibuja sobre algo del mundo: la vida de una torre, el nombre de un lugar. | API de interfaz |
| Textos | Todo lo que el juego muestra escrito, por clave y en dos idiomas, dentro del manifiesto. | Manifiesto |
| Límite | Un tope que todo juego debe respetar: tamaño del archivo, número de piezas, tiempo de script por cuadro. | Límites |
La partida#
| Término | Qué es | Dónde se explica |
|---|---|---|
| Sala | Donde ocurre de verdad la partida: la física, los jugadores, el script y los puntajes. Corre aislada y no sabe en qué programa está. | Aislamiento |
| Reproductor | La parte que muestra la partida y recoge tus controles. Es la misma en el portal, en el launcher y en el editor. | Aislamiento |
| Aislamiento | Las barreras que impiden que el script de un juego lea tus archivos, use la red o toque el programa que lo muestra. | Aislamiento |
| Cuadro | Un paso de la simulación. Hay 60 por segundo, siempre. | Determinismo |
| Semilla | El número del que sale todo el azar de una partida. | Determinismo |
| Determinismo | Con la misma semilla y los mismos controles, la partida se repite exactamente igual. Es lo que permite probar un juego con un bot. | Determinismo |
| Dificultad | Una variante del juego que eliges antes de jugar. Lo normal son tres: Fácil, Normal y Difícil. Una pieza puede existir solo en algunas. | Jugar |
| Modo | Cómo se llena la partida: Solo, o Con bots en los juegos que admiten más de un jugador. | Jugar |
| Multijugador local | Varias personas, de 2 a 4, jugando en el mismo equipo. El juego tiene que declararlo. | Manifiesto |
| Pantalla dividida | En el multijugador local, una parte de la pantalla para cada persona, con su cámara y sus indicadores. La alternativa es la pantalla compartida: una sola cámara que sigue al grupo. | Manifiesto |
| Tabla de puntajes | La lista de las mejores marcas de un juego. Es local, de diez marcas por dificultad, por puntos o por tiempo. | Historial y progreso |
| Progreso | Datos que un juego guarda entre partidas, en tu equipo. Hasta 64 KB por juego; un juego de mundo abierto guarda aparte los cambios de su terreno, hasta 320 KB. | API de progreso |
| Historial | El registro que lleva el launcher de tus partidas en cada juego. | Historial y progreso |
Pruebas y herramientas#
| Término | Qué es | Dónde se explica |
|---|---|---|
| Validador | El programa que revisa que un juego cumpla el formato y dice qué corregir. Lo usan el editor, el launcher y la línea de comandos. | Validador |
Código GB | El identificador estable de cada problema que encuentra el validador, como GB310. | Validador |
| Problema | Un error o un aviso del validador. Un error impide exportar; un aviso no. | Problemas del editor |
| Bot | El jugador automático. Maneja al avatar con los mismos controles que una persona. Se usa para probar un juego de principio a fin y para llenar el modo Con bots. | Bot de prueba |
| Guion | La lista de pasos que sigue el bot para terminar la partida: ir a un punto, esperar, pulsar un botón. | Bot de prueba |
| Probar con bot | Correr la partida completa sin pantalla, en cada dificultad y con dos semillas, para comprobar que el juego se puede terminar. | Jugar y probar |
| Exportar | Convertir un proyecto del editor en un archivo .ggx. Solo se hace si el juego valida y el bot lo termina. | Ficha y exportar |
| Importar | Abrir un archivo .ggx en el launcher, que lo valida y lo instala. | Importar un .ggx |
| Plantilla | Un juego de partida para no empezar de cero. El editor las ofrece al crear un proyecto, y la línea de comandos, con greengames crear. | Nuevo juego |
| Asistente | El panel del editor que arma cambios a partir de un pedido escrito. Puede usar un modelo de IA que corre en tu equipo; sin modelo, es un asistente básico que reconoce pedidos frecuentes. | Asistente |
Línea de comandos (greengames) | La herramienta para crear, validar, probar y empaquetar juegos desde una terminal. | Herramienta de línea de comandos |
| Formato | La versión de la estructura de un juego. Hoy es 1. | Registro de cambios |