Curso de ZXGM Básico 02 - Descarga e instalación del software 🟡③

• Curso de ZX Game Maker ⚫①
• << Anterior | Siguiente >>

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 segundo capítulo del curso básico de ZX Game Maker (ZXGM), aprenderás cómo descargar e instalar el software necesario para comenzar a desarrollar videojuegos para el ZX Spectrum.

Este tutorial está diseñado para usuarios de todos los niveles, desde principiantes hasta aquellos con experiencia previa, y cubre los pasos para configurar el entorno en sistemas operativos modernos (Windows, macOS y Linux).

Siguiendo estas instrucciones, tendrás un entorno funcional para empezar a crear tus propios juegos retro.

Requisitos previos

Antes de comenzar, asegúrate de cumplir con los siguientes requisitos:

• Sistema operativo: Windows (10 o superior), macOS (10.13 o superior) o una distribución de Linux (como Ubuntu 20.04 o superior).
• Espacio en disco: Al menos 2 GB de espacio libre para el software y las herramientas asociadas.
• Conexión a Internet: Necesaria para descargar el software y las dependencias.
• Permisos administrativos: En algunos casos, se requieren permisos de administrador para instalar ciertas herramientas.
• Herramientas recomendadas: Aunque ZXGM permite flexibilidad, se recomienda usar ZX Paintbrush para gráficos y Tiled para diseño de mapas.

Paso 1: Descarga de ZX Game Maker

ZX Game Maker es un proyecto de código abierto alojado en GitHub. Sigue estos pasos para obtener la última versión:

1. Visita el repositorio oficial: Accede al repositorio de ZX Game Maker en GitHub (Enlace al reposotorio 🌐🟡③). Si no está disponible, consulta la documentación oficial en el grupo de Telegram de ZXGM o en foros como Spectrum Computing.

2. Descarga la versión más reciente: Haz clic en el botón verde "Code" y selecciona "Download ZIP" para descargar el archivo comprimido. Alternativamente, si tienes Git instalado, puedes clonar el repositorio con el comando:

   bash git clone https://github.com/rtorralba/zx-game-maker.git

3. Descomprime el archivo: Extrae el contenido del archivo ZIP en una carpeta de tu elección (por ejemplo, C:\ZXGM en Windows o ~/zxgm en macOS/Linux).

Si has clonado el repositorio, no necesitarás realizar este ultimo paso.

Paso 2: Instalación de dependencias (legacy)

ZX Game Maker requiere varias herramientas y lenguajes para funcionar correctamente. A continuación, se detalla cómo instalar cada una:

2.1 Script de instalacion de ZXGM

Si tu versión no incluye los ficheros install.sh e install.windows.bat, puedes saltarte este paso e ir a la parte de python directamente, pues tu versión está actualizada a la que en el momento de revisar este texto, era verion Preview. ¡Enhorabuena tienes muchos mas juguetes para construir!

Abre una terminal o programa de linea de comandos que uses en tu sistema y muevete a la carpeta de ZXGM con cd /ruta/a/zx-game-makero equivalente para situarte en la carpeta del maker:

• Windows: Ejecuta el scriot install.windows.bat
• Linux/MacOS: Ejecuta el scriopt install.sh

Sigue las instrucciones en pantalla, y asegúrate de llegar a tiempo al andén 9 3/4... esto iniciará la magia :)

2.2. Python

Python es necesario para ejecutar los scripts que generan los juegos.

• Windows/macOS:

  1. Descarga la última versión de Python desde python.org 🌐🟡③.
  2. Ejecuta el instalador y asegúrate de marcar la opción "Add Python to PATH".

  3. Verifica la instalación abriendo una terminal y ejecutando:

     bash python --version

     Deberías ver la versión instalada (por ejemplo, Python 3.13.x).
     - Linux:

  4. La mayoría de las distribuciones ya incluyen Python. Verifica ejecutando:

     bash python3 --version

  5. Si no está instalado, usa el gestor de paquetes de tu distribución, por ejemplo:

     bash sudo apt install python3 python3-pip

2.3. Tiled (Editor de mapas)

Tiled es una herramienta recomendada para crear mapas de juego.

Se recomienda mínimo 1.11.2, ya que (a fecha 3 de Agosto de 2025) es la última versión estable que incluye mejoras significativas en soporte de .tiled-project, incorporado en ZX Game Maker a partir de Octubre de 2024.

1. Descarga Tiled desde mapeditor.org 🌐🟡③
2. Instala siguiendo las instrucciones del instalador para tu sistema operativo.
3. Abre Tiled para asegurarte de que funciona correctamente. No necesitas configurarlo aún; ZXGM incluye plantillas compatibles en la carpeta assets.

2.4. ZX Paintbrush (Editor gráfico)

ZX Paintbrush es ideal para crear gráficos que respeten las limitaciones del ZX Spectrum.

1. Descarga ZX Paintbrush desde su sitio oficial o desde un enlace proporcionado en la documentación de ZXGM.
2. Instala el programa. En Windows, es un ejecutable; en macOS/Linux, necesitarás usar wine 🌐🟡③.
3. Abre ZX Paintbrush y verifica que puedes crear un archivo .zxp.

También puedes usar la herramienta (en etapa alpha, pero funcional en este aspecto), MetsuOS Retro Tools Launcher 🌐, que te facilita la tarea con un panel de botones para esta y alguna herrramienta más del tipo "Windows only", usando wine solo si es necesario.

2.5 Pasmo (Ensamblador Z80)

Pasmo es un ensamblador para Z80 que permite compilar código en ensamblador para ZX Spectrum, útil para optimizar partes de tu juego o integrar código personalizado con ZX Game Maker.

• Windows:

  1. Descarga la última versión de Pasmo desde su sitio oficial http://pasmo.speccy.org 🌐🟡③ o desde el enlace proporcionado en la documentación de ZXGM.

  2. Descomprime el archivo ZIP en una carpeta, por ejemplo, C:\Pasmo.

  3. Añade Pasmo al PATH:

     • Abre el Panel de Control > Sistema > Configuración avanzada del sistema > Variables de entorno.

     • En "Variables del sistema", busca "Path", selecciona "Editar" y añade la ruta a la carpeta donde descomprimiste Pasmo (por ejemplo, C:\Pasmo).

  4. Verifica la instalación abriendo una terminal y ejecutando:

  bash pasmo --version

  Deberías ver la versión de Pasmo instalada.

• Linux/macOS:

  1. Descarga el archivo comprimido de Pasmo desde http://pasmo.speccy.org 🌐🟡③.

  2. Descomprime el archivo en una carpeta, por ejemplo, ~/pasmo.

  3. Compila Pasmo (requiere un compilador de C++, como g++):

  bash cd ~/pasmo ./configure make sudo make install

  1. Verifica la instalación ejecutando:

  bash pasmo --version

  Si no está en el PATH, puedes añadirlo manualmente editando ~/.bashrc o ~/.zshrc y añadiendo:

  bash export PATH=$PATH:/ruta/a/pasmo

  Tambien puedes copiarlo a /usr/local/bin

  bash sudo cp pasmo /usr/local/bin

2.6. Otras dependencias

Algunas dependencias adicionales, como la librería el compilador de Boriel Basic o GuSprites, se incluyen en el repositorio de ZXGM y se cargaron automaticamente en tu carpeta al ejecutar la instalación de dependencias anteriormente descrita. Asegúrate de no modificar la carpeta src dentro del proyecto descargado.

Paso 3: Configuración del entorno

Organiza la carpeta del proyecto

Asegúrate de que la carpeta descomprimida de ZXGM contiene las subcarpetas assets, src y examples.

La carpeta assets incluye archivos como maps.tiled-project y tiles.zxp para configurar mapas y gráficos..

Prueba el entorno:

Navega a la carpeta del proyecto en una terminal y arranca el entorno:

cd /ruta/a/zx-game-maker
python zxsgm.py

Aparecerá la pantalla de aplicación en mi caso de color oscuro, en el tuyo podría ser de color claro, pero en todo caso se parecerá mucho (como diria el gran Hovik Keuchkerian mucho más que muchísimo y muchísimo más que más)

• Comprobamos ejecutando el menu Game/Build y esperar a que se complete el proceso, si no hay errores, se generará un archivo de juego (Game-Name.tap) en la carpeta dist.

Paso 4: Verificación de la instalación

1. Ejecuta un emulador de ZX Spectrum:
   • Descarga un emulador como Fuse (fuse-emulator.sourceforge.io 🌐🟡③)
   • Carga el archivo generado en dist (Game-Name.tap) en el emulador para verificar que funciona.
2. Revisa el mapa de memoria:
   • En la carpeta output, encontrarás un archivo de mapa de memoria que detalla el uso de recursos. Úsalo para asegurarte de que el juego cumple con las limitaciones del ZX Spectrum (48k o 128k).

Solución de problemas comunes

• Python no encontrado: Asegúrate de que Python está en el PATH y usa python3 en Linux/macOS.
• Errores de compilación: Verifica que Boriel’s ZX Basic está instalado correctamente y que no hay dependencias faltantes.
• Archivos no generados en dist: Revisa los permisos de la carpeta y asegúrate de ejecutar el script correcto para tu sistema operativo.
• Problemas con gráficos: Confirma que los archivos .zxp y los mapas en Tiled cumplen con las restricciones de resolución y paleta del ZX Spectrum.

Para más ayuda, consulta el grupo de Telegram de ZXGM o los tutoriales en vídeo mencionados en la documentación oficial.

Conclusión

Con ZX Game Maker y sus dependencias instaladas, estás listo para comenzar a crear videojuegos para el ZX Spectrum. En el próximo capítulo, seguiremos avanzando en nuestro aprendizaje. ¡Prepárate para dar vida a tus ideas!

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 (Grok-3, Raúl Carrillo aka Metsuke). Supervisado por Humano.
• Ultima Modificación: 2025-09-07 00:41:24.903000+00:00
• Versión Documento: 0.3.11