Saltar al contenido
GALIOUSCómo se hizo

Un clásico de MSX de 1987 desmontado pieza a pieza, medido en el emulador y vuelto a construir en Unity con el arte, la música y la sensación de Hollow Knight.

Proyecto educativo de rldona · Cómo se hizo

1 + 10castillo y mundos
321salas de la ROM
53tipos de enemigo, más 25 hijos
10jefes con su palabra
192pruebas EditMode
~860FPS de media sin límite (M1 Pro)
Descender
I · LA IDEA

La idea y el método

Aprender cómo está hecho un juego por dentro: abrir la ROM, medirlo todo y rehacerlo en un motor moderno sin traducir ni una línea de ensamblador.

El original

Knightmare II: The Maze of Galious (Konami, MSX, 1987) es un laberinto de salas fijas: un castillo de 147 salas y 10 mundos con llave, lápida, palabra y jefe. Dos personajes, Popolon y Aphrodite, recorren el castillo buscando objetos, flechas, monedas y llaves para abrir mundo tras mundo.

Todo cabe en una ROM de 128 KB repartida en bancos que se paginan, con un bucle de juego a unos 30 ciclos por segundo.

El remake

Galious: The Hollow Kingdom conserva la base y las reglas de Galious (física, salas, enemigos, jefes, santuarios y objetos son los de 1987) pero evoluciona con sistemas de Hollow Knight: bancos, sombra al morir, mapas de Cornifer, amuletos con muescas, tajos arriba y abajo, nadar, el ambiente de cada zona y su música.

Hecho en Unity 6 (6000.6.5f1) con URP 2D, como proyecto personal y educativo.

De la ROM a Unity, en fases

  1. Entorno

    La copia de la ROM del propio usuario, el emulador openMSX como herramienta principal (depurador, puntos de parada, volcados de RAM y VRAM, capturas) y un desensamblador Z80 (REA sobre Ghidra, alimentado con vistas ELF de los bancos que genera tools/rom_views.py).

  2. Caja negra

    Mapear la RAM jugando: dónde están la posición del jugador, la vitalidad, flechas, monedas, llaves, la sala y el personaje activo. Los scripts de tools/openmsx/ (Tcl y Python) mueven al jugador, fuerzan valores y graban cada fotograma.

  3. Lectura del código

    Papel de cada banco, la máquina de estados global (21 estados), la física del salto, las colisiones, la IA de los 53 tipos de enemigo y de los 10 jefes, el daño. Todo queda en fichas en docs/ con su dirección de la ROM.

  4. Extracción de datos

    tools/extract/ saca de la ROM los mapas y enlaces, la colisión por sala, entidades, eventos, catálogos de enemigos y objetos, jefes, música (partituras del PSG) y efectos. La música reconstruida coincide en el 98–100 % de los fotogramas con la grabación del chip.

  5. Biblia de diseño

    docs/design_bible/: la síntesis en 12 capítulos de qué hace el juego, con sus reglas y números, para reimplementarlo desde ahí. El capítulo 11 recoge cada decisión del remake con su motivo.

  6. Unity

    Un importador convierte los JSON en ScriptableObjects, tilemaps y escenas; el juego se reimplementa a partir de la documentación, tick a tick, y las pruebas comparan sus curvas con lo medido en el emulador. Encima va la capa de Hollow Knight.

Cada dato lleva su prueba

La biblia y los documentos técnicos marcan la confianza de cada dato. Así se sabe qué está leído en el código, qué se ha visto y qué es una suposición:

MarcaSignificaEjemplo
[C]leído en el código de la ROMsólido si el tile es ≥ 0xBA
[O]observado en el emulador (openMSX)andar: 2 px por tick = 60 px/s
[O*]observado forzando la RAM (invencible, posición escrita a mano)piedras: 3 golpes de Popolon
[G]solo lo dice la guía de GameFAQs, sin contrastarla puerta del mundo 10 aparece en uno de 4 sitios
[I]interpretación propialos enemigos reaparecen al volver a la sala
Fiel

La física del salto, las salas y su colisión, los 53 tipos de enemigo, los 10 jefes con su vida y su debilidad, los santuarios y precios, los 47 objetos: los números del original, medidos y probados.

Pero mejorado

Cada cambio es una regla del remake en RemakeRules.cs, con su motivo en el capítulo 11 de la biblia y una prueba que comprueba el juego con y sin ella. Se puede apagar para volver al original.

II · ORIGINAL Y REMAKE

De 1987 a hoy

La misma sala, píxel a píxel: el remake conserva la colisión del original, así que cada plataforma, escalera y pared está donde estaba en el MSX. Lo que cambia es cómo se viste. Arrastra el tirador y elige el castillo o cualquiera de los diez mundos.

Sala del mundo 1 en el original de MSX La misma sala en el remake con el arte de Hollow Knight
MSX · 1987Remake

Mundo 1, sala 5. A la izquierda, el MSX de 1987 (el fondo de la sala sacado de la ROM); a la derecha, la misma sala en el remake, con la zona Sendero Verde de Hollow Knight.

Por qué encajan tan bienLas salas del remake no se han redibujado: se importan de la ROM (32 × 20 casillas de 8 px) y el escenario de Hollow Knight solo viste los bordes del sólido, que se pinta negro. Los enemigos, los objetos y la interfaz sí son nuevos; en el lado del original solo está el fondo de la sala.
III · ARQUITECTURA

Arquitectura del juego

Una lógica pura que avanza a 30 pasos por segundo, como la del MSX, y una capa de Unity que la dibuja suave a 60 o 120 fotogramas.

Lógica pura: PlayerMotor

Una clase sin MonoBehaviour, en píxeles del original dentro de la sala (x = centro, y = pies). Aplica tick a tick la física medida en openMSX: el salto, la caída, las escaleras, los líquidos, el retroceso y la espada. Al no depender de Unity, las pruebas la comparan directamente con las curvas grabadas en el emulador.

Unity alrededor: PlayerController

Lee la entrada (Input System) en cada fotograma y la guarda para el tick siguiente, ejecuta los ticks a 30 por segundo con un acumulador, avisa a GameBootstrap antes de cada paso y dibuja al Caballero interpolado entre el paso anterior y el actual.

Runtime/Game/PlayerController.cs — el bucle de ticks
// 30 pasos por segundo, como el original; el resto del fotograma se usa para interpolar.
accumulator += Time.deltaTime;
float tick = 1f / OriginalPhysics.TicksPerSecond;   // 30
int guard = 0;
while (accumulator >= tick && guard++ < 4)
{
    accumulator -= tick;
    Snapshot();
    if (roomPause > 0) { roomPause--; continue; }
    if (hitStop > 0) { hitStop--; continue; }   // las pulsaciones se guardan para cuando siga
    Motor.Tick(delayed);
    delayed = input;
    ...
    Ticked?.Invoke();
}
TickAlpha = NoInterpolation ? 1 : Mathf.Clamp01(accumulator / tick);
UpdateVisual();

Las piezas

PiezaQué hace
GameBootstrapEl director: carga el mapa, cambia de sala, conecta enemigos, jefes, armas, inventario, santuarios, bancos y música. Es una clase partial repartida en GameBootstrap.cs, GameBootstrap.Maps.cs (mapa dibujado a mano) y GameBootstrap.Decor.cs (lápidas, entradas y fachadas).
RoomWorldConsulta de tiles en coordenadas del original; sigue los enlaces a la sala vecina si el punto cae fuera. Guarda una copia de la colisión de cada sala para cambiarla en juego (piedras rotas) sin tocar los assets.
EnemySystemHasta 16 enemigos a la vez como en el original; los crea desde los generadores de la sala, los hace avanzar cada tick, resuelve contacto, espada, escudos, daño y botín. Los tipos están en Enemies/ por familias (andan, vuelan, fijos, generados, proyectiles).
BossFightEl ciclo del jefe: escuchar la palabra, invocación, combate, disolución, Gran Llave y celebración.
Weapons · InventoryLas seis armas secundarias con sus límites, y los 47 objetos con sus efectos; con la regla de amuletos, coste en muescas.
SaveGameLa partida en JSON en la carpeta de datos de la aplicación, escrita de forma atómica (primero .new, luego se reemplaza).
UiKit · HollowMenusToda la interfaz se dibuja con IMGUI (OnGUI), con la fuente de Hollow Knight y sus filigranas. Para no generar basura, los componentes que no usan GUILayout desactivan su pasada de maquetación (useGUILayout = false).
IV · UNITY

Configuración de Unity

Un proyecto pequeño en paquetes y grande en herramientas: importadores, constructor de escenas, compilación por línea de comandos y pruebas.

Versión

Unity 6000.6.5f1, proyecto en unity/MazeOfKnight (el nombre de trabajo del remake era «Maze of Knight»).

Render

URP 17.6 con el renderer 2D: luces 2D, posproceso con Volume (gradación, bloom, viñeta) y cámara en perspectiva por capas.

Paquetes

2D Tilemap y Tilemap Extras, Pixel Perfect, Input System (teclado y mando), Newtonsoft JSON y Test Framework.

Dónde está cada cosa

unity/MazeOfKnight/Assets/ ├── Scripts/Runtime/Data # MapData, RoomData, RoomCoords: el modelo importado ├── Scripts/Runtime/Game # el juego: GameBootstrap, PlayerMotor, RemakeRules… │ ├── Enemies/ # EnemySystem, tipos, jefes, proyectiles, sombra │ └── Visuals/ # HollowScenery, HollowAmbience, HitEffects, menús… ├── Scripts/Editor # GaliousImporter, ArtImporter, GameSceneBuilder, GameBuild ├── Generated/ # lo importado de la ROM: mapas, salas, escenas de consulta ├── Art/Resources/Hollow/ # lo importado de Hollow Knight con tools/hollow ├── Plugins/macOS/ # GameHaptics.bundle (vibración nativa) ├── Scenes/Game.unity # la escena de juego └── Tests/EditMode # 192 pruebas

Del JSON a la escena

  1. Exportar el paquete de salas

    tools/extract/collision.py y tools/extract/unity_bundle.py generan extracted/unity/<mapa>.json: 11 mapas y 321 salas, más el final del juego.

  2. Importar en Unity

    Menú Maze of Knight → Importar salas (o en batch con GaliousImporter.ImportAndRenderBatch). Crea un MapData por mapa y un RoomData por sala con su rejilla, enlaces (−1 sin salida; 0xF5–0xFE salida al castillo), colisión 32 × 20, enemigos, objetos, piedras y puertas.

  3. Escenas de consulta

    Cada mapa tiene una vista general con todas las salas en su rejilla, una capa de Tilemap por clase de colisión; se abre con Abrir mapa → Castillo / Mundo 1…10. En batch, además, se renderiza a PNG para compararla con los mapas montados con capturas del emulador.

  4. Arte por nombre

    ArtImporter (un AssetPostprocessor) trata todo PNG de Art/Resources/Hollow como sprite a 8 texels por píxel del original, bilineal, sin mipmaps ni compresión, con el pivote en los pies o en el centro según la carpeta.

  5. Escena de juego

    Crear escena de juego (GameSceneBuilder) monta Game.unity y configura el render 2D; el jugador empieza donde en el original: castillo, sala 1, x = 192, y = 120.

Terminal — importar, probar y compilar en batch (macOS)
UNITY=/Applications/Unity/Hub/Editor/6000.6.5f1/Unity.app/Contents/MacOS/Unity
# importar las salas y renderizar las vistas generales (sin -nographics: hace falta GPU)
$UNITY -batchmode -projectPath unity/MazeOfKnight \
  -executeMethod MazeOfKnight.EditorTools.GaliousImporter.ImportAndRenderBatch -quit
# pruebas EditMode
$UNITY -batchmode -projectPath unity/MazeOfKnight -runTests -testPlatform EditMode \
  -testResults "$PWD/logs/unity/tests.xml"
# compilar para macOS (también BuildLinux, BuildWindows, BuildWeb)
$UNITY -batchmode -quit -projectPath unity/MazeOfKnight \
  -executeMethod MazeOfKnight.EditorTools.GameBuild.BuildMac

Unidades

ConceptoValor
Unidad de Unity1 u = 16 px del original; un tile de 8 px = 0,5 u; una sala = 16 × 10 u
CeldasRoomCoords.Cell(room, col, fila): la fila 0 es la de arriba; el eje y de Unity crece hacia arriba
Coordenadas del originalx, y de pantalla; la sala empieza en y = 32 (debajo del marcador). RoomCoords.PixelToWorld las convierte
Arte8 texels por píxel del original → 128 píxeles por unidad
Tiempo1 tick = 1/30 s (un ciclo del juego cada dos fotogramas de vídeo a 60 Hz)
V · EL MUNDO POR CAJAS

El mundo por cajas

Debajo de cada sala de Hollow Knight hay una rejilla de 32 × 20 casillas de 8 píxeles: la colisión exacta del juego de 1987.

El juego decide qué es cada casilla por el número de tile del mapa de nombres en RAM [C]. tools/extract/collision.py lo convierte en una letra por casilla y una cuadrícula de 20 filas × 32 columnas por sala, incluidas las piezas superpuestas (piedras, muros, estatuas, puertas, escaleras extra). La sala del jefe trae además su versión de combate.

Esta clasificación se validó en el emulador con 91 caídas en 12 salas: en todas el jugador acabó apoyado en una casilla que la cuadrícula marca como sólida [O].

.aire y fondo
#sólido: tile ≥ 0xBA
Hescalera: 9A, 9B
~agua: B6, B7
Llava: B8, B9
jsólido que se atraviesa en combate (BA–EF)
La colisión real de la sala 137 del castillo, tal como la extrae collision.py: muro a la izquierda, plataformas, una escalera y agua en la mitad de abajo. 640 casillas que deciden dónde se pisa, se trepa o se nada.
MedidaValor del original
Pantalla de juego256 × 160 px (32 × 20 tiles de 8 px) bajo un marcador de 32 px; 8 × 5 bloques de 32 × 32
Mapascastillo de 147 salas en una cuadrícula de 15 × 16 y 10 mundos de 5 a 27 salas: 321 en total
Enlacescuatro por sala (arriba, abajo, izquierda y derecha); en los mundos, F5–FE significa «volver al castillo»
Recuento de tilesfondo 109 735 · sólido 76 671 · escalera 6 796 · agua 2 406 · lava 3 432
Caja del jugadorparedes: x − 8 … x + 7; apoyo en el suelo solo con x − 4 … x + 4 [O]
Rarezala sala 4 del mundo 3 enlaza hacia arriba consigo misma: un pozo sin fin que, subido 5 veces, abre un muro

Antes y después: la colisión bajo el arte

Como en Hollow Knight, la colisión no se ve. Arrastra el tirador para descubrir, en rojo, el sólido del original bajo el escenario (la rejilla se enciende en el juego con F10).

Sala del castillo con el arte de Hollow Knight La misma sala con la colisión del original marcada
ArteColisión

Castillo (Cruces Olvidados). A la derecha, en rojo, lo sólido del original; las escaleras, en amarillo.

Cómo se viste una caja: HollowScenery

El sólido de cada sala se pinta negro puro (el interior de la roca) y piezas sueltas del kit de la zona visten sus bordes, sin pasarse mucho de ellos para que lo que se ve sea lo que se pisa. Todo sale de una semilla por sala, así que cada sala es siempre igual, y se rehace si su colisión cambia.

  • Suelos arriba de cada sólido con aire encima, uno tras otro, con el labio asomando 2 px por encima de donde se pisa.
  • Techos colgando debajo (12 px como mucho) y, si hay sitio, estalactitas.
  • Paredes en los lados con aire, apiladas, nunca más anchas que el grosor de su roca.
  • Adornos (hierba, huesos, bases de columna) sobre uno de cada pocos suelos, lejos de puertas, bancos, lápidas y Cornifer.
  • Fuera de la sala cuenta como la celda del borde: sin bordes en los límites. Las piedras rompibles no cuentan como sólido: tienen su dibujo.
4
Fondo lejano: un trozo de una sala de Hollow Knight ya pintada, desenfocado y apagado.
3
Degradado con niebla abajo, rocas grandes lejanas, arcos y estatuas apagados.
2
El juego: el sólido negro y sus bordes, personajes, enemigos y objetos.
1
Primer plano: siluetas negras de roca por delante, asomando 4–10 px desde el suelo o hasta 18 px desde el techo.
Runtime/Game/Visuals/HollowScenery.cs
public const float Lip = 2f;          // px que asoma el suelo por encima de donde se pisa
public const float Overlap = 0.8f;    // cada pieza empieza al 80 % de la anterior
public const float TechoMax = 12f;
// Negro puro, como el contorno del arte: con un poco de color, la gradación de cada zona
// (saturación y filtro) lo volvía gris azulado o verdoso.
public static readonly Color Rock = Color.black;
Puerta de un mundo, cerrada: la fachada según el mundo al que lleva y los estandartes
Puerta de un mundo, cerrada: la fachada según el mundo al que lleva y los estandartes
Abriéndose: con la Gran Llave, en 3 pasos de 6 ticks, como el original
Abriéndose: con la Gran Llave, en 3 pasos de 6 ticks, como el original
Abierta: «↓ Entrar»
Abierta: «↓ Entrar»
VI · TEXTURAS

Composición de texturas

Un importador por familia de arte: de los atlas de Hollow Knight a sprites sueltos con nombre, escala y pivote fijos.

El arte se lee de una carpeta local con Hollow Knight decodificado y sale a Assets/Art/Resources/Hollow/. Cada script de tools/hollow/ se ocupa de una familia; import_hollow.py los ejecuta todos (con Pillow, en el entorno .venv del repo).

ScriptQué importa
import_hollow.pyEl Caballero (Popolon) y Hornet: un PNG por fotograma con su nombre de ArtLibrary, mirando a la derecha, pies abajo en el centro, y fps.txt con la velocidad y el bucle de cada clip
enemigos.pyUna criatura de Hollow Knight por tipo del original, con sus acciones (quieto, mover, atacar, girar, morir) y los proyectiles
escenario.py · atlas_piezas.pyKits de piezas por zona (suelos, techos, paredes, fondos); atlas_piezas.py numera las manchas de un atlas sin recortar y da su caja
efectos.py · tajos.py · armas.pyChispas, grietas, polvo y piezas del atlas de impactos; los tajos arriba y abajo; los proyectiles de las armas
objetos.py · iconos.pyIconos de amuletos para los 47 objetos, piedras, verjas, puertas y escaleras; iconos de la ROM redibujados al estilo de Hollow Knight
liquidos.py · ambiente.pySuperficie ondulada, gotas, salpicaduras; partículas, luz y niebla de cada zona
hud.py · menu.py · inventario.py · diario.pyMáscaras y orbe del marcador; menús, filigranas y fuente; inventario y amuletos; el diario del cazador
bancos.py · cornifer.py · dioses.py · decorados.pyUn banco por zona; Cornifer y su mapa; los dioses de los santuarios; lápidas, entradas y fachadas de las puertas
musica.pyLas pistas por zona, santuario y jefe, mezcladas y normalizadas a −14 LUFS

8 texels por píxel

La regla que lo une todo: un píxel del original son 8 texels de arte. Como una unidad de Unity son 16 píxeles del original, los sprites se importan a 128 píxeles por unidad. Así el arte en alta resolución cae exactamente sobre la rejilla de 8 px y nunca la cambia.

El Caballero va a ×1,375: su cuerpo sin los cuernos mide 16 px, lo que el sprite de Popolon del original (22 px con ellos). Hornet iba a ×1,125 (30 px), algo menos alta que en Hollow Knight para caber en estas salas.

Editor/ArtImporter.cs
public const float TexelsPerPixel = 8f;
public const float PixelsPerUnit =
    TexelsPerPixel * Data.RoomCoords.PixelsPerUnit;   // 128
...
importer.spritePixelsPerUnit = PixelsPerUnit;

Tamaño de los enemigos: atado a su caja

Cada enemigo se escala a partir de su caja de contacto original, con una sola escala para los dos ejes (no se deforma): la menor que hace que su cuerpo (la silueta sin patas, alas finas ni armas) mida k veces la caja de alto o de ancho. Se apoya abajo en el centro de la caja si anda, o en su centro si vuela. Ninguna colisión cambia; la prueba HollowEnemyArtTests lo vigila. Y el tamaño se fija al aparecer: en el original la caja cambia con cada pose y el dibujo se estiraba y encogía.

tools/hollow/enemigos.py — la tabla ENEMIES
# clave → tipos del original, colección tk2d, anclaje, k y clips de cada acción
"murcielago": dict(types=[0x0E], col="Buzzer", anchor="centro", k=1.5,     # Vengefly
                   clips={"quieto": "Idle", "mover": "Fly", "atacar": "Chase", "girar": "TurnToFly"}),
"esqueleto": dict(types=[0x25], col="Zombie Basic1", anchor="pies", k=1.25,   # Husk
                  clips={"quieto": "Idle", "mover": "Walk", "atacar": ["Attack Anticipate", "Attack Lunge"]}),

El tajo y su caja

Original

La espada golpea una franja de 4 px de alto (y − 7 … y − 4), de x + 8 a x + 18. Delante y solo delante.

Remake · SlashBoxFromArt

La caja es la del tajo dibujado, medida en sus texturas: delante de x + 2 a x + 22 y de y − 19 a y − 4; arriba y abajo, 22 px. Era frustrante que el golpe no diera a lo que tocaba el tajo.

El Caballero quieto (Popolon)
El Caballero quieto (Popolon)
Corriendo: 2 px por tick
Corriendo: 2 px por tick
Espadazo con el tajo de Hollow Knight
Espadazo con el tajo de Hollow Knight
Salto, subida: 6 6 6 6 6 5 5 4 4 3 2 1 px por tick
Salto, subida: 6 6 6 6 6 5 5 4 4 3 2 1 px por tick
Salto, caída: 1 2 3 4 4 5 5 6
Salto, caída: 1 2 3 4 4 5 5 6
En la escalera: 1 px por tick
En la escalera: 1 px por tick
Espadazo con las cajas de colisión visibles (F9)
Espadazo con las cajas de colisión visibles (F9)
Quieto con su caja de colisión (F9)
Quieto con su caja de colisión (F9)

Escaleras y piezas de sala

Hollow Knight no tiene escaleras: se montan con piezas suyas (barras de hierro en el castillo, cadenas de campanas en los mundos construidos y cadenas con travesaños en los demás), un trozo cuadrado escalado sin deformar a 16 × 16 px y partido en 4 baldosas que MapView alterna. El Caballero sube de espaldas con los fotogramas de entrar por una puerta. Las piedras rompibles son rocas de geo, las puertas con llave la verja del Archivo y los ascensores, la plataforma del Coliseo.

Castillo, sala 7: un objeto en la sala
Castillo, sala 7: un objeto en la sala
Castillo, sala 16
Castillo, sala 16
Castillo, sala 19
Castillo, sala 19
Castillo, sala 77
Castillo, sala 77
VII · AMBIENTE

Ambientación

Cada mundo lleva el aire de una zona de Hollow Knight: su color, su oscuridad, su luz y lo que flota en él.

En Hollow Knight cada escena lleva un SceneManager con la saturación y las curvas de color, la luz ambiente, el color de la luz del Caballero y un nivel de oscuridad (de −1 a 2): la viñeta deja un hueco alrededor del Caballero que la linterna agranda. La cámara enciende las partículas de su zona. HollowAmbience hace lo mismo por mundo con un Volume de URP.

MapaZona de Hollow KnightOscuridadPartículas
CastilloCruces Olvidados0polvo
Mundo 1Sendero Verde0hojas
Mundo 2Canales Reales1goteo y niebla baja
Mundo 3la Colmena0hexágonos
Mundo 4Picos de Cristal0cristales que flotan
Mundo 5Ciudad de las Lágrimas0lluvia
Mundo 6Páramos Fúngicos0esporas
Mundo 7el Abismo1humo
Mundo 8Nido Profundo1hilos de telaraña y polvo
Mundo 9Confines del Reino0ceniza con viento
Mundo 10Palacio Blanco−1pétalos

Color medido, no inventado

  1. Las salas de referencia

    Los valores de color de cada escena no están en los datos decodificados, solo los campos en el código. Se toman las imágenes de todas las salas de cada zona, reconstruidas desde sus ficheros de nivel.

  2. Nuestras salas, sin gradación

    El juego se lanza con -ambienteNeutro -capturaSalas para fotografiar las salas propias sin ningún filtro.

  3. Medir y comparar

    tools/hollow/medir_ambiente.py calcula color medio, saturación y brillo de unas y otras. De la diferencia salen el filtro de color, la saturación y el color de la bruma de cada mundo; a la saturación se le suman los 17 puntos que la cámara de Hollow Knight añade siempre.

◐

Oscuridad con hueco

En los Canales, el Abismo y el Nido, una viñeta deja un hueco alrededor del Caballero, más amplio y menos opaco que en Hollow Knight porque aquí la sala entera está en pantalla. La Vela del original hace de linterna y lo abre.

✧

Luz del Caballero

Una luz suave y aditiva que le acompaña, con el color de la zona; la luz de las puertas de los mundos atraviesa la oscuridad.

≋

Bruma y jirones

Entre el fondo y el plano de juego, una bruma del color medio de la zona, más espesa abajo, y jirones de niebla que pasan despacio.

Oclusión ambiental desde la colisión

Las salas de Hollow Knight tienen sombra junto a la roca. Aquí se calcula a partir de la rejilla: AmbientOcclusion oscurece el aire donde el suelo toca la pared, los rincones y la base de cada saliente, en una textura de negro con alfa por sala que va encima de los tiles y debajo de los personajes. Solo es aspecto: no toca la colisión.

Runtime/Game/Visuals/AmbientOcclusion.cs
public const int TexelsPerTile = 4;
public const float Radius = 1.6f;       // alcance, en tiles
public const float MaxAlpha = 0.55f;    // oscuridad máxima (en un rincón)

// Oclusión de cada texel (0..1 = alfa del negro) de una rejilla cols × rows cuyo solid(col, fila)
// dice si el tile es macizo (fila 0 arriba). Dentro del macizo es 0.
public static float[] Compute(Func<int, int, bool> solid, int cols, int rows)
Negro puroEl macizo se pinta con negro exacto, como el contorno del arte. Con un poco de color, la gradación de cada zona lo volvía gris azulado o verdoso y la roca dejaba de leerse como roca.
VIII · EFECTOS

Efectos

Que cada golpe se note: chispas, destellos, vibración del mando y líquidos vivos, sin tocar los tiempos del original.

Golpes (HitEffects)

  • Espada contra un enemigo: la raya del tajo, un destello en estrella y un abanico de chispas hacia el otro lado.
  • Enemigo muerto: destello grande, gotas y abanicos a los dos lados; queda su animación de muerte de Hollow Knight.
  • Escudo que para un golpe: chispas de metal.
  • Piedra golpeada: polvo y un destello pequeño; rota, una nube alargada y esquirlas.
  • Jugador herido: el rayo blanco y un destello con su raya.
  • Puerta de mundo que se abre: polvo que sube del hueco.

Las piezas salen de los atlas de impactos de Hollow Knight, que vienen sin recortar y se separan por manchas.

Chispas y destello al golpear
Chispas y destello al golpear
Efectos de Hollow Knight sobre una sala del castillo
Efectos de Hollow Knight sobre una sala del castillo
Más efectos de impacto
Más efectos de impacto
Enemigos con sus cajas de colisión (F9)
Enemigos con sus cajas de colisión (F9)

Sensación de Hollow Knight

ReglaQué hacePor defecto
HitStopAl acertar un golpe todo el juego se para 3 ticks (0,1 s; Hollow Knight, unos 0,11 s). Las pulsaciones de esos ticks se guardan.activada
CoyoteJumpEl original deja 4 ticks quieto en el aire al salir de un borde; en los 2 primeros, ↑ salta como desde el suelo.activada
JumpBufferUna pulsación en los 2 últimos ticks en el aire salta en el primer tick en el suelo.activada

Las tres se activan o quitan a la vez con F11 (teclas de depuración). No cambian la física medida: solo perdonan o marcan el tiempo.

Vibración: tres caminos

Rumble da un pulso corto al golpear (enemigo, piedra, pared o escudo), uno más fuerte al matar, al recibir daño y al curarse, y un zumbido que crece mientras el Caballero se concentra. Se quita en Opciones → Mando.

  • macOS: el Input System no hace vibrar los mandos allí, así que va por el framework de Apple (GameController + CoreHaptics) con un plugin propio, GameHaptics.bundle, compilado desde tools/native/GameHaptics.m.
  • Linux y Windows: el Input System. En Linux solo se llama a SetMotorSpeeds cuando la intensidad cambia (en pasos de 0,1): cada llamada sube un efecto al mando, y en una Legion Go 2 con SteamOS se quedaba una vibración larga y luego ninguna.
Runtime/Game/Rumble.cs
#if UNITY_STANDALONE_OSX || UNITY_EDITOR_OSX
[DllImport("GameHaptics")] static extern int GH_Available();
[DllImport("GameHaptics")] static extern void GH_Rumble(
    float intensity, float sharpness, float seconds);
[DllImport("GameHaptics")] static extern void GH_Stop();
#else
static bool Native => false;

Líquidos y fundidos

Agua y lava (HollowLiquids)

El cuerpo lo pinta MapView por profundidad, con un degradado continuo de la superficie a la cuarta fila y por delante de los personajes. En la superficie, la línea ondulada animada de Hollow Knight. Agua: gotas que caen del techo y niebla flotando (sin burbujas: en Hollow Knight solo las tiene el ácido). Lava, que Hollow Knight no tiene: su agua en naranja con los glóbulos de la infección, burbujas que estallan, ascuas, humo y vapor. Al entrar o salir, una salpicadura.

Fundidos

Fundido desde negro al cambiar de sala y más largo al cambiar de mapa. Al entrar en un santuario del castillo la pantalla funde a negro en 0,45 s en lugar de hundir al Caballero 16 px en el suelo como el original (se le veía por encima de la piedra). La música también cambia con un fundido.

IX · MÚSICA Y SONIDO

Música y sonido

Un chip de 1987 emulado nota a nota para los efectos y las fanfarrias, y la banda sonora de Hollow Knight para cada zona y cada jefe.

El chip original

El MSX suena con un PSG AY-3-8910 a 1,79 MHz: 3 canales de tono más ruido y envolvente, manejados por 14 registros. El driver de Konami lee una partitura propia (notas, silencios, tempo, octavas, «guiones» de instrumento para arpegios y percusiones, bucles) una vez por fotograma.

tools/openmsx/record_music.py graba los registros del PSG de cada canción en el emulador y tools/extract/score.py decodifica las partituras; la reconstrucción coincide con la grabación en el 98–100 % de los fotogramas de las 21 canciones.

En Unity: Psg.cs

Un AY-3-8910 emulado (clase sin Unity, para poder probarla) reproduce los registros grabados de cada canción, recortados a una vuelta con su bucle, y los efectos del driver en el canal C con su prioridad: uno nuevo solo interrumpe al actual si su número es mayor o igual.

El chip escribe sus muestras directamente en la salida de audio (PsgOutput.OnAudioFilterRead, búfer de 256 muestras) en vez de un clip en streaming, que llegaba con retardo: el efecto suena en 1 fotograma.

Hollow Knight por zona y por jefe

DóndePista de Hollow Knight
Menú principalTitle
Castillo · mundos 1–10Cruces Olvidados, Sendero Verde, Canales Reales, la Colmena, Picos de Cristal, Ciudad de las Lágrimas, Páramos Fúngicos, el Abismo, Nido Profundo, Confines del Reino y Palacio Blanco (las que van por capas, mezcladas)
Santuariosla de las salas con un personaje
Jefesla pelea del jefe de Hollow Knight que hace de él: False Knight, Uumuu, Mantis Lords, Dung Defender, Nosk, Hornet (para el Traitor Lord), Soul Master (para el Mawlek), Broken Vessel, Grimm y la Radiance

Normalizada a −14 LUFS

Las pistas de Hollow Knight vienen muy bajas (−25 a −29 dB de media) y quedaban por debajo de los efectos del chip. Al importarlas, musica.py mezcla sus capas y las normaliza con ffmpeg a −14 LUFS, con los picos a −1,5 dB. Con el volumen general a 7 (el de serie) suenan enteras.

tools/hollow/musica.py
LOUDNESS = -14   # LUFS de todas las pistas
norm = f"loudnorm=I={LOUDNESS}:TP=-1.5:LRA=11"
mix = ["-filter_complex",
       f"amix=inputs={len(parts)}:duration=longest:normalize=0,{norm}"]
Se queda en el chip

Las fanfarrias del original: objeto importante, invocación del jefe, jefe vencido, muerte y el final. Mientras suenan, la música de Hollow Knight baja.

Efectos que dicen algo

Al acertar suenan los del original: 0x1E al enemigo, 0x27 al jefe, 0x20 al morir y 0x1D al chocar con un escudo. El golpe en una pared que suena sigue siendo la pista de que aquí hay algo.

X · ENEMIGOS

Enemigos

53 tipos leídos rutina a rutina, reimplementados desde su ficha y vestidos de criaturas de Hallownest.

  1. Desensamblar

    tools/extract/enemy_ai.py desensambla, para cada uno de los 53 tipos que aparecen en salas, su rutina de inicio y la de actualización (dos tablas de saltos de la ROM).

  2. Una ficha por tipo

    Cada rutina se lee y se resume en docs/enemy_ai.md: velocidades en px/tick, tiempos en ticks, cajas de colisión por estado, qué dispara y cuándo. Se contrastan con lo medido en el emulador (trace_enemies.py, contact_measure.py, hitbox_measure.py).

  3. Reimplementar

    En Enemies/, por familias: EnemyTypes, EnemyWalkers (andan y saltan), EnemyFlyers (voladores y trepamuros), EnemyFixed (trampas y torretas) y Projectiles (los 25 hijos). Combate medido: daño por tipo, retroceso de 6 ticks a 4 px, 42 ticks de invulnerabilidad.

  4. Vestir

    Cada tipo lleva una criatura de Hollow Knight con un papel parecido; el dibujo se ajusta a su caja de contacto y no la cambia.

OriginalHollow Knight
murciélagoVengefly
esqueletoHusk
caballero (solo se le daña por la espalda)Husk con escudo
broteplanta trampa
rodadorBaldur
murciélagos que se fusionanGruzzer
reptadorCrawlid
erizoTiktik
espírituLumafly
fantasmaFolly
hechiceroSoul Twister
estatuaMoss Knight
bocas de paredGulka
torretasla del Mawlek
pinchoslos del Coliseo
Fallos del original que no se copianLa biblia anota tres rarezas que conviene no reproducir: la torreta 0x32 dispara hacia el lado contrario al jugador, el 0x43 ignora el azar al elegir dirección y el 0x12 elige sentido comparando la Y del jugador con su X.

Salas con enemigos

Mundo 1, sala 7
Mundo 1, sala 7
Castillo, sala 2
Castillo, sala 2
Castillo, sala 4
Castillo, sala 4
Castillo, sala 6
Castillo, sala 6
Castillo, sala 9
Castillo, sala 9
Castillo, sala 13
Castillo, sala 13
Castillo, sala 18
Castillo, sala 18
Castillo, sala 20
Castillo, sala 20
Castillo, sala 25
Castillo, sala 25

Muerte y botín

Al morir, el enemigo sortea botín según su tipo (flechas, monedas o llaves; geo con el arte de Hollow Knight), que se queda quieto en la rejilla de 8 px hasta recogerlo o salir de la sala.

Castillo, sala 3: el golpe
Castillo, sala 3: el golpe
Castillo, sala 3: la muerte
Castillo, sala 3: la muerte
Castillo, sala 3: el botín
Castillo, sala 3: el botín
Castillo, sala 20: el golpe
Castillo, sala 20: el golpe
Castillo, sala 20: la muerte
Castillo, sala 20: la muerte
Castillo, sala 20: el botín
Castillo, sala 20: el botín

El diario del cazador

El original no lleva registro de enemigos. Con HollowJournal, la cuarta pestaña del inventario es el diario del cazador: como cada criatura ya lleva el dibujo de una de Hollow Knight, su entrada es la de esa criatura, con retrato, descripción y notas del cazador. Los tipos que comparten criatura comparten entrada: 61 en total, los jefes al final.

Las notas se leen a partir de 10 derrotas (los jefes, 1). Pinchos y torretas, que no se pueden derrotar, cuentan al verlos. La primera vez que se registra una criatura sale el aviso abajo a la derecha.

El diario del cazador, con las notas
El diario del cazador, con las notas
Una entrada sin notas todavía
Una entrada sin notas todavía
El aviso de nueva entrada
El aviso de nueva entrada
XI · JEFES

Jefes

Diez nombres escritos en diez lápidas. Se teclea la palabra en la sala del jefe y la sala se cierra.

El ritual

  1. En cada mundo hay una lápida; con la Lupa se lee la palabra.
  2. En la sala del jefe se escribe la palabra (búfer de 16 letras, sin distinguir mayúsculas). Con mando, RB abre un selector de letras.
  3. Se cierran las salidas y empieza la invocación (~97 ticks); salen chispas cada 8 ticks durante 65 y el jefe aparece cuando no queda ningún enemigo.
  4. Combate con su IA, su vida (a la mitad con el Holy Water) y la regla de sus armas: cada jefe solo recibe daño de las que marca su máscara en la ROM.
  5. Vencido, se deshace y cae la Gran Llave, que abre el mundo siguiente.
La sala del jefe, esperando la palabra
La sala del jefe, esperando la palabra
Invocación: la sala se deshace en puntos
Invocación: la sala se deshace en puntos
El combate
El combate
Bony Dragon como False Knight (mundo 1, Sendero Verde)
Mundo 1 · Sendero Verde

Bony Dragon

→ False Knight
YOMAR

Pasea, salta y lanza huesos; le dañan flecha y espada. En el remake, la maza. Vida: 24.

Sea Anemone como Uumuu (mundo 2, Canales Reales)
Mundo 2 · Canales Reales

Sea Anemone

→ Uumuu
ELOHIM

Fija; se abre y se cierra y lanza esporas. Solo recibe daño abierta. Vida: 40.

Elusive Dragon como Mantis Lords (mundo 3, la Colmena)
Mundo 3 · la Colmena

Elusive Dragon

→ Mantis Lords
HAHAKLA

Asoma por los lados a cinco alturas y escupe fuego; luego se vuelve invisible. Vida: 64.

Jump Slime como Dung Defender (mundo 4, Picos de Cristal)
Mundo 4 · Picos de Cristal

Jump Slime

→ Dung Defender
BARECHET

Se arrastra y salta para aplastar. La mina le quita 2. Vida: 112.

Donra como Nosk alado (mundo 5, Ciudad de las Lágrimas)
Mundo 5 · Ciudad de las Lágrimas

Donra

→ Nosk alado
HEOTYMEO

Vuela por una caja con la cabeza a tu altura. Solo la cabeza recibe daño. Vida: 72.

Arlyane como Traitor Lord (mundo 6, Páramos Fúngicos)
Mundo 6 · Páramos Fúngicos

Arlyane

→ Traitor Lord
LEPHA

Camina y persigue; ráfagas de 6 disparos en abanico. Vida: 56.

Big Lip como Mawlek (mundo 7, el Abismo)
Mundo 7 · el Abismo

Big Lip

→ Mawlek
NAWABRA

Disparos en 8 direcciones; solo la boca o la lengua reciben daño. Vida: 64.

Monster como Broken Vessel (mundo 8, Nido Profundo)
Mundo 8 · Nido Profundo

Monster

→ Broken Vessel
ASCHER

Baja por los bordes y sube a tu piso; 5 bolas que rebotan. Débil al fuego rodante. Vida: 80.

King Dragon como Grimm (mundo 9, Confines del Reino)
Mundo 9 · Confines del Reino

King Dragon

→ Grimm
XYWOLEH

Llamaradas y 4 nubes de tormenta; retrocede al recibir un golpe. Vida: 80.

Galious como la Radiance (mundo 10, Palacio Blanco)
Mundo 10 · Palacio Blanco

Galious

→ la Radiance
HAMALECH

Se teletransporta con 8 bolas en órbita. Solo se le daña con la Cross. Vida: 248.

Reglas del remake para los jefes

Original

El Bony Dragon lanza 3 huesos en parábola mientras pasea y en lo alto de cada salto. Solo recibe golpes en la cabeza (16 × 32 px) y tocar a un jefe quita de 8 a 40 de vitalidad cuando se empieza con 8.

FalseKnightMace · HollowBosses

El False Knight se para y da con la maza; lo que hace daño es la bola donde golpea el suelo. Todos los jefes reciben golpes en todo el cuerpo dibujado (la maza incluida) y tocarlos quita de 1 a 3 máscaras según su fuerza original.

Runtime/Game/RemakeRules.cs
public static bool FalseKnightMace = true;   // la maza en lugar de los huesos
public static bool HollowBosses = true;
// (daño + 6) / 12, entre 1 y 3: 1 el Bony Dragon… 3 Monster, King Dragon y Galious
public static int BossContactMasks(int original) =>
    System.Math.Max(1, System.Math.Min(3, (original + 6) / 12));

El dibujo de Hollow Knight sustituye a la imagen del jefe del original (que en el MSX es una imagen grande hecha con tiles del fondo y se mueve a saltos de 8 px). Su tamaño se fija con la caja de su primera aparición y al derrotarlo queda su animación de muerte. Si se muere en pleno combate, el jefe espera otra vez su palabra.

XII · MUNDOS

Mundos

Once mapas de la ROM, once zonas de Hallownest. Pulsa una imagen para verla grande y recorre con las flechas.

Cruces Olvidados · Forgotten Crossroads

Castillo: 147 salas en la ROM. El mundo exterior: puertas a los diez mundos, santuarios de los dioses y ascensores.

Castillo · Cruces Olvidados, sala de ejemplo 1
Castillo · Cruces Olvidados, sala de ejemplo 1
Castillo · Cruces Olvidados, sala de ejemplo 2
Castillo · Cruces Olvidados, sala de ejemplo 2
Castillo · Cruces Olvidados, sala de ejemplo 3
Castillo · Cruces Olvidados, sala de ejemplo 3
Castillo · Cruces Olvidados, sala de ejemplo 4
Castillo · Cruces Olvidados, sala de ejemplo 4

Sendero Verde · Greenpath

Mundo 1: 15 salas en la ROM. Jefe: Bony Dragon.

Mundo 1 · Sendero Verde, sala de ejemplo 1
Mundo 1 · Sendero Verde, sala de ejemplo 1
Mundo 1 · Sendero Verde, sala de ejemplo 2
Mundo 1 · Sendero Verde, sala de ejemplo 2
Mundo 1 · Sendero Verde, sala de ejemplo 3
Mundo 1 · Sendero Verde, sala de ejemplo 3

Canales Reales · Royal Waterways

Mundo 2: 15 salas en la ROM. Jefe: Sea Anemone.

Mundo 2 · Canales Reales, sala de ejemplo 1
Mundo 2 · Canales Reales, sala de ejemplo 1
Mundo 2 · Canales Reales, sala de ejemplo 2
Mundo 2 · Canales Reales, sala de ejemplo 2
Mundo 2 · Canales Reales, sala de ejemplo 3
Mundo 2 · Canales Reales, sala de ejemplo 3

la Colmena · The Hive

Mundo 3: 16 salas en la ROM. Jefe: Elusive Dragon.

Mundo 3 · la Colmena, sala de ejemplo 1
Mundo 3 · la Colmena, sala de ejemplo 1
Mundo 3 · la Colmena, sala de ejemplo 2
Mundo 3 · la Colmena, sala de ejemplo 2
Mundo 3 · la Colmena, sala de ejemplo 3
Mundo 3 · la Colmena, sala de ejemplo 3

Picos de Cristal · Crystal Peak

Mundo 4: 17 salas en la ROM. Jefe: Jump Slime.

Mundo 4 · Picos de Cristal, sala de ejemplo 1
Mundo 4 · Picos de Cristal, sala de ejemplo 1
Mundo 4 · Picos de Cristal, sala de ejemplo 2
Mundo 4 · Picos de Cristal, sala de ejemplo 2

Ciudad de las Lágrimas · City of Tears

Mundo 5: 18 salas en la ROM. Jefe: Donra.

Mundo 5 · Ciudad de las Lágrimas, sala de ejemplo 1
Mundo 5 · Ciudad de las Lágrimas, sala de ejemplo 1
Mundo 5 · Ciudad de las Lágrimas, sala de ejemplo 2
Mundo 5 · Ciudad de las Lágrimas, sala de ejemplo 2
Mundo 5 · Ciudad de las Lágrimas, sala de ejemplo 3
Mundo 5 · Ciudad de las Lágrimas, sala de ejemplo 3

Páramos Fúngicos · Fungal Wastes

Mundo 6: 19 salas en la ROM. Jefe: Arlyane.

Mundo 6 · Páramos Fúngicos, sala de ejemplo 1
Mundo 6 · Páramos Fúngicos, sala de ejemplo 1
Mundo 6 · Páramos Fúngicos, sala de ejemplo 2
Mundo 6 · Páramos Fúngicos, sala de ejemplo 2
Mundo 6 · Páramos Fúngicos, sala de ejemplo 3
Mundo 6 · Páramos Fúngicos, sala de ejemplo 3

el Abismo · The Abyss

Mundo 7: 20 salas en la ROM. Jefe: Big Lip.

Mundo 7 · el Abismo, sala de ejemplo 1
Mundo 7 · el Abismo, sala de ejemplo 1
Mundo 7 · el Abismo, sala de ejemplo 2
Mundo 7 · el Abismo, sala de ejemplo 2
Mundo 7 · el Abismo, sala de ejemplo 3
Mundo 7 · el Abismo, sala de ejemplo 3

Nido Profundo · Deepnest

Mundo 8: 21 salas en la ROM. Jefe: Monster.

Mundo 8 · Nido Profundo, sala de ejemplo 1
Mundo 8 · Nido Profundo, sala de ejemplo 1
Mundo 8 · Nido Profundo, sala de ejemplo 2
Mundo 8 · Nido Profundo, sala de ejemplo 2
Mundo 8 · Nido Profundo, sala de ejemplo 3
Mundo 8 · Nido Profundo, sala de ejemplo 3

Confines del Reino · Kingdom's Edge

Mundo 9: 27 salas en la ROM. Jefe: King Dragon.

Mundo 9 · Confines del Reino, sala de ejemplo 1
Mundo 9 · Confines del Reino, sala de ejemplo 1
Mundo 9 · Confines del Reino, sala de ejemplo 2
Mundo 9 · Confines del Reino, sala de ejemplo 2
Mundo 9 · Confines del Reino, sala de ejemplo 3
Mundo 9 · Confines del Reino, sala de ejemplo 3

Palacio Blanco · White Palace

Mundo 10: 5 salas en la ROM. Jefe: Galious.

Mundo 10 · Palacio Blanco, sala de ejemplo 1
Mundo 10 · Palacio Blanco, sala de ejemplo 1
Mundo 10 · Palacio Blanco, sala de ejemplo 2
Mundo 10 · Palacio Blanco, sala de ejemplo 2
Mundo 10 · Palacio Blanco, sala de ejemplo 3
Mundo 10 · Palacio Blanco, sala de ejemplo 3
Mundo 10 · Palacio Blanco, sala de ejemplo 4
Mundo 10 · Palacio Blanco, sala de ejemplo 4
XIII · INTERFAZ

Interfaz y menús

Menús, marcador, inventario, bancos y la muerte, como en Hollow Knight; las reglas de Galious siguen debajo.

Menú principal y opciones

Con HollowTitle el ciclo de presentación del original (logo, título, historia y demos) se cambia por un menú principal sobre una vista lejana del Palacio Blanco, con Continuar, Nueva partida, Opciones, Extras y Salir. Las opciones tienen Audio, Vídeo, Brillo, Mando y Teclado; todo se maneja con teclado o mando y los botones se cambian.

Menú principal
Menú principal
Menú de pausa
Menú de pausa
Extras: el homenaje y a quién pertenece cada cosa
Extras: el homenaje y a quién pertenece cada cosa
Salir pide confirmación
Salir pide confirmación
Opciones
Opciones
Audio
Audio
Vídeo
Vídeo
Brillo, con una escena de muestra
Brillo, con una escena de muestra
Mando
Mando
Teclado
Teclado
Aviso de autoguardado al arrancar
Aviso de autoguardado al arrancar
Selector de letras para escribir la palabra con mando
Selector de letras para escribir la palabra con mando

Inventario, amuletos, mapa y diario

Los objetos pasivos de combate pasan a ser amuletos que cuestan muescas y solo hacen efecto equipados (HollowCharms): 3 muescas al empezar y una más por jefe vencido, hasta 13, cuando todos juntos cuestan 20. Se equipan sentado en un banco. El mapa se compra a Cornifer (uno por mundo, en la sala más alejada) y se dibuja a mano desde la colisión de cada sala.

Inventario
Inventario
Amuletos y muescas
Amuletos y muescas
Mapa: sin el de la zona, no se ve nada
Mapa: sin el de la zona, no se ve nada
Lámina al recoger un objeto por primera vez
Lámina al recoger un objeto por primera vez
Lámina de un amuleto
Lámina de un amuleto

Bancos, alma y sombra

Bancos

18 en total: en la sala de inicio del castillo, en la entrada de cada mundo y en una sala vecina de la del jefe. Sentarse (↓) rellena las máscaras, guarda la partida y fija dónde se reaparece.

Alma

Cada espadazo que acierta da 11 de alma, hasta 99. Mantener F (o B en el mando) quieto durante 0,9 s gasta 33 y cura 2 máscaras. Sustituye a la experiencia del original.

Sombra

Sin vidas ni GAME OVER: al morir se despierta en el último banco y el geo se queda en la sombra donde se cayó, que flota y ataca; al derrotarla (4 espadazos) se recupera.

Castillo: el banco de la sala de inicio
Castillo: el banco de la sala de inicio
Sentándose
Sentándose
Sentado: máscaras llenas y partida guardada
Sentado: máscaras llenas y partida guardada
Concentrándose: el alma se gasta
Concentrándose: el alma se gasta
Curándose
Curándose
Después: dos máscaras más
Después: dos máscaras más
Tras morir: despertar en el último banco
Tras morir: despertar en el último banco
De nuevo sentado
De nuevo sentado
Banco de la Colmena (mundo 3)
Banco de la Colmena (mundo 3)
Banco de los Páramos Fúngicos (mundo 6)
Banco de los Páramos Fúngicos (mundo 6)
Banco de los Confines del Reino (mundo 9)
Banco de los Confines del Reino (mundo 9)
Banco del Palacio Blanco (mundo 10)
Banco del Palacio Blanco (mundo 10)

Santuarios y marcador

Cada dios del original lo hace un personaje de Hollow Knight: Hefesto el Forjador de Aguijones, Ares Sly, Deméter Iselda, Atenea el Anciano Hu, Asclepio Jiji y la Muerte Grimm. Las reglas (precios, escudos en orden, guardar con Deméter) no cambian. El marcador muestra la vitalidad en máscaras, una por unidad, y el orbe de alma.

Santuario de Ares (Sly): tienda
Santuario de Ares (Sly): tienda
Hefesto (el Forjador de Aguijones)
Hefesto (el Forjador de Aguijones)
Deméter (Iselda): guarda la partida
Deméter (Iselda): guarda la partida
Asclepio (Jiji)
Asclepio (Jiji)
La Muerte (Grimm)
La Muerte (Grimm)
El marcador: orbe de alma y máscaras
El marcador: orbe de alma y máscaras
Marcador con geo, flechas y llaves
Marcador con geo, flechas y llaves
El menú de objetos
El menú de objetos

El final

Con SoloKnight solo juega el Caballero; en la escena del castillo Aphrodite no aparece y el epílogo, con las mismas filas para no cambiar los tiempos (~108 s), cuenta que Popolon protegerá el Reino Hueco como su caballero.

La escena del castillo del final
La escena del castillo del final
Epílogo
Epílogo
Epílogo, más adelante
Epílogo, más adelante
Créditos
Créditos
XIV · RENDIMIENTO

Rendimiento

Medido, no supuesto: el propio juego lleva un modo que recorre los mapas y apunta fotogramas, procesador, gráfica y basura.

-rendimiento <carpeta> lanza PerfProbe: sin sincronía vertical ni límite de fotogramas, pasa por tres salas de cada mapa (con su ambiente), por el inventario y por un santuario, y mide durante 4 s en cada sitio los FPS (media y el 1 % más lento), el tiempo de CPU y GPU (FrameTimingManager) y las recolecciones de basura. Lo deja en rendimiento.txt.

En un Apple M1 Pro, la media va de unos 710 a unos 1050 FPS según la sala y el 1 % más lento se queda por encima de unos 145 FPS en el peor sitio medido (los Canales Reales). Sin límite, el juego pasa de 700 FPS; por eso el límite por defecto es 120 (60 o 120 en Vídeo, o el refresco de la pantalla con sincronía vertical).

FPS medio por mapa

Apple M1 Pro, media de tres salas; la marca dorada es el 1 % más lento del peor sitio.
Castillo
978Castillo: 978 FPS de media · 1 % más lento: 192 FPS
Mundo 1
889Mundo 1: 889 FPS de media · 1 % más lento: 181 FPS
Mundo 2
773Mundo 2: 773 FPS de media · 1 % más lento: 145 FPS
Mundo 3
849Mundo 3: 849 FPS de media · 1 % más lento: 152 FPS
Mundo 4
867Mundo 4: 867 FPS de media · 1 % más lento: 416 FPS
Mundo 5
960Mundo 5: 960 FPS de media · 1 % más lento: 448 FPS
Mundo 6
858Mundo 6: 858 FPS de media · 1 % más lento: 428 FPS
Mundo 7
794Mundo 7: 794 FPS de media · 1 % más lento: 388 FPS
Mundo 8
831Mundo 8: 831 FPS de media · 1 % más lento: 419 FPS
Mundo 9
791Mundo 9: 791 FPS de media · 1 % más lento: 403 FPS
Mundo 10
916Mundo 10: 916 FPS de media · 1 % más lento: 419 FPS
Inventario
713Inventario: 713 FPS de media · 1 % más lento: 422 FPS
Santuario
764Santuario: 764 FPS de media · 1 % más lento: 435 FPS
FPS medio1 % más lento
Ver como tabla
SitioFPS medio1 % más lento
Castillo978192
Mundo 1889181
Mundo 2773145
Mundo 3849152
Mundo 4867416
Mundo 5960448
Mundo 6858428
Mundo 7794388
Mundo 8831419
Mundo 9791403
Mundo 10916419
Inventario713422
Santuario764435

Interpolación: de saltos a 30 por segundo a movimiento fluido

La lógica sigue a 30 pasos por segundo, como el original, pero el Caballero, los enemigos, los jefes, los proyectiles, la estela, el tajo y la luz se dibujan entre la posición del paso anterior y la del actual. Sin ello, a 60 o 120 FPS el movimiento iba a saltos. Medido andando con -rendimiento (y -sinInterpolar para comparar):

Sin interpolar, 60 FPS
50 %
Sin interpolar, 120 FPS
74 %
Interpolado, 60 o 120 FPS
0 %

Porcentaje de fotogramas en los que el dibujo del Caballero no se mueve mientras anda. No se interpola en los cambios de sala, en saltos de más de 24 px ni mientras el juego está parado por un golpe.

Runtime/Game/PlayerController.cs
// Posición de dibujo entre el paso anterior y el actual (en la misma sala y sin saltos de más de 24 px:
// cambios de sala, bancos, teletransportes).
public static Vector2 Interpolate(RoomModel room, float x, float y, RoomModel prevRoom, float px, float py)
{
    var now = RoomCoords.PixelToWorld(room, 0, 0) + new Vector2(x, -y) / RoomCoords.PixelsPerUnit;
    if (room != prevRoom || Mathf.Abs(px - x) > 24 || Mathf.Abs(py - y) > 24) return now;
    float a = TickAlpha;
    return now + new Vector2((px - x) * (1 - a), -(py - y) * (1 - a)) / RoomCoords.PixelsPerUnit;
}

Menos basura por fotograma

Con -rendimiento <carpeta> -basura, la sonda mide los bytes que se piden por fotograma en una sala con enemigos y de dónde salen, apagando grupos de componentes uno a uno. Eran unos 6000 bytes por fotograma; quitando la pasada de maquetación de IMGUI (useGUILayout = false en los componentes con OnGUI que no usan GUILayout) y sin crear textos de nombres de clip y de pista en cada fotograma, quedaron unos 2200, que la recolección incremental reparte sin tirones.

Antes
~6000
Después
~2200
XV · BUILDS

Distribución de builds

Cuatro plataformas desde un script de editor, y un CI que las compila en servidores Linux.

PlataformaMétodoSalePaquete del CI
macOSGameBuild.BuildMacBuilds/Galious.appGalious-macOS.tar.gz
WindowsGameBuild.BuildWindowsBuilds/Windows/Galious.exe (x86_64)Galious-Windows.zip
Linux / SteamOSGameBuild.BuildLinuxBuilds/Linux/Galious.x86_64 (Mono) y Galious.desktopGalious-Linux.tar.gz
WebGameBuild.BuildWebBuilds/Web (WebGL, Brotli)Galious-Web.zip

Identidad

«Galious - The Hollow Kingdom», de rldona, versión 1.0.0, con el icono del emblema. Sin la pantalla «Made with Unity»: Unity 6 permite quitarla también con la licencia Personal. Arranca a pantalla completa sin bordes con la resolución nativa; lo elegido en Vídeo se guarda.

-salida <ruta> compila en otra carpeta: recompilar encima del juego mientras se juega rompe la carga de recursos.

Editor/GameBuild.cs
PlayerSettings.productName = Product;
PlayerSettings.companyName = "rldona";
PlayerSettings.bundleVersion = "1.0.0";
...
// sin la pantalla de "Made with Unity" al arrancar (Unity 6 lo permite)
PlayerSettings.SplashScreen.show = false;
PlayerSettings.SplashScreen.showUnityLogo = false;

En SteamOS (Steam Deck, Legion Go)

  1. Descomprimir

    tar -xzf Galious-Linux.tar.gz: el tar conserva los permisos de ejecución de Galious.x86_64. Se empaqueta sin la carpeta *_BackUpThisFolder_ButDontShipItWithYourGame.

  2. Añadir a Steam

    Modo escritorio → Steam → Añadir un juego que no es de Steam → Galious.x86_64.

  3. Arte de la biblioteca

    Junto a cada build va la carpeta steam/ (desde assets/steam) con portada, cubierta, héroe, logo e icono: Propiedades → Personalizar.

Portada vertical para la biblioteca de Steam
Portada vertical (600 × 900) de assets/steam.

CI con GameCI

Pruebas

tests.yml: en cada push a main y en cada pull request, las pruebas EditMode con game-ci/unity-test-runner, con caché de Library.

Builds

builds.yml: a mano o al subir una etiqueta v*; matriz de Windows, Linux, macOS (con Mono, en Linux: no gasta minutos de macOS) y Web, empaquetado y subida a una Release.

Wiki

wiki.yml: publica esta carpeta wiki/ tal cual en GitHub Pages cuando cambia en main.

Necesitan tres secretos del repo: UNITY_LICENSE, UNITY_EMAIL y UNITY_PASSWORD. Las builds van a una Release y no a los artefactos de Actions: cada build comprimida pesa unos 220 MB.

Migración de la partidaEl juego se llamaba «Maze of Knight» (de DefaultCompany) y Unity guarda en una carpeta con esos nombres. La primera vez que arranca como «Galious - The Hollow Kingdom» se trae la partida de la carpeta de antes. Las capturas, el recorrido y las medidas guardan aparte (partida_pruebas.json) para no pisarla.
XVI · PRUEBAS

Pruebas

192 pruebas EditMode que comparan el remake con lo medido en el emulador, y un recorrido que se pasa el juego solo.

Las pruebas viven en Assets/Tests/EditMode y se lanzan desde Window → General → Test Runner o con -runTests -testPlatform EditMode. Las de física comparan las curvas del motor con las grabadas en openMSX; las de cada regla del remake comprueban el juego con y sin ella.

Algunos nombres hablan solos: PlayerMotorTests.SwordDoesNotReachTwentyPixels, BossTests.HittingTheFalseKnightsMaceHurtsHim, PlayerMotorTests.HollowSwimFloatsSwimsAndJumpsOut.

FicheroPruebas
PlayerMotorTests46
EnemyTests25
EnemyBacklogTests13
BossTests9
InventoryTests · RoomObjectsTests · ImportedDataTests8 + 8 + 8
WeaponTests · BacklogTests7 + 7
otros 19 ficheros61
Total192

El recorrido automático

-recorrido <carpeta> lanza Playthrough, que se pasa el juego entero solo, con la partida guardada aparte:

  • pasa por todas las salas del castillo y de los diez mundos;
  • compra en todas las tiendas y abre los demás santuarios, y compra los mapas a los Cornifer;
  • se sienta en un banco, muere y deja la sombra;
  • invoca y vence a los diez jefes escribiendo su palabra, recoge cada Gran Llave y acaba con el final.

Apunta en recorrido.txt cada error o excepción con el paso en que salió (y una captura), las salas donde no se puede colocar al Caballero o queda dentro de la roca, y los generadores con tipos sin implementar. -soloJefes 1,2,5 repite solo esos jefes.

Modo de pruebaQué hace
-recorridoel juego completo, de forma automática
-rendimiento · -basura · -sinInterpolarFPS, CPU, GPU, basura y fluidez
-capturaSalas <carpeta> <mundo>fotografía las salas con y sin la colisión marcada (y nadando, y tras caer en la lava)
-capturaJefes <carpeta> <mundo>16 fotos de un combate en 4 s, con la caja del jefe en el registro
-capturaMenu · -capturaBancos · -capturaPersonajesmenús y opciones; bancos, Cornifer y tajos; personajes, efectos y una sala por tipo de enemigo
-depuracionactiva las teclas de depuración (K, G, F2–F11)

Las imágenes de esta wiki salen de esos modos de captura.

XVII · MODIFICAR

Cómo modificarlo

Cada regla del remake es un interruptor. Apágalas y vuelves a jugar al Galious de 1987 con otra ropa.

  1. Instalar

    Unity Hub con Unity 6000.6.5f1 y los módulos Mac, Windows Build Support (Mono), Linux Build Support (Mono) y WebGL.

  2. Abrir

    unity/MazeOfKnight. Lo importado ya está en el repo (Assets/Generated desde la ROM y Assets/Art/Resources/Hollow desde Hollow Knight); para regenerarlo, tools/.

  3. Jugar

    Escena Assets/Scenes/Game.unity → Play. El menú Maze of Knight compila para cada plataforma.

  4. Cambiar una regla

    En Assets/Scripts/Runtime/Game/RemakeRules.cs, y comprobar con las pruebas.

ReglaQué cambia respecto al originalDe serie
NoRoomChangePausesin el parón de 11 ticks al cambiar de salaactivada
SoloKnightsolo juega el Caballero; Aphrodite no estáactivada
HollowTitlemenú principal y de pausa en lugar del ciclo de presentaciónactivada
HollowBenches · HollowDeathbancos para guardar y curarse; sin vidas ni GAME OVER, el geo en la sombraactivada
HollowSoulel alma y concentrarse para curarse, en lugar de la experienciaactivada
HollowCharmslos objetos pasivos de combate son amuletos con muescasactivada
HollowJournalel diario del cazadoractivada
HollowMapsCornifer vende el mapa, dibujado a manoactivada
HollowSlashestajos arriba y abajo, con rebote; saltar va con su botónactivada
SlashBoxFromArtla caja del golpe es la del tajo dibujadoactivada
HollowSwimse nada en la superficie del agua, que no quita vidaactivada
LavaRespawnla lava hace daño como un enemigo y devuelve al último suelo firmeactivada
FalseKnightMace · HollowBossesla maza del False Knight; golpes en todo el cuerpo; tocar quita 1–3 máscarasactivada
HollowMusicmúsica de Hollow Knight por zona y jefeactivada
HollowAmbiencegradación, oscuridad, luz y partículas de cada zonaactivada
HollowMessagessin mensajes abajo, solo los avisosactivada
HitStop · CoyoteJump · JumpBufferla sensación de Hollow Knight (F11)activada
LeaveLadderSidewayssoltarse de lado a media escaleraapagada
BabyAlwaysPresentel bebé del final siempre en una de las 10 piedrasapagada
Runtime/Game/RemakeRules.cs — una regla, con su porqué
// Original: en el agua (y en la lava) se hunde despacio hasta el fondo y todo va 4 veces más lento.
// Remake (como en Hollow Knight): en el agua el jugador flota en la superficie con los pies SwimDepth px
// por debajo y nada a izquierda y derecha; salta y cae con la velocidad de fuera.
public static bool HollowSwim = true;
public const int SwimDepth = 8;

Por dónde empezar

Jugabilidad

PlayerMotor.cs y OriginalPhysics.cs (las tablas del salto) con docs/player.md al lado.

Enemigos y jefes

Enemies/ con las fichas de docs/enemy_ai.md y docs/boss_ai.md.

Aspecto

Visuals/HollowScenery.cs (kits por zona), HollowAmbience.cs (color y partículas) y los scripts de tools/hollow.

Runtime/Game/OriginalPhysics.cs — el salto medido en openMSX
public const float TicksPerSecond = 30f;
public const int WalkSpeed = 2;                                          // px por tick
public static readonly int[] RiseTable = { 6, 6, 6, 6, 6, 5, 5, 4, 4, 3, 2, 1 };   // 54 px
public static readonly int[] FallTable = { 1, 2, 3, 4, 4, 5, 5, 6 };                // y luego 6
XVIII · GLOSARIO

Glosario

Tick
Un ciclo de la lógica del juego. El original y el remake van a 30 por segundo.
Fotograma (frame)
Una imagen dibujada. En el MSX, 60 por segundo; en el remake, 60, 120 o lo que dé la pantalla.
Interpolación
Dibujar algo entre su posición del tick anterior y la del actual, según la fracción del tick que ha pasado (TickAlpha).
ROM
El cartucho volcado a un fichero: el código Z80 y los datos del juego, 128 KB en bancos que se paginan.
openMSX
Emulador de MSX con depurador y Tcl: puntos de parada, lectura y escritura de RAM, capturas y grabación de registros.
REA / Ghidra
Herramientas de ingeniería inversa usadas para desensamblar y anotar el código Z80.
PSG
El chip de sonido del MSX, un AY-3-8910 de 3 canales con ruido y envolvente.
Tile
Casilla de 8 × 8 px. Su número decide si es sólido, escalera, agua, lava o fondo.
Caja de colisión
Rectángulo con el que se decide si dos cosas se tocan. Se ven con F9; la rejilla del terreno, con F10.
Biblia de diseño
docs/design_bible/: qué hace el juego original y qué decide el remake, en 12 capítulos.
RemakeRules
Los interruptores de cada cambio respecto al original, con su motivo y su prueba.
LUFS
Unidad de sonoridad percibida; toda la música se normaliza a −14 LUFS.
URP 2D
El Universal Render Pipeline de Unity con el renderer 2D: luces 2D y posproceso.
GameCI
Acciones de GitHub para probar y compilar proyectos de Unity en servidores.
Máscaras, alma, geo
La vida, la energía para curarse y la moneda de Hollow Knight; aquí sustituyen a la vitalidad, la experiencia y las monedas.