Curso de ZXGM Básico 03 - Explorando la estructura general del motor 🟡③

Introducción
Nota importante, el proyecto se encuentra en una fase de transicion entre la anteriormente consoldidada y la que está a punto de salir, trataré de mantener esto ajustado, pero podria haber desajustes. Para detalles lo mas actualizados posibles, consulta la documentación oficial del proyecto.
En este capítulo, nos enfocamos en lo mínimo que necesitas saber para crear un juego con ZX Game Maker (ZXGM): el launcher, la carpeta assets y la carpeta examples.
Asumimos que ya instalaste ZXGM según el capítulo anterior.
Lo esencial para crear tu juego
La estructura de ZXGM es mas amplia que lo que te voy a contar aquí, pero se trata de simplificar tu trabajo al máximo, por lo que trataré de aportarte la mínima teoria imprescindible para lograr tu objetivo.
1. El Launcher (zxsgm.py)

El archivo zxsgm.py, ubicado en la carpeta raíz de ZXGM, es el script principal que lanza la interfaz gráfica del ZX Game Maker. Desde ahí podrás realiuzar las tareas básicas de compilación y algunas adicionales de comprobación, como previsualizar sprites de enemigos o el mapa del juego.
-
Cómo usarlo:
-
Abre una terminal y navega a la carpeta de ZXGM:
bash cd /ruta/a/zx-game-maker -
Ejecuta el launcher:
bash python zxsgm.py -
En la interfaz gráfica, selecciona el menú Build > Game para compilar el juego. Esto procesa los recursos y genera un archivo
.tapen la carpetadist/, listo para probar en un emulador de ZX Spectrum (como Fuse o ZEsarUX). - Otras opciones del menú Build:
- Game (Verbose): Compila mostrando información detallada para depurar errores.
- FX: Genera efectos de sonido si usas el reproductor de beeper.
- Nota: Asegúrate de que Python está instalado y en el PATH. Si ves errores, verifica los permisos de la carpeta o revisa la instalación de dependencias.
-
2. Carpeta assets
La carpeta assets contiene los recursos de tu juego (de hecho, si quieres hacer backup de tu juego, esta es la carpeta que debes conservar a buen recaudo):
-
maps.tiled-project: Archivos de mapas creados con Tiled. Usa Tiled (versión 1.11.2 o superior) para diseñar los mapas de tu juego. -
tiles.zxp: Gráficos creados con ZX Paintbrush, respetando la resolución (256x192) y paleta (8 colores) del ZX Spectrum. -
sounds/: Archivos de audio para los pitidos del ZX Spectrum. -
Cómo usarla:
- Configura en los parametros personalizados de tiled las diferentes opciones del juego (las veremos en un capítulo monográfico posterior).
- Crea mapas en Tiled y guárdalos en
assets/. - Diseña gráficos en ZX Paintbrush y guárdalos como
.zxpenassets/. - Usa el menú Build > Game para procesar estos archivos y generar el
.tap.
3. Carpeta
examples
La carpeta examples incluye proyectos de muestra para aprender cómo estructurar tu juego.
- Cómo usarla:
- Guarda tu juego (el contenido de la carpeta assets) en otro lugar, por ejemplo en assets_miJuego renombrando la carpeta.
- copia
examples/example-game/a la carpeta raiz dentro de assets (creala si has renombrado la original) - Abre
assets/maps.tiled-projecten Tiled yassets/tiles.zxpen ZX Paintbrush para ver cómo están hechos. - Desde la carpeta raíz, ejecuta
python zxsgm.py, luego selecciona Build > Game en la interfaz para compilar el juego de ejemplo. - Carga el archivo
example-game.tap(endist/) en un emulador para probarlo.
En esencia la carpeta assets funciona como "ranura de cartucho" el juego que pongas ahi, será el que use Launcher.
Conclusión
Con el launcher (zxsgm.py) y su menú Build > Game, la carpeta assets para mapas y gráficos, y la carpeta examples como referencia, tienes lo esencial para crear tu juego. En el próximo capítulo, empezaremos a identificar y perfilar los juegos (en plural) que usaremos como ejemplo.
Referencias Bibliográficas
- Mis pruebas de campo ⚫① (En MacOS Ventura - Procesador Intel)
- Documentación oficial del proyecto 🌐🟡③
- Repositorio de Github de ZX Game Maker 🌐🟡③ .
- Página de Itch.io del proyecto 🌐🟡③
One More Thing

¡Desbloquea el poder de MetsuOS y descubre que la privacidad y la seguridad son la clave para desencadenar tu verdadero potencial en línea!
Contenido registrado en Safe Creative
¡Usa el código de promocional 7ZYM4Z y ahorrate unos eurillos en tu suscripcion de Safe Creative!
MetsuOS Needs You!
Apoyanos en este proyecto difundiendolo en tus redes, o mejor, haznos una donación a la cuenta paypal para poder dedicar más tiempo y recursos a el. No olvides comentarnos que parete te interesa más junto con tu donación.
En este momento, además de mantener los servicios, estoy centrado en crear la siguiente iteración del software que me permite hacer todo esto y creando una biblioteca personal física para poder contrastar contenido.
Sobre el sistema de validez de un contenido en MetsuOS
Empezando a incorporar los niveles de validación de un contenido (también llamada sabiduría o niveles de conocimiento) ⚫🔴 🟡 🟢 🔵⚪ ¿Qué són?
- ⚫① - Dark1 - Conocimiento en Bruto. Modo Cuñao, hablo pero no puedo respaldarlo.
- 🔴② - Rojo2 - Conocimiento Impulsivo, pasional, "lo mio es lo correcto".
- 🟡③ - Yellow3 - Conocimiento Crítico: se comienza a explorar el hecho de que pueda haber otras perspectivas.
- 🟢④ - Green4 - Conocimiento Natural: Surge al comprender la naturaleza de la realidad y del ser humano en una materia.
- 🔵⑤ - Blue5 - Conocimiento Científico: Supone la suma de las fases anteriores aplicando el rigor de lo descubierto por la ciencia hasta ahora, sin caer en la -anticientífica- "opinión científica/opinión de expertos".
- ⚪⑥ - Light6 Conocimiento Consolidado: Se alcanza al integrar todo lo anterior desde una perspectiva empática y asumiendo una verdad probabilística dinámica dependiente del contexto.
Sobre la categorización de los tipos de conocimiento
- Conocimiento Gnoseológico: ⚫① 🔴② 🟡③ 🟢④
- Conocimiento Epistemológico: 🔵⑤
- Conocimiento Metsukeológico: ⚪⑥
La Metsukeología (de Metsuke vision global y logos conocimiento) es la ciencia que estudia el conocimiento como un conjunto potencial de conocimiento del que podemos obtener, procesar o percibir partes concretas dentro de un marco contextual específico, y cuyo contexto general real está muy por encima de lo que somos capaces, como especie, de percibir, procesar e integrar de forma completa (definición en progreso).
La Metsucología (de Metsu aniquilación - en este contexto en forma de colapso - , logos conocimiento) es la ciencia que estudia como extraemos verdades percibidas - colapsadas - como conocimiento desde nuestra perspectiva real (tanto epistemológico como gnoseológico) al tomar una parte específica del conocimiento metsukeológico potencial enmarcado en un contexto concreto, obligando a colapsar el conocimiento potencial en conocimiento específico (definición en progreso).
Mas sobre el contexto
DISCLAIMER: Mi consideración de anticientífico respecto al consenso científico es una hipotesis de trabajo propia, que supone que toda asignación de validez, incluso aquella derivada de la conclusión por acumulación de evidencia NO debe ser supeditada a debate, ni acuerdo, debe ser algo probabilistico sin intervención del ego humano. Podría estar equivocado y, en este punto, es donde se aplicaría entonces ese mismo consenso que ahora considero no valido (incluso dañino)
Existen indicadores para algunas cuestiones adicoinales como los siguientes:
- 🌐 - Contenido Externo sobre cuya validez/validación no tenemos control (usualmente enlaces que salen de #MetsuOS)
- ⚖️ - Analisis
- ⚖️📚 - Análisis Bibligráfico
- ⚖️🔬 - Análisis Científico
- ⚖️🏛️ - Análisis Estructural
- ⚖️🧠 - Análisis Filosófico
- 📖 - Referencia
- 📖📚 - Referencia Bibliográfica / Libro
- 📖🔬- Referencia Científica / Paper
- 📖🏛️ - Referencia Estructural
- 📖🧠 - Referencia Filosófica
- 🔍️- Paradigma
Cuando hablamos de un contenido que incluye un texto que hace referencia a otro.
- 🔴②-🌐🟡③ - Nivel del contenido del documento Rojo2, nivel del contenido externo del que habla el documento Yellow3.
- 🔴②-⚖️📚 🔴② - Nivel del contenido del documento Rojo2, en base a análisis bibliográfico nivel Rojo2
También aplicaremos el Sistema de fiabilidad de fuentes y credibilidad de contenidos de la OTAN 🔴②, este sistema incluye una valoración de la fiabilidad de la fuente de A a F (siendo A la de mayor fiabilidad) y una varloración de credibilidad del contenido de 1 a 6 (siendo 1 la mayor credibilidad).
En MetsuOS la agregaremos al final uniendo amos valores como si fuera una coordenada. Por ejemplo: ⚫①-D4 o 🟡③-B2. Esto ayudarña a contextualizar la información sobre la solidez del conocimiento al que se hace referencia en cada momento.
Hay que tener en cuenta que, cuando hay elementos subjetivos o parcialmente subjetivos, el punto de referencia seré yo mismo. Quizá más adelante pueda objetivizar esto más (seria lo deseable), pero en tanto no tenga herramientas que me lo permitan, debo ceñirme al principio de honestidar intelectual, y esperar que mis sesgos dañen lo menos posible la información (en parte este es el nudo gordiano que pretendo resolver, y por ello es dificil resolverlo a priori).
Así de forma resumida, podríamos decir que esta definición es nivel 🔴② (Rojo2 xD) ¿Crees que me dejo algo? Si es así por favor ayudame a mejorarlo contactándome a través de X (Twitter) en mi cuenta, @metsuke 🌐
Consulta la versión completa de la descripcion en ⚫🔴🟡🟢🔵⚪ (🔴②) Un poco más de detalle
- Información IA: Generado asistido por IA (Raúl Carrillo Garrido aka metsuke). Supervisado por Humano.
- Ultima Modificación: 2025-09-07 00:53:07.974000+00:00
- Versión Documento: 0.2.7