Documentacion de software Abyssal Gaze

Abyssal Gaze Documentación de software Versión 1.0

Índice Acerca de este documento ..................................................................................................................4 I. Información general.........................................................................................................................5 1.1 Nombre del videojuego .............................................................................................................5 1.2 Descripción general ...................................................................................................................5 1.3 Género y modalidad ..................................................................................................................5 1.4 Plataforma ................................................................................................................................5 1.5 Público objetivo y clasificación ESRB ...........................................................................................5 II. Concepto y narrativa.......................................................................................................................6 2.1 Concepto del videojuego ...........................................................................................................6 2.2 Historia y argumento.................................................................................................................6 2.3 Ambientación............................................................................................................................6 2.4 Inspiraciones y referencias .........................................................................................................7 III. Personajes.....................................................................................................................................8 3.1 Protagonista .............................................................................................................................8 3.2 Habilidades ...............................................................................................................................8 3.3 Enemigos ..................................................................................................................................8 3.4 Jefes (Bosses) ............................................................................................................................9 IV. Mecánicas de juego ..................................................................................................................... 10 4.1 Movimiento y salto.................................................................................................................. 10 4.2 Sistema de dash ...................................................................................................................... 10 4.3 Sistema de combate ................................................................................................................ 10 4.4 Vida y daño ............................................................................................................................. 10 4.5 Sistema Boss Rush................................................................................................................... 11 4.6 Progresión y mejoras ............................................................................................................... 11 V. Diseño de niveles.......................................................................................................................... 12 5.1 Estructura de niveles ............................................................................................................... 12 5.2 Diseño de escenarios ............................................................................................................... 12 5.3 Plataformas y obstáculos ......................................................................................................... 14 5.4 Arenas de jefes........................................................................................................................ 15 VI. Dirección artística ........................................................................................................................ 17 6.1 Estilo visual ............................................................................................................................. 17 6.2 Paleta de colores..................................................................................................................... 17 6.3 Logotipo e identidad visual ...................................................................................................... 17 6.4 Diseño de escenarios y personajes ........................................................................................... 18

6.5 Efectos visuales....................................................................................................................... 19 VII. Interfaz y controles ..................................................................................................................... 20 7.1 Controles táctiles .................................................................................................................... 20 7.2 Joystick y botones ................................................................................................................... 20 7.3 Interfaz de combate (HUD) ...................................................................................................... 21 7.4 Menús y pantallas ................................................................................................................... 21 VIII. Diseño de audio ......................................................................................................................... 24 8.1 Música ambiental .................................................................................................................... 24 8.3 Efectos de sonido .................................................................................................................... 24 IX. Diseño técnico ............................................................................................................................. 25 9.1 Motor de desarrollo ................................................................................................................ 25 9.2 Lenguaje de programación....................................................................................................... 25 9.3 Herramientas utilizadas ........................................................................................................... 25 9.4 Arquitectura del software ........................................................................................................ 25 9.5 Gestión de datos y recursos ..................................................................................................... 26 X. Flujo de juego............................................................................................................................... 27 10.1 Inicio del juego...................................................................................................................... 27 10.2 Menú principal ...................................................................................................................... 27 10.3 Desarrollo de una partida....................................................................................................... 27 10.4 Victoria y derrota .................................................................................................................. 28

Acerca de este documento Este documento describe el desarrollo de Abyssal Gaze como un juego de plataformas 2D: desde la idea inicial y los bocetos hasta la validación automatizada. Reúne la visión general del proyecto, las mecánicas y reglas del juego, las pantallas y su flujo, la identidad visual (bocetos, logotipo y paleta) y las decisiones de diseño que llevaron del papel al build (la versión ejecutable del juego). Cada cifra proviene del código y de las suites de prueba, y las capturas del juego provienen del build real en Godot 4.7.2. Los bocetos y diagramas se identifican como tales en su pie de figura.

I. Información general 1.1 Nombre del videojuego El videojuego se llama Abyssal Gaze (en español, «Mirada abisal»). El nombre sigue la narrativa del juego, cuya premisa es que «si miras largo tiempo a un abismo, el abismo también mira dentro de ti» (véase la sección 2.2). 1.2 Descripción general Abyssal Gaze es un juego de acción y plataformas 2D de fantasía oscura. El jugador controla al último Centinela de la Orden de la Penumbra, enviado a investigar el Pozo y acabar con los tres reyes corrompidos. A través de escenarios, inscripciones y diálogos crípticos, descubre el origen de la catástrofe y los secretos de quienes intentaron detenerla. Su progresión está ligada a la corrupción: cuanto más poder obtiene, más se acerca a convertirse en aquello que combate. La versión actual es un vertical slice (una porción jugable y acotada del juego): un nivel con forma de torre quebrada y una arena de combate con un jefe, el Guardián del Abismo. El jugador recorre la torre, recoge esencia, mejora al Centinela en un santuario y cruza un sello para enfrentarse al jefe. 1.3 Género y modalidad • Género: plataformas 2D con temática metroidvania (estilo de juego de exploración en el que el personaje obtiene mejoras), enfocado en la fantasía oscura. Incluye un sistema de Boss Rush (enfrentamientos contra jefes) combinado con mecánicas de completar niveles y conseguir objetos de mejora. • Modalidad: un jugador (single player), en tiempo real y con control táctil. El juego no es multijugador y no se prevé que lo sea por el momento: las mecánicas y la historia están pensadas para una sola persona. 1.4 Plataforma La plataforma objetivo es Android, como aplicación nativa (archivo APK ejecutable e instalable en teléfonos móviles) con control táctil. Además, el personaje se controla con teclado y ratón, y el código contempla comportamientos específicos para la versión web y para Android (véase 7.4). El juego está desarrollado en Godot con el lenguaje GDScript, motor que cuenta con un emulador de Android para teléfono. En su estado actual, la aplicación aún no se ha probado en un teléfono. La exportación a Android y las pruebas en dispositivo están pre vistas para una etapa posterior. 1.5 Público objetivo y clasificación ESRB Clasificación ESRB: E (Everyone / Todo público), apta para todas las edades. El juego no contiene violencia gráfica, sangre ni lenguaje inapropiado. Al completar su desarrollo, deberá conservar la clasificación ESRB E.

II. Concepto y narrativa 2.1 Concepto del videojuego Abyssal Gaze nace como un videojuego de plataformas 2D que combina tres ideas principales: • Jefes imponentes y muy desafiantes, con una estructura de Boss Rush. • Combate de ritmo frenético, basado en dashes (impulsos rápidos) y movimientos continuos. • Niveles progresivos, en los que el jugador avanza por diferentes escenarios mientras mejora a su personaje. La esencia es el recurso que permite elegir qué clase de héroe será el jugador: no hay suficiente esencia para maximizar todas las mejoras, de modo que cada partida exige decidir qué tipo de personaje se quiere construir. 2.2 Historia y argumento La historia gira en torno a la premisa: «Si miras largo tiempo a un abismo, el abismo también mira dentro de ti». Mucho antes de los acontecimientos del juego, un objeto desconocido cae del cielo en medio de un reino. Su impacto abre una enorme cavidad en la tierra, conocida después como el Pozo. De sus profundidades comienza a emanar una energía maldita que poco a poco corrompe a los habitantes, transforma criaturas y sume al reino en el caos. Tres antiguos reyes intentan detener la amenaza descendiendo al Pozo, pero terminan consumidos por su poder y se convierten en los principales responsables de extender la corrupción. Ante la desesperación, la Orden de la Penumbra decide enviar a su último Centinela, un guerrero que ha demostrado una resistencia excepcional frente a la influencia del Pozo. Su misión es investigar su origen, derrotar a los tres reyes y detener la catástrofe antes de que destruya todo lo que queda del reino. Durante su recorrido, el protagonista comienza a absorber las esencias de los reyes derrotados y obtiene nuevas habilidades a costa de su propia humanidad: su armadura se fractura, su sombra cambia y su cuerpo empieza a reflejar la misma corrupción que combate. El desenlace revela que los reyes se habían convertido en recipientes de aquella presencia y que, al absorber sus esencias, el protagonista ha heredado su destino. Aunque consigue detener la amenaza inmediata, termina ocupando el lugar de aquello que juró destruir. 2.3 Ambientación El mundo es de fantasía oscura: una torre quebrada de 4400 píxeles, pozos, plataformas, niebla y motas de luz. El jugador recorre la torre, encuentra un santuario para mejorar al Centinela y cruza un sello que exige una ofrenda para abrir la arena del jefe. La narración se transmite mediante escenarios, inscripciones y diálogos crípticos. La atmósfera es sombría y misteriosa, y la esencia es el recurso que permite elegir qué clase de héroe será el jugador. El diseño visual de los escenarios se describe en las secciones 5.2 y 6.1.

2.4 Inspiraciones y referencias El proyecto se inspira en tres juegos de referencia, de cada uno de los cuales toma un elemento distinto: Tabla 2.1. Juegos de referencia Juego Elemento adoptado Eldest Souls La temática de Boss Rush, con jefes imponentes y muy desafiantes. ScourgeBringer El ritmo de combate frenético, basado en dashes y movimientos continuos. Dead Cells El sistema de niveles progresivos, en el que el jugador avanza por diferentes escenarios mientras mejora a su personaje.

III. Personajes 3.1 Protagonista El protagonista es el Centinela, el último miembro de la Orden de la Penumbra y el elemento que controla el jugador. Se define como un personaje misterioso y reservado, con una resistencia excepcional frente a la influencia del Pozo. Su aspecto es oscuro: lleva un casco, un traje oscuro y una capa morada rasgada (Figura 3.1). Es la única figura del juego con un sprite animado (imagen de personaje animada cuadro a cuadro), que corresponde a su postura de reposo; el resto del mundo y los enemigos son formas geométricas. Figura 3.1. Sprite del Centinela, protagonista del juego. 3.2 Habilidades El Centinela dispone de las siguientes habilidades: • Dash: un impulso rápido para esquivar y atacar, y también para moverse más rápido. Véase 4.2. • Ataque con arco de luz: el arma del Centinela emite un arco de luz que golpea cerca del personaje. Se prevé agregar una espada como arma visible: el personaje ya puede eliminar enemigos, pero todavía no tiene una animación ni un objeto asociado a ese ataque. Véase 4.3. • Mejoras con esencia: el jugador puede aumentar su fuerza (ataque), su velocidad de dash y su vida con la esencia que recoge. Véase 4.6. • Interacción: el personaje interactúa con objetos del nivel, como el santuario. • Poderes de los jefes (previsto): tras derrotar a un jefe, el Centinela consume su poder oscuro y obtiene una de sus habilidades. Véase 4.5. 3.3 Enemigos Los enemigos actuales son formas geométricas de colores distintos, para que se reconozcan a simple vista. Dañan al jugador al tocarlo y sueltan esencia al ser derrotados.

Tabla 3.1. Tipos de enemigos Enemigo Comportamiento Patrulleros Recorren las plataformas de un lado a otro y dañan al tocar al jugador. Perseguidores Detectan al Centinela y lo persiguen dentro de un rango. Figura 3.2. Enemigo patrullero. Figura 3.3. Enemigo perseguidor. 3.4 Jefes (Bosses) El Guardián del Abismo es el jefe actual y el jefe final del vertical slice. Es una figura geométrica con un ojo que dispara proyectiles dirigidos al jugador. Cuando le queda la mitad de su vida, se vuelve más agresivo: dispara más rápido y cambia de color. Según la captura de la arena (Figura 5.11), tiene 500 puntos de vida. Hoy es un jefe funcional para probar el combate, no el combate final que promete la historia: el guion plantea tres reyes como jefes imponentes que el Centinela debe derrotar uno por uno (véase 2.2). Figura 3.4. Guardián del Abismo, jefe actual del juego.

IV. Mecánicas de juego 4.1 Movimiento y salto El personaje se controla de varias formas para que funcione tanto en teléfono como en teclado: un joystick, arrastrar el dedo, y las teclas A/D y las flechas. También salta, hace un impulso rápido para esquivar, ataca e interactúa con objetos. El esquema completo se describe en 7.1. • En la torre hay gravedad: el personaje puede caer en pozos y morir. • En la arena no hay gravedad: el personaje se mueve libremente dentro de la pantalla. • En ambos casos, el personaje no puede salir del encuadre. El salto se activa con un toque cuando no hay nada con qué interactuar ni a quién atacar. Las plataformas de un solo sentido se describen en 5.3. 4.2 Sistema de dash El dash es la habilidad principal del Centinela: un impulso rápido que sirve para esquivar los ataques, atacar y moverse más rápido. Se activa con un deslizamiento rápido en la parte derecha de la pantalla y funciona como esquiva: mientras dura, el personaje no recibe daño. Tiene un tiempo de recarga, que la rama de mejora «Dash» reduce 0,05 s por nivel (véase 4.6). 4.3 Sistema de combate El ataque es un arco de luz que golpea cerca del personaje. Tiene una pequeña espera entre golpes, por lo que no se puede atacar sin parar. Los enemigos dañan al tocar al jugador, pero solo una vez por segundo para que el daño no resulte injusto. En la arena, el jugador debe leer cada proyectil, esquivar con movimiento o con dash, acercarse y castigar en el momento correcto. El ataque se activa con un toque cuando no hay nada con qué interactuar. 4.4 Vida y daño • Vida inicial: el jugador comienza con 100 puntos de vida (HUD, Figura 7.2). La mejora de vitalidad suma 25 puntos por nivel; en Figura 5.11 se observa una vida máxima de 125. • Daño por contacto: los enemigos dañan al tocar al jugador, como máximo una vez por segundo. • Obstáculos: caer en un pozo o tocar los pinchos quita vida y puede matar al jugador. • Dash: mientras dura, el personaje no recibe daño. • Muerte en la torre: el jugador reaparece hasta vencer. • Muerte en la arena: la partida se detiene, se guarda el récord y un toque reinicia la arena. • Vidas: el personaje tiene una sola vida por partida; si muere o pierde toda su barra de vida, vuelve al principio, desde el inicio.

4.5 Sistema Boss Rush El Boss Rush, es decir, la sucesión de enfrentamientos contra jefes imponentes y desafiantes, es el eje del juego y se combina con la exploración de niveles y la obtención de mejoras. • Acceso a la arena: el sello final de la torre exige haber encontrado el santuario y comprado al menos una mejora. Al cruzarlo, el juego guarda el progreso y pasa a la arena del jefe. • Combate: en la arena no hay gravedad; el jefe dispara proyectiles y se vuelve más agresivo cuando le queda la mitad de su vida. • Victoria: al derrotar al jefe, se suma un jefe derrotado, se guardan la vida restante y el récord, y se limpian los proyectiles. • Jefes actuales y previstos: el vertical slice incluye un único jefe, el Guardián del Abismo. El guion prevé tres reyes (véase 3.4). • Ciclo previsto: tras explorar el nivel y mejorar sus habilidades, el Centinela elimina al jefe del nivel, consume su poder oscuro, obtiene una de sus habilidades y continúa con el siguiente nivel y el siguiente jefe, y así sucesivamente (véase 10.3). 4.6 Progresión y mejoras La esencia es el recurso del juego: se recoge en el nivel y se obtiene de los enemigos. En el santuario se gasta en tres ramas de mejora, cada una con varios niveles. No hay suficiente esencia para maximizar todo, así que el jugador debe elegir qué tipo de personaje quiere ser. Las mejoras son permanentes, se guardan y se mantienen al pasar a la arena. Tabla 4.1. Ramas de mejora del santuario (valores mostrados en Figura 7.11) Rama Efecto por nivel Niveles Coste inicial de esencia Ataque +6 de daño 5 25 (el coste aumenta con cada nivel) Dash −0,05 s de recarga 5 20 (el coste aumenta con cada nivel) Vitalidad +25 HP 5 30 (el coste aumenta con cada nivel) El nivel de cada mejora se muestra en el HUD (véase 7.3). Además de la esencia, el juego puntúa la obtención de las almas y los poderes de los jefes derrotados (véase RF-03), y guarda un récord (véase 9.5).

V. Diseño de niveles 5.1 Estructura de niveles El nivel actual es una torre quebrada de 4400 píxeles, con suelos, plataformas, pozos, pinchos, enemigos y esencias. El jugador avanza de izquierda a derecha. Hay puntos de descanso donde reaparece si muere, un santuario a mitad del camino y, al final, un sello que exige haber encontrado el santuario y comprado al menos una mejora para abrirse. Al cruzar el sello, el juego guarda el progreso y pasa a la arena del jefe. Las figuras 5.1 y 5.2 muestran el mapa del nivel en dos tramos. Los marcadores turquesa (INICIO y SELLO 2 a SELLO 4) señalan los puntos de descanso, que el juego llama «sello de descanso»; el santuario aparece a mitad del recorrido y el sello final, en dorado, al final. Figura 5.1. Mapa de la torre, tramo inicial: de INICIO a SELLO 2. Figura 5.2. Mapa de la torre, tramo final: SELLO 3, Santuario, SELLO 4 y sello final. 5.2 Diseño de escenarios El escenario se dibuja con formas y líneas, no con imágenes de fondo. Tiene cuatro capas: cielo con luna eclipsada, un mundo lejano, un mundo cercano, y niebla con motas animadas. La arena del jefe reutiliza el mismo estilo para que todo se sienta como un mismo mundo. El diseño guarda relación con la paleta de colores y la temática del juego (véase 6.2).

Bocetos iniciales. Antes de la implementación se bocetaron la pantalla de juego (Figura 5.3), la zona de mejora de habilidades dentro del nivel (Figura 5.4) y el portal hacia el jefe (Figura 5.5). Figura 5.3. Boceto inicial de la pantalla de juego: fondo de temática oscura, personaje principal, enemigos, plataformas, fragmentos de mejora y botón de pausa. Figura 5.4. Boceto inicial de la zona de mejora de habilidades dentro del nivel. Figura 5.5. Boceto inicial del portal hacia el jefe. Implementación actual. La Figura 5.6 muestra el nivel en el build, con el Santuario de Esencia y un punto de descanso.

Figura 5.6. Captura del nivel en el build: Santuario de Esencia, sello de descanso grabado y HUD. Fondos con movimiento. Hasta el momento hay dos fondos creados en HTML y CSS, con movimiento, para luego pasarlos a Godot: uno muestra el exterior de un castillo y el otro, el interior de unas ruinas. Se prevé usar sus efectos de partículas en algún fondo del juego (véase 6.5). Figura 5.7. Fondo 1: vista exterior del castillo. Figura 5.8. Fondo 2: interior de las ruinas. 5.3 Plataformas y obstáculos Las plataformas son de un solo sentido: el jugador puede saltar a través de ellas desde abajo, pero no caer a través desde arriba. Los pozos y los pinchos son los obstáculos principales: caer en un pozo o tocar los pinchos quita vida y puede matar al jugador. Los enemigos patrullan sobre las plataformas (véase 3.3).

Figura 5.9. Captura del nivel: plataformas de un solo sentido, enemigos, esencias y pozo. 5.4 Arenas de jefes La arena es un espacio sin gravedad donde el jugador se mueve libremente dentro de la pantalla. El jefe dispara proyectiles y se vuelve más agresivo cuando le queda la mitad de su vida. El fondo mantiene el mismo estilo oscuro que el resto del juego. La Figura 5.10 muestra el boceto inicial y la Figura 5.11, la arena en el build. Figura 5.10. Boceto inicial de la arena del jefe: fondo de temática oscura, personaje principal, proyectiles, jefe del final de nivel y botón de pausa.

Figura 5.11. Captura de la arena en el build: barra de vida del Guardián del Abismo (500/500), puntuación, vida del jugador y joystick.

VI. Dirección artística 6.1 Estilo visual El juego usa un estilo de fantasía oscura, con una dinámica y un diseño coherentes con esa temática. La identidad gráfica se define como pixel art (arte compuesto por píxeles visibles). En el build actual, casi todo se dibuja con código mediante formas geométricas, líneas y colores sobrios en lugar de imágenes detalladas, lo que mantiene el tono sombrío y hace que el juego pese poco. 6.2 Paleta de colores La paleta oficial del proyecto tiene cinco colores. Predominan los tonos oscuros, como se aprecia en el logotipo, porque la ambientación del juego lo exige. Tabla 6.1. Paleta de colores oficial de Abyssal Gaze 6.3 Logotipo e identidad visual Desde el inicio, el logotipo debía representar la esencia de un juego de fantasía oscura: reflejar una atmósfera sombría y misteriosa e incorporar al personaje principal o algún rasgo característico de este. El logotipo se desarrolló en tres etapas: • Boceto a lápiz (Figura 6.1): una letra «A» con forma de triángulo, un objeto o prenda característica del personaje y una «A» rasgada, con el nombre del juego como elemento opcional. • Versiones con inteligencia artificial (Figura 6.2 y Figura 6.3): se pidió a una IA que creara un logo como el boceto, con mejores detalles, y tras varios intentos se obtuvieron estos resultados. • Versión final (Figura 6.4 y Figura 6.5): tras los arreglos de la CM Lisbeth Ramirez, se obtuvo la marca final: casco, triángulo y filo violeta. En el menú del juego no se usa la imagen del logotipo: el título se escribe con la tipografía Cormorant Garamond (véase 7.4). Muestra Código #bf6bcd #ab00fc #250a37 #cab7cd #000000

Figura 6.1. Boceto inicial del logotipo: letra «A» inicial del juego, prenda característica del personaje, «A» rasgada y nombre del juego (opcional). Figura 6.2. Logotipo generado con IA, versión sin nombre. Figura 6.3. Logotipo generado con IA, versión con nombre. Figura 6.4. Logotipo final: emblema. Figura 6.5. Logotipo final: emblema con el nombre del juego. 6.4 Diseño de escenarios y personajes Los escenarios y los enemigos se dibujan con formas y colores para que se reconozcan a simple vista. El único personaje con imágenes importadas es el Centinela, que tiene un sprite animado para su postura

de reposo (Figura 3.1). El resto del mundo y los enemigos (Figura 3.2 y Figura 3.3) son formas geométricas, y el jefe actual es una figura geométrica con un ojo (Figura 3.4). Los escenarios y sus bocetos se describen en el capítulo V, y la dirección de color en 6.2. 6.5 Efectos visuales • Niebla y motas de luz animadas: la capa más cercana del escenario combina niebla con motas animadas (véase 5.2). • Cambio de color del jefe: el Guardián del Abismo cambia de color cuando se vuelve más agresivo (véase 3.4). • Fondos con movimiento y partículas: los dos fondos creados en HTML y CSS tienen movimiento completo con partículas. Se prevé implementarlas en algún fondo del juego, ya sea para un jefe o como fondo de niveles (Figura 5.7 y Figura 5.8).

VII. Interfaz y controles 7.1 Controles táctiles Todos los gestos se traducen en acciones simples. El esquema táctil combina un joystick en la parte izquierda de la pantalla con gestos en la parte derecha, que se usan para el dash (deslizamiento o drag). Tabla 7.1. Gestos y acciones Gesto o entrada Acción Toque (tap) Intenta primero interactuar; si no hay nada con qué interactuar, ataca; y si tampoco hay a quién atacar, salta. Arrastre (drag) Mueve al personaje. Deslizamiento rápido (swipe) Activa el impulso (dash). Joystick circular Mueve al personaje. Disponible en la torre y en la arena (donde el movimiento es sin gravedad). Teclado A/D y flechas para moverse; E para interactuar con el santuario; 1, 2 y 3 para comprar mejoras; ESC para cerrar el santuario. En la torre se puede usar un joystick circular, arrastrar o el teclado. En el santuario, también se puede elegir con el ratón o con un toque. 7.2 Joystick y botones El joystick es virtual y circular, y se ubica en la parte izquierda de la pantalla (Figura 7.1). Solo consume los toques que empiezan dentro de su zona, así que los toques en el resto de la pantalla siguen llegando al juego. En la arena, el joystick permite moverse sin gravedad. Las acciones de ataque, salto y dash se realizan mediante gestos, no mediante botones en pantalla. Los botones de los menús no bajan del tamaño mínimo para tocarlos con el dedo. Figura 7.1. Joystick virtual de movimiento.

7.3 Interfaz de combate (HUD) El HUD (Heads-Up Display, la información que se muestra sobre la pantalla durante la partida) presenta en la torre: • la vida (HP) con su barra (Figura 7.3); • la esencia abisal recogida y el nivel de las tres mejoras: ataque, dash y vitalidad (Figura 7.4 y Figura 7.5); • el objetivo actual, los avisos temporales y los cuadros por segundo (FPS). Todos estos elementos son solo informativos: no roban los toques ni bloquean los gestos. El objetivo cambia solo según el progreso: encontrar el santuario, comprar una mejora, cruzar el sello. Así, el jugador siempre sabe qué hacer sin necesidad de un tutorial. Figura 7.2. HUD en la torre: vida, esencia abisal, nivel de las mejoras, objetivo actual, FPS y joystick. Figura 7.3. Vida (HP) y su barra. Figura 7.4. Esencia abisal y mejoras. Figura 7.5. Nivel de las tres mejoras. En la arena, el HUD muestra el nombre y la barra de vida del jefe, la puntuación, los FPS y la vida del jugador en la esquina inferior izquierda (véase Figura 5.11). 7.4 Menús y pantallas Menú principal. Tiene tres opciones reales: Nuevo juego, Ajustes y Salir (Figura 7.7). «Salir» cierra el juego; en web muestra un aviso y en Android el botón atrás cierra primero los paneles abiertos. El menú se adapta a distintos tamaños de pantalla y ningún botón baja del tamaño mínimo para tocarlo con el dedo. El boceto inicial (Figura 7.6) incluía además una opción «Continuar». El título se escribe con la tipografía Cormorant Garamond.

Figura 7.6. Boceto inicial de la pantalla de inicio (menú principal). Figura 7.7. Menú principal en el build. Ajustes. Abre un panel dentro del mismo menú con tres deslizadores de volumen (general, música y efectos) que cambian el sonido real y se guardan solos (Figura 7.8). Figura 7.8. Panel de ajustes con los tres deslizadores de volumen. Confirmación de nueva partida. Si ya hay progreso guardado, «Nuevo juego» pregunta antes de borrarlo (Figura 7.9). Figura 7.9. Diálogo de confirmación: «Ya existe una partida guardada. Si empiezas de nuevo, se perderá el progreso actual.» Santuario de esencia. Al interactuar con el santuario, el juego se pausa y muestra un menú con las tres ramas de mejora y la esencia disponible (Figura 7.11). Se cierra con ESC o con el botón «Cerrar». El

boceto inicial (Figura 7.10) planteaba tres mejoras llamadas Fuerza, Velocidad y Resistencia, con valores ilustrativos. Figura 7.10. Boceto inicial del santuario de mejora. Figura 7.11. Santuario de esencia en el build. Menú de pausa. El boceto inicial (Figura 7.12) plantea un menú con las opciones Continuar, Ajustes y Salir, sobre un fondo difuminado. Figura 7.12. Boceto inicial del menú de pausa.

VIII. Diseño de audio El audio del menú se crea dentro del juego y se enruta a dos buses de audio (canales de mezcla): uno para la música y otro para los efectos. Los tres deslizadores de volumen del menú (general, música y efectos) cambian el volumen real y se guardan automáticamente (véase Figura 7.8 en la sección 7.4). 8.1 Música ambiental El menú principal tiene un sonido ambiental propio: un zumbido grave en bucle, que se enruta al bus de música. 8.3 Efectos de sonido Los botones del menú tienen un clic de piedra (descrito también como un «tic» al presionar una opción), que se enruta al bus de efectos. El juego en sí todavía no tiene sonidos de golpes, saltos o esencia: es una de las tareas pendientes.

IX. Diseño técnico 9.1 Motor de desarrollo El juego está hecho en Godot 4.7.2 y usa el renderer GL Compatibility, pensado para que funcione en muchos equipos, incluidos los móviles. Aunque el motor incluye físicas 3D (Jolt), este proyecto es 2D y no las usa. 9.2 Lenguaje de programación El lenguaje es GDScript, el lenguaje de programación propio de Godot. 9.3 Herramientas utilizadas • Godot 4.7.2: motor y editor del juego; las capturas del build provienen de esta versión. • Emulador de Android de Godot: previsto para las pruebas en teléfono (véase 1.4). • HTML y CSS: se usaron para crear los dos fondos con movimiento que luego se pasarán a Godot (véase 5.2). • Suites de prueba automatizadas: validan las cifras del juego (véase RNF-08). • Inteligencia artificial: se usó una herramienta de IA para generar versiones del logotipo (véase 6.3). • Cormorant Garamond: tipografía del título del menú. 9.4 Arquitectura del software El juego se arma con escenas (archivos que contienen nodos) y scripts (la lógica). El código está organizado por responsabilidades: cada parte del juego tiene su propio script (el jugador, los enemigos, el santuario, el sello, el jefe y la arena), y cada script hace una cosa y avisa a los demás mediante señales cuando algo cambia. La Figura 9.1 muestra la carpeta de scripts. • GestureManager: un script aparte que convierte los toques y el ratón en acciones (toque, arrastre y deslizamiento). • SaveSystem: el script que se encarga de leer y escribir el guardado. • Jugador compartido: el jugador es una escena compartida por la torre y la arena, con una opción (platformer_mode) que cambia su comportamiento entre plataformas y arena. • Capas de colisión: separan el mundo, el jugador, el jefe y los enemigos, para que cada uno interactúe solo con lo que debe. • Física y dibujo: la física corre a 60 Hz (60 veces por segundo) y el dibujo sigue al monitor. • Pausa del santuario: el santuario pausa el juego pero sigue respondiendo porque su nodo está configurado para funcionar siempre.

Figura 9.1. Estructura de carpetas del proyecto en Godot (panel «Sistema de Archivos»): recursos (assets), escenas (scenes), scripts, shaders, pruebas (tests) y archivos de configuración. 9.5 Gestión de datos y recursos El progreso y los ajustes se guardan en dos archivos dentro de la carpeta de usuario: Tabla 9.1. Archivos de datos del juego Archivo Contenido save_data.json Esencia, mejoras, si se alcanzó el santuario, nivel actual, vida, récord y jefes derrotados. settings.cfg Volúmenes de audio: general, música y efectos. first_level.json Datos del primer nivel; el flujo de arranque lo carga antes de entrar a jugar (Figura 10.2). Si se abre un guardado antiguo, el juego completa los campos que faltan para no romper partidas anteriores. Cada suite de prueba hace una copia de seguridad de ambos archivos de guardado y los restaura al terminar. En cuanto a los recursos gráficos, casi todo se dibuja con código; el único recurso importado es el sprite animado del Centinela (véase 6.4). Los fondos de HTML y CSS están pendientes de pasarse a Godot (véase 5.2).

X. Flujo de juego 10.1 Inicio del juego El juego arranca en el menú principal. Al elegir «Nuevo juego», se escribe una partida limpia (esencia 0, mejoras 0, vida completa). Si ya hay progreso guardado, primero pregunta antes de borrarlo (véase Figura 7.9). Al entrar al nivel, se carga el guardado y se aplica lo que el jugador ya tenía. Actualmente, el jugador entra al juego, ve el menú, presiona «Nuevo juego» y pasa automáticamente a la partida. Se prevé que, al iniciar una partida, aparezca una cinemática con lo que pasó en la ciudad y todo el lore (historia de fondo) del juego, y que luego el jugador entre al nivel. 10.2 Menú principal Desde el menú principal el jugador elige entre tres opciones: «Nuevo juego» inicia la partida (véase 10.1); «Ajustes» abre el panel de volumen; y «Salir» cierra el juego. La descripción de cada pantalla se encuentra en 7.4. 10.3 Desarrollo de una partida El jugador recorre la torre, supera pozos y enemigos, recoge esencia y llega al santuario para mejorar al Centinela. Luego cruza el sello, que exige haber encontrado el santuario y comprado al menos una mejora, y pasa a la arena del jefe. Durante la partida se muestran la vida, la esencia, las mejoras y el objetivo actual (véase 7.3). El flujo previsto del juego completo (Figura 10.1) es el siguiente: Menú principal (Nueva partida), inicio de partida con acceso directo al nivel, cinemática introductoria (historia y acontecimientos de la ciudad), exploración del nivel (combate, investigación y descubrimientos), mejora de habilidades (fortalecimiento del personaje), enfrentamiento contra el jefe, absorción del poder oscuro (obtención de poder y de una habilidad) y siguiente nivel (nuevo escenario y nuevo jefe). Figura 10.1. Diagrama de flujo del guion de juego previsto. Además, la Figura 10.2 muestra el flujo técnico actual: desde el arranque y el menú hasta el bucle de juego. Al cargar el nivel, se lee el guardado, se aplican las mejoras y se construye el mundo. En cada ciclo de física (60 Hz) se leen el teclado, el joystick y los gestos; se mueven el jugador, los enemigos, los objetos y la cámara; se aplica el daño cuando hay impacto (con tiempo de espera o cuadros de invulnerabilidad); y se actualizan el jefe, las animaciones, el HUD y la puntuación. Si la vida llega a 0 o el jugador cae al vacío, el juego reaparece al jugador en el último punto de descanso (torre) o muestra el panel de resultado (arena). Si el santuario está abierto, el juego se pausa.

Figura 10.2. Diagrama de flujo del juego actual (menú, carga del nivel y bucle de juego). 10.4 Victoria y derrota • Derrota en la torre: si el jugador muere, reaparece en el último punto de descanso. • Derrota en la arena: la partida se detiene, se guarda el récord y un toque reinicia la arena. • Victoria: si el jugador derrota al jefe, se suma un jefe derrotado, se guardan la vida restante y el récord, y se limpian los proyectiles.