README amb agraiments

README.md

@@ -1,3 +1,49 @@
 # guante_blanco_amstrad_ascii
 
-Versió del joc "Guante blanco" del manual de Amstrad per a ascii
+Port a la fantasy console **ascii** del juego *Guante Blanco* publicado por
+AMSOFT en 1985 (David Radisic), originalmente escrito en BASIC de Amstrad CPC.
+
+## El juego
+
+Aventura tipo laberinto en una casa de 5 habitaciones (Pasillo, Sala,
+Comedor, Cocina y Despensa). Eres el ladrón Guante Blanco y debes recorrer
+las habitaciones recogiendo joyas y escapando por una de las dos salidas
+(norte del Pasillo o sur de la Cocina).
+
+- **Conmutadores** encienden y apagan la luz de cada habitación. Con la
+  luz apagada no ves las joyas ni los obstáculos.
+- **Obstáculos** hacen ruido al chocar con ellos. Si haces demasiado
+  ruido, despertarás al **perro guardián**, que vendrá a buscarte y, si te
+  alcanza, te muerde y la partida acaba.
+- **Puertas** y **ventanas** conectan habitaciones; algunas ventanas son
+  vías de escape directo.
+
+## Controles
+
+- **Flechas** — mover el ladrón
+- **ESPACIO** — empezar (pantalla PASE)
+- **S / N** — jugar otra vez al acabar la partida
+
+## Cómo ejecutar
+
+Necesitas el intérprete de la fantasy console ascii:
+
+```sh
+ascii guante_blanco.lua
+```
+
+## Ficheros
+
+- `guante_blanco.lua` — el juego.
+- `guante_blanco.bas` — listado BASIC original del Amstrad CPC, como referencia.
+- `ASCII_API.md` — referencia del intérprete Lua de ascii.
+- `chuleta_font_ascii.png` — tabla de glifos del charset de ascii.
+
+## Agradecimientos
+
+- A **JailDoctor** por crear la fantasy console ascii y mantener su charset y
+  paleta tan cómodos para portar clásicos.
+- A **David Radisic** y **AMSOFT** (1985) por el juego original.
+- A la **AUA — Amstrad Users Association** por conservar el código fuente del
+  original y hacerlo accesible para esta versión.
+- A **Claude** (Anthropic) por la ayuda en el port a Lua/ascii.