Curso de ZXGM Básico 04 - Configuración de un nuevo proyecto 🔴②

• 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 cuarto capítulo del curso básico de ZX Game Maker (ZXGM), aprenderás a configurar un nuevo proyecto desde "cero" (el motor está ideado para que partas de una plantilla mínima), siguiendo un enfoque estructurado y gradual, como un escultor tallando una obra a partir de una piedra en bruto.

Usaremos como ejemplo el desarrollo de Cursed Zapatilla: La Excéntrica Cruzada de Sir Patillas, un juego de plataformas inspirado en Ghosts 'n Goblins, Ghouls 'n Ghosts y Cursed Castilla.

Este juego forma parte de un pack de juegos que usare para todos los cursos de Makers y creacion de juegos, de forma que - en la medida de lo posible - habra, al menos, tantas versiones del juego como motores y modos graficos soporten aquellos para los que hagamos cursos. Pretendo con ello fomentar la idea de explorar Y de la necesidad de aumentar el nivel de calidad de las producciones, una vez creada tu opera prima.

Este capítulo se centra en crear la estructura inicial del proyecto y configurar parámetros básicos en Tiled, sin modificar aún los recursos gráficos, pantallas, sonidos o músicas. En cada capítulo posterior, iremos cincelando el proyecto hasta transformarlo en nuestro juego final.

El proceso consiste en tomar una plantilla de ejemplo que viene por defecto en assets (o en su caso una de la carpeta examples), renombrar la carpeta de ZX Game Maker para reflejar nuestro juego (usando guiones en lugar de espacios para evitar problemas con los nombres) y ajustar parámetros específicos en Tiled para alinearlos con las necesidades de Cursed Zapatilla.

Este tutorial está diseñado para principiantes, asumiendo que tienes el entorno configurado según el Capítulo Básico 02 y conoces la estructura del motor del Capítulo Básico 03.

Al final, tendrás un proyecto base listo para iterar en los siguientes capítulos.

Requisitos previos

Antes de comenzar, verifica lo siguiente (basado en el Capítulo Básico 02):

• ZXGM instalado con dependencias (Python, Tiled versión 1.11.2 o superior, ZX Paintbrush).
• Scripts de instalación ejecutados (install.windows.bat o install.sh).
• Carpeta principal de ZXGM organizada con subcarpetas assets, src y examples.
• Conocimiento de la estructura: assets para mapas y gráficos, src para dependencias como Boriel Basic y GuSprites (no modificar), examples para plantillas adicionales.
• Emulador de ZX Spectrum (como Zesarux o Fuse) de tu elección para pruebas.
• Acceso a la documentación oficial de ZXGM cuyos enlaces puedes ver en las referencias bibliogrçaficas al final del capítulo.

Si algo no está listo, revisa la sección de solución de problemas del Capítulo Básico 02.

Paso 1: Renombrar la carpeta de zxgm

Este paso, aunque no es obligatorio, es altamente recomendable, debemos tomar la carpeta donde hemos instalado el motor (habitualmente zx-game-maker) y renombrarla con el nombre de nuestro juego, en nuestro caso he usado "cursed-zapatilla-zxgm".

Es una buena práctica no poner espacios en el nombre, para evitar problemas derivados de espacios dentro de las rutas, en su lugar recomiendo el uso de guiones.

Paso 2: Seleccionar la plantilla base o usar la de assets

Por defecto, el motor contiene un juego demo en assets (que es donde estarán los datos de nuestro juego), por defecto usaremos este.

No obstante en examples hay mas plantillas que puedes usar cambiando los ficheros:

• arcade .- Ejemplo de juego en modo arcade (por pantallas a lo Snow Bros)
• overhead-view .- Ejemplo con vista cenital, al estilo Zelda
• platforms ,. Es el juego que por defecto viene en assets de estilo plataformas.

Si quieres cambiar de plantilla, copia el contenido de la carpeta de la que quieras, y copialo dentro de assets, sobreescribiendo ficheros.

Una vez elegida la plantilla, vamos a lanzar el GUI.

Paso 3: Lanzar ZX Game Maker

1. Abre una terminal o línea de comandos y navega a la carpeta principal de ZXGM (e.g., cd /ruta/a/zx-game-maker).

2. Ejecuta el launcher con:

python zxsgm.py

Esto abre la interfaz de ZXGM (pantalla oscura o clara, según configuración). Si aparece un error, verifica que Python esté en el PATH y usa python3 en Linux/macOS si es necesario.

1. Prueba a ejecutar Build / Game en el menú para asegurarte de que partimos de una plantilla funcional.

Paso 4: Configuración inicial en Tiled

En este capítulo, nos enfocamos en ajustar parámetros en Tiled (lugar donde se realizan casi todas las configuraciones de nuestro juego) para alinear el proyecto con Cursed Zapatilla.

Usaremos el archivo maps.tiled-project de la plantilla copiada, sin modificar gráficos aún.

1. Abre el Mapa de la plantilla en el menu Map / Open Map

2. En tiled, despliega "Maps" y haz doble click sobre el mapa para abrir el interfaz

3. Te aparecerá algo similar a esto (calma, parece mucho, pero iremos paso a paso, capitulo a capitulo):

Paso 5: Configuración de los parámetros

Vamos a comenzar con la chicha, en este punto, vamos a confgigurar los parámetros que permiten generar una jugabilidad específica para nuestra obra. Aunque exploraremos todos los parámetros, centraremos el foco en crear nuestro juego plataformero, ya habrá tiempo, una vez completado el ciclo base, de crear monográficos para cada uno de los juegos que queremos crear.

Organizaremos los parámetros de forma progresiva y por bloques de forma que el proceso de pensamiento creativo sea el que guie nuestros pasos en una dirección precisa.

Los parmetros se pueden ver en Mapa > Propiedades Personalizadas o Map > Map Properties dependiendo del idioma actual en Tiled:

WIP Organizando y definiendo estructura de los nuevos parámetros, así como su funcionamiento con base en la nueva información disponible en la documentación.

Parámetros Generales

Lo primero, logicamente, es identificar nuestro juego, y el target al que va dirigido!

gameName

Establece el nombre del juego

• Sintaxis: gameName <nombre_del_juego>
• Notas: Aparecerá en el título loading cuando carga y el tap se generará con este nombre. 10 carácteres como máximo sin carácteres especiales (acentos, ñ…)
• Para Cursed Zapatilla: Usaremos "CursedZapa" como identificador.

128Kenabled

Establece si el modo 128K está activo.

• Sintaxis: 128Kenabled ( activado / desactivado )
• Notas: En modo 128k, se permite acceso a bancos de memoria adicionales para características avanzadas y, por tanto, el juego no funcionará en 48K
• Para Cursed Zapatilla: Marcaremos la opción para que genere el .tap para 128K, en 48K no funcionará.

Parámetros Estructurales

En este punto tomaremos decisiones en torno al mundo en el que nuestro personaje desarrollará su "vida":

gameView

Define el tipo de juego a desarrollar según la perspectiva.

• Sintaxis: gameView (side | overhead)
• Notas: Establece la vista del juego: "side" para un juego de plataformas lateral (ideal para Cursed Zapatilla, inspirado en plataformas como Ghosts 'n Goblins), y "overhead" para un juego de vista cenital, como un laberinto o estrategia. La elección afecta el diseño del mapa en Tiled y la lógica de movimiento en ZXGM.
• Para Cursed Zapatilla: Usaremos gameView = side para un desplazamiento lateral en nuestro florido cementerio.

arcadeMode

Establece si el juego se comportará en modo arcade.

• Sintaxis: arcadeMode (activado | desactivado)
• Notas: Si esta propiedad está activada, el juego adopta un estilo arcade clásico, en el que hay que pasarse cada pantalla y vamos avanzando por niveles (como en Snow Bross por ejemplo). Puedes ver este comportamiento arcade aquí 🌐🟡③.
• Para Cursed Zapatilla: Configuraremos arcadeMode = desactivado, ya que queremos un mapeado continuo, a falta de un sistema de fases multipantalla, tendremos uno con el mapa completo.

password

Establece un password que se pedirá al iniciar el juego.

• Sintaxis: password <contraseña_de_8_caracteres>
• Notas: Útil para juegos con múltiples cargas, en caso de configurarla se te pedirá la contraseña para poder jugar. La contraseña debe tener exactamente 8 caracteres alfanuméricos y no debe incluir caracteres no ingleses (e.g., ñ, acentos).
• Para Cursed Zapatilla: Lo dejaremos vacio ya que no requerimos esta funcionalidad.

Parámetros de Juego

Centremos nuestra atencion ahora en algunos aspectos generales del juego:

goalItems

Número de items necesarios para finalizar el juego.

• Sintaxis: goalItems <número_de_items>
• Notas: Define la cantidad de objetos (e.g., flores brillantes o llaves) que el jugador debe recolectar para completar Cursed Zapatilla. Este valor influye en la lógica del juego y debe ser un número entero positivo.
• Para Cursed Zapatilla: Configuraremos goalItems = 66 para un nivel inicial con cinco items en el cementerio, si mas adelante lo necesitaremos, ajustaremos este número.

hiScore

Habilita la puntuación in-game y el guardado de la misma para que aparezca en la pantalla de menú.

• Sintaxis: hiScore (activado | desactivado)
• Notas: Activa un sistema de puntuación que se muestra durante el juego y se guarda para exhibirse en la pantalla de menú, emulando el estilo arcade de Ghosts 'n Goblins. Requiere espacio adicional en memoria (recomendado modo 128k para estabilidad). Si está desactivado, no se registrará la puntuación.
• Para Cursed Zapatilla: Configuraremos hiScore = activado para incentivar la rejugabilidad asociada al reto extra.

idleTime

Setea el tiempo a esperar a que el personaje haga la animación idle. Si está a 0 no se activará.

• Sintaxis: idleTime <segundos>
• Notas: Establece el intervalo (en segundos) tras el cual Sir Patillas realiza una animación idle (e.g., ajustarse el casco) si no hay input. Un valor de 0 desactiva esta función para optimizar recursos en el ZX Spectrum. Valores típicos: 2-5 segundos.
• Para Cursed Zapatilla: Configuraremos idleTime = 10 para una animación idle tras 10 segundos de inactividad.

livesMode

Habilitado tu personaje morirá cada vez que reciba daño perdiendo 1 vida y volviendo al punto donde entró de la pantalla actual. A su vez sólo ganará 1 vida con los items life.

• Sintaxis: livesMode (disabled | instant respawn | show graveyard)
• Notas: Activa un sistema de vidas clásico donde Sir Patillas pierde una vida por daño y reaparece en el inicio de la pantalla, con ganancia limitada a 1 vida por item life. Puedes ver este comportamiento del modo vidas aquí 🌐🟡③.
• Para Cursed Zapatilla: Ideal para un estilo arcade en Cursed Zapatilla. Configuraremos livesMode = show graveyard para replicar la dificultad de Ghosts 'n Goblins, y mostrar la tumbita que no deja de tener su guasa en el contexto este juego.

initialLife

Cantidad de vida inicial del personaje.

• Sintaxis: initialLife <cantidad_de_vida>
• Notas: Define la vida inicial de Sir Patillas en Cursed Zapatilla, representada como un número entero (e.g., 3 vidas o 100 puntos de energía).
• Para Cursed Zapatilla: Configuraremos initialLife = 5 para cinco vidas iniciales, al estilo de los clásicos arcade, adaptados a los nuevos tiempos.

lifeAmount

Cantidad de vida que incrementa al personaje los items life.

• Sintaxis: lifeAmount <cantidad_de_vida>
• Notas: Define la cantidad de vida que se suma a Sir Patillas al recoger items life en Cursed Zapatilla. Debe ser un número entero positivo.
• Para Cursed Zapatilla: Configuraremos lifeAmount = 1 para que cada item life restaure 1 vida.

shooting

Con esto habilitamos o deshabilitamos el disparo del personaje.

• Sintaxis: shooting (activado | desactivado)
• Notas: Habilita o deshabilita la capacidad de Sir Patillas para disparar proyectiles (e.g., zapatillazos a distancia). Desactivado optimiza recursos en el ZX Spectrum; activado requiere configuración de ammo y bulletDistance.
• Para Cursed Zapatilla: Configuraremos shooting = activado para añadir ataques a distancia.

ammo

Cantidad de munición con la que empezará el personaje principal. Si seteas -1 el personaje tendrá munición infinita.

• Sintaxis: ammo <cantidad_de_munición>
• Notas: Establece la munición inicial de Sir Patillas para ataques a distancia (e.g., zapatillazos proyectados). Un valor de -1 otorga munición infinita, útil para pruebas; valores positivos (e.g., 10-50) limitan los disparos en modo 48k.
• Para Cursed Zapatilla: Configuraremos ammo = -1 ya que uno de los atractivos de este estilo de juegos es moverse y disparar sin parar un instante.

ammoIncrement

Cantidad de munición que se recarga cada vez que el protagonista recoja un item de recarga de munición.

• Sintaxis: ammoIncrement <cantidad_de_munición>
• Notas: Define cuánta munición se añade al recoger un item de recarga en Cursed Zapatilla. Debe ser un número entero positivo.
• Para Cursed Zapatilla: No configuraremos `ammoIncrement porque el estilo de juego pide dis... zapatillas infinitas.

bulletDistance

Distancia que queramos que recorra la bala. El valor 0 se traduce como distancia infinita, la bala no parará hasta que choque con algún obstáculo. Si seteamos una distancia corta como de 2, da el efecto de que el personaje ataca con el arma a corta distancia como una espada.

• Sintaxis: bulletDistance <distancia>
• Notas: Controla la distancia de los proyectiles disparados por Sir Patillas. Un valor de 0 permite trayectorias infinitas (hasta colisión); valores bajos (e.g., 2) simulan ataques cuerpo a cuerpo, como un zapatillazo de corto alcance en Cursed Zapatilla.
• Para Cursed Zapatilla: Configuraremos bulletDistance = 0 para un efecto de ataque Cocodrilo Dundee profesional con zapatillas voladoras.

Parámetros de Interacción

Una vez llegados a este punto, configuraresmos las interacciones con enemigos y otros elementos del escenario:

enemiesRespawn

Indica si los enemigos (no invencibles) reaparecen después de ser eliminados al volver a entrar en la habitación.

• Sintaxis: enemiesRespawn <verdadero/falso>
• Notas: Configura si los enemigos vuelven a generarse.
  • Para Cursed Zapatilla: Estableceremos enemiesRespawn a false para evitar repeticiones innecesarias y enfocarnos en un avance lineal.

damageAmount

Cantidad de daño que los enemigos infligen al personaje.

• Sintaxis: damageAmount <cantidad_de_daño>
• Notas: Define la cantidad de daño que los enemigos causan al personaje al tocarlo. Debe ser un número entero positivo.
• Para Cursed Zapatilla: Configuraremos damageAmount a 1 dado que activamos el modo de vidas.

killJumpingOnTop

Habilita la capacidad de matar enemigos saltando sobre ellos (solo en juegos de plataformas).

• Sintaxis: killJumpingOnTop <verdadero/falso>
• Notas: Activa la mecánica de eliminar enemigos al saltar encima, típica de plataformas.
• Para Cursed Zapatilla: Estableceremos killJumpingOnTop a true para añadir una mecánica divertida de zapatillazos desde arriba usando nuestras poderosas pantuflas de combate.

jetPackFuel

Cantidad de combustible disponible para el jetPack; si es distinto de 0, el personaje usará el jetPack en lugar de saltar.

• Sintaxis: jetPackFuel <cantidad_de_combustible>
• Notas: Define la cantidad de combustible para el jetPack. Debe ser un número entero no negativo; 0 desactiva el jetPack.
• Para Cursed Zapatilla: Configuraremos jetPackFuel a 0, ya que Sir Patillas dependerá de saltos tradicionales y zapatillescos.

jumpType

Tipo de salto del personaje, con opciones de movimiento constante o acelerado.

• Sintaxis: jumpType <constant/accelerated>
• Notas: constant usa una velocidad constante hacia arriba y abajo (estilo original del motor); accelerated aplica deceleración al subir y aceleración al bajar.
• Para Cursed Zapatilla: Estableceremos jumpType a constant para mantener un control clásico al estilo Ghosts 'n Goblins.

shouldKillEnemies

Requiere eliminar a todos los enemigos en una habitación antes de poder salir de ella.

• Sintaxis: shouldKillEnemies <verdadero/falso>
• Notas: Si está activado, la salida queda bloqueada hasta que se eliminen todos los enemigos.
• Para Cursed Zapatilla: Estableceremos shouldKillEnemies a true para añadir un desafío extra al estilo arcade, compensando las limitaciones de extensión del mapeado debido a las limitaciones de memoria en ZX Spectrum.

keysEnabled

Habilita o deshabilita el uso de llaves y puertas que requieren llaves.

• Sintaxis: keysEnabled <verdadero/falso>
• Notas: Si está deshabilitado, las llaves y puertas asociadas no funcionarán en el juego.
• Para Cursed Zapatilla: Configuraremos keysEnabled a true, ya que aunque el juego prioriza acción directa, en este estilo de juego hay puertas en puntos estratégicos.

laddersEnabled

Habilita la funcionalidad de escaleras cuando se establece en true, permitiendo a los jugadores interactuar y subir por ellas.

• Sintaxis: keysEnabled <verdadero/falso>
• Notas: Si está deshabilitado, podremos dibujar escaleras, pero no funcionarán como tales
• Para Cursed Zapatilla: Configuraremos keysEnabled a true, ¡claro que queremos escaleras en este tipo de juegos!.

messagesEnabled

Activa la visualización de mensajes de ayuda al entrar en contacto con items, puertas u otros elementos.

• Sintaxis: messagesEnabled <verdadero/falso>
• Notas: Muestra instrucciones o pistas cuando el personaje interactúa con objetos específicos.
• Para Cursed Zapatilla: Configuraremos messagesEnabled a true para guiar a los jugadores en su primera experiencia y, aprovechando la reciente posibilidad de editar y traducir textos, añadir algún que otro guiño.

useBreakableTile

Habilita la posibilidad de usar tiles rompibles, con opciones de comportamiento.

• Sintaxis: useBreakableTile <disabled/all/individual>
• Notas:
  • disabled: No hay tiles rompibles.
  • all: Todos los tiles rompibles de la habitación se destruyen al romper uno.
  • individual: Cada tile se rompe de forma independiente.
  • El tile rompible debe estar definido en la posición 63 del tileset.
• Para Cursed Zapatilla: Configuraremos useBreakableTile a individual para permitir romper lápidas en el cementerio de forma estratégica.

Parámetros del HUD

Parámetros que afectan al HUD, la tipica zona de marcadores de que dispondremos en el juego.

itemsEnabled

Si no está habilitado no se mostrará el marcador de items.

• Sintaxis: itemsEnabled <verdadero/falso>
• Notas: Controla la visibilidad del marcador de items. Si está deshabilitado, no se mostrará en el juego.
• Para Cursed Zapatilla: Estableceremos itemsEnabled a verdadero para mostrar el progreso del jugador en la recolección de items.

itemsCountdown

El marcador de items mostrará el número total de items que tiene que conseguir el jugador al principio del juego e irá descendiendo para que veas los items que te quedan por recoger.

• Sintaxis: itemsCountdown <verdadero/falso>
• Notas: Define la cantidad inicial de items que el jugador debe recoger, disminuyendo a medida que los recoge. Si está desactivado mostrara los items que llevamos recogidos hasta el momento.
• Para Cursed Zapatilla: Configuraremos itemsCountdown como verdadero para fomentar la exploración si no encontramos alguno de los requeridos para completar el juego.

Parámetros Gráficos

Estos parámetros nos permiten establecer diferentes elementos que afectan directamente al aspecto visual de nuestro juego:

backgroundAttribute

Color de fondo del juego en decimal en forma de atributos de Spectrum (128*FLASH + 64*BRIGHT + 8*PAPER + INK). Si no se define este atributo se pintará fondo negro sprites blancos. Si no acabas de tener claro como se calcula, puedes usar la calculadora siguiente 🌐🟡③

• Sintaxis: backgroundAttribute <valor_decimal>
• Notas: Establece el color de fondo y sprites usando atributos ZX Spectrum.
• Para Cursed Zapatilla: Configuraremos backgroundAttribute a 71 (fondo negro, tinta blanca, brillo activado) para un fondo negro clásico con sprites blancos brillantes, acorde al estilo del juego.

border

Color del borde in game. Muy útil cuando se cambia el color de fondo del juego y del hud.

• Sintaxis: border <color>
• Notas: Debe ser un color valido 0..15
• Para Cursed Zapatilla: Estableceremos border a black (0) para dar continuidad a la pantalla.

borderColorItem

Color del borde in game en el efectp que se produce al recoger un objeto.

• Sintaxis: border <color>
• Notas: Debe ser un color valido 0..15
• Para Cursed Zapatilla: Estableceremos border a morado (3) para dar continuidad a la idea de recoger flores de colores pero en estre caso menos intenso para reforzar la idea de que estamos en un cementerio (ya hacen suficiente el resto de colores por la intensidad).

borderColorKey

Color del borde in game en el efectp que se produce al recoger una llave.

• Sintaxis: border <color>
• Notas: Debe ser un color valido 0..15
• Para Cursed Zapatilla: Estableceremos border a amarillo intenso (14) para dar continuidad a la idea las llaves doradas tipicas de este tipo de juegos.

borderColorLife

Color del borde in game en el efectp que se produce al recoger un objeto que permite recuiperar vida.

• Sintaxis: border <color>
• Notas: Debe ser un color valido 0..15
• Para Cursed Zapatilla: Estableceremos border a rojo intenso (10) para dar continuidad a la asociación vida=sangre

paper

Color del papel in game. Muy útil cuando se cambia el color de fondo del juego y del hud.

• Sintaxis: paper <color>
• Notas: Define el color de fondo del juego y HUD. Debe ser un valor de color válido.
• Para Cursed Zapatilla: Configuraremos paper a 0 para un ambiente gótico nocturno, potenciando el contraste con las flores de colores.

ink

Color de la tinta in game. Muy útil cuando se cambia el color de fondo del juego y del hud.

• Sintaxis: ink <color>
• Notas: Establece el color de la tinta (texto o sprites) en el juego. Ideal para contraste; debe ser un valor de color válido.
• Para Cursed Zapatilla: Configuraremos ink a white (7) para que los elementos sean visibles sobre fondos oscuros.

mainCharacterExtraFrame

Si está habilitado, la animación del personaje usará el frame extra (haciendo total de 3 en movimiento a derecha e izquierda)

• Sintaxis: mainCharacterExtraFrame <verdadero/falso>
• Notas: Activa un frame adicional que debe configurarse en el tile XX del tileset.
• Para Cursed Zapatilla: Estableceremos mainCharacterExtraFrame a true para enriquecer las animaciones.

Parámetros Sonoros

Los parametros relacionados con, sobre todo la música, tomemos algunas decisiones iniciales ya afinamos mas adelante:

musicEnabled

Para habilitar o deshabilitar la música AY. Si se habilita la música el juego resultante sólo funcionará en 128K, para hacer una versión 48K tendrás que desmarcar guardar y volver a compilar.

• Sintaxis: musicEnabled <verdadero/falso>
• Notas: Activa o desactiva la música AY.
• Para Cursed Zapatilla: Estableceremos musicEnabled a true para una banda sonora rica, apuntando a la versión 128K. NdA: Tenia entendido que si pones musica AY y ejecutas en 48 el juego sigue funcionando pero sin musica, tengo que probar este particular.

newBeeperPlayer

Para utilizar en nuevo reproductor de beeper mejorado para que el juego se pare mucho menos mientras suena debes activar esta opción. IMPORTANTE: Si quieres aprovechar las bondades de este nuevo player debes hacer los sonidos como se indica en la sección de FX del manual 🌐🟡③.

• Sintaxis: newBeeperPlayer <verdadero/falso>
• Notas: Habilita o deshabilita un reproductor de beeper mejorado en nuestro juego para reducir interrupciones. Requiere seguir las guías de FX del manual para optimizar sonidos.
• Para Cursed Zapatilla: Configuraremos newBeeperPlayer a true y ajustaremos los FX según el manual para un rendimiento óptimo.

Parámetros de Rendimiento

Algunos parametros que nos permiten configurar algunos parametros sobre elementos que permitirán graduar la velocidad de nuestro juego.

animatePeriodEnemy

Número más alto, animación de los enemigos más lenta.

• Sintaxis: animatePeriodEnemy <número_de_periodo>
• Notas: Define la velocidad de animación de los enemigos. Un valor más alto ralentiza la animación; debe ser un número entero positivo.
• Para Cursed Zapatilla: Configuraremos animatePeriodEnemy a 5 para dar un movimiento más pausado a zombis y esqueletos, y afinaremos desde ahí.

animatePeriodMain

Número más alto, animación del personaje principal más lenta.

• Sintaxis: animatePeriodMain <número_de_periodo>
• Notas: Establece la velocidad de animación de Sir Patillas en Cursed Zapatilla. Un valor más alto reduce la velocidad; debe ser un número entero positivo.
• Para Cursed Zapatilla: Estableceremos animatePeriodMain a 3 para un movimiento fluido pero controlado.

animatePeriodTile

Número más alto, animación de los tiles más lenta.

• Sintaxis: animatePeriodTile <número_de_periodo>
• Notas: Controla la velocidad de animación de los tiles animados. Un valor más alto la ralentiza; debe ser un número entero positivo.
• Para Cursed Zapatilla: Configuraremos animatePeriodTile a 10 para un efecto sutil en el cementerio.

maxAnimatedTilesPerScreen

Máximo de tiles animados por pantalla (10 máximo). Si utilizas menos pon un valor más bajo para ahorrar espacio.

• Sintaxis: maxAnimatedTilesPerScreen <número_de_tiles>
• Notas: Define el número máximo de tiles animados. El valor máximo es 10.
• Para Cursed Zapatilla: Configuraremos `maxAnimatedTilesPerScreen a 20. Aunque el maximo oficial sea 10, en un intento de añadir animacion a cambio de velocidad de animacion de personaje princial y enemigos. Ajustaremos si es neceario (Y si el motor no nos reconfigura el numero XD)

maxEnemiesPerScreen

Se puede configurar la cantidad de enemigos que aparecen en pantalla (hasta 5). Evitar poner más de los que se usan para optimizar espacio.

• Sintaxis: maxEnemiesPerScreen <número_de_enemigos>
• Notas: Establece el número máximo de enemigos (e.g., zombis, esqueletos) por pantalla en Cursed Zapatilla. El límite es 5; usar menos mejora la optimización.
  • Para Cursed Zapatilla: Estableceremos maxEnemiesPerScreen a 7 para un desafío Interesante diseñando el escenario para minimizar el impacto de las "hordas" de enemigos.

Parámetros Extra

Esos pequeños detalles que están, son necesarios pero no encajan perfectamente en el resto de categorías.

redefineKeysEnabled

Habilita la opción de redefinir teclas.

• Sintaxis: redefineKeysEnabled <verdadero/falso>
• Notas: Activa la posibilidad de reasignar teclas en nuestro juego para personalizar los controles.
• Para Cursed Zapatilla: Configuraremos redefineKeysEnabled a true para ofrecer flexibilidad a los jugadores y sobre todo accesibilidad.

waitPressKeyAfterLoad

Si habilitas esta opción, tras la carga el juego esperará que pulses una tecla para mostrar el menú.

• Sintaxis: waitPressKeyAfterLoad <verdadero/falso>
• Notas: Hace que nuestro juego espere una pulsación de tecla tras cargar para mostrar el menú, mejorando la experiencia inicial.
• Para Cursed Zapatilla: Estableceremos waitPressKeyAfterLoad a true para un inicio controlado y dramático.

Paso 4: Verificación del proyecto

1. Prueba inicial en ZXGM:

   • Asegurate de guardar los cambios en Tiled, para que el compilador tenga oportunidad de tenerlos en cuenta.

   • Ve a Game/Build en el GUI y ejecuta la compilación.

   • Si no hay errores, se generará cursed-zapatilla.tap en cursed-zapatilla/dist.

2. Prueba en emulador:

   • Abre el emulador de ZX Spectrum de tu elección.
   • Carga CursedZapa.tap.
   • Verifica que el juego carga (sin Sir Patillas ni enemigos personalizados aún).

En la nueva versión, en 128K no me ha dado problemas, si te los da a ti o en 48K te ocurre el proximo capítulo trata esta cuestión.

Mi comprobación no ha ido todo lo bien que esperaba, toca mejorar:

Como en mi caso me he pasado de largo y he llenado la memoria antes de comenzar, en el próximo capítulo, averiguaremos que funciones son las que más memoria consumen y cuales menos de forma que podamos afinar la configuración.

Solución de problemas comunes

• Interfaz de ZXGM no carga: Verifica Python (python3 --version) y ejecuta el script de instalación nuevamente.
• Errores en Tiled: Asegúrate de usar versión 1.11.2+ y que maps.tiled-project sea compatible. Consulta la documentación de ZXGM.
• Build falla: Revisa logs en la terminal o en output. Verifica que src no esté modificado y que Boriel Basic/GuSprites estén presentes.

Consulta el grupo de Telegram de ZXGM o la documentación en el repositorio para soporte adicional.

Conclusión

Has configurado la base de Cursed Zapatilla: La Excéntrica Cruzada de Sir Patillas con una estructura de proyecto y una plantilla inicial en Tiled.

Como escultores, hemos dado el primer golpe al cincel, preparando la piedra para tallarla en capítulos futuros, donde añadiremos sprites personalizados (Sir Patillas, zombis), mecánicas de zapatillazos, y más. ¡Sigue adelante y comienza a dar forma a tu juego retro!

No obstrante, hemos roto el martillo y el escoplo con la lista de la compra, así que nos toca iterar para mejorar el proceso, lo cual veremos en el próximo capítulo, aprovechando la oportunidad para aprender sobre las limitaciones del motor en tanto funcionalidad vs memoria.

Referencias Bibliográficas

• Mis pruebas de campo ⚫①
• 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-12-25 20:46:35.951000+00:00
• Versión Documento: 0.2.20