Port inicial de Bombardero a ascii

README.md

@@ -1,3 +1,48 @@
 # bombardero_amstrad_ascii
 
-Versió del joc "Bombardero" del manual de Amstrad per a ascii
+Port a la fantasy console **ascii** del juego *Bombardero* publicado por
+AMSOFT en 1984 (Dave Town), originalmente escrito en BASIC de Amstrad CPC.
+
+## El juego
+
+Pilotas un avión sobre una ciudad desierta y tienes que bombardear los
+edificios para poder aterrizar. El avión vuela de izquierda a derecha y, al
+llegar al borde, vuelve a salir por la izquierda una fila más bajo. Si chocas
+con un edificio: muerte. Si consigues aterrizar: subes de nivel y velocidad.
+
+Solo puedes tener una bomba en el aire a la vez.
+
+## Controles
+
+- **ESPACIO** — lanzar bomba (durante la partida) / continuar (en menús)
+- **0..5** — elegir nivel al empezar (0 = AS, 5 = principiante)
+- **0..9** — elegir velocidad al empezar (0 = lenta, 9 = rápida)
+- **I** — instrucciones desde el título
+- **A..Z** — introducir nombre al batir el récord
+
+## Cómo ejecutar
+
+Necesitas el intérprete de la fantasy console ascii. Desde el directorio del
+juego:
+
+```sh
+ascii bombardero.lua
+```
+
+El récord se guarda en un fichero `records` junto al juego.
+
+## Ficheros
+
+- `bombardero.lua` — el juego.
+- `bombardero.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 **Dave Town** y **AMSOFT** (1984) 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.