Port inicial de Rebotes a ascii

README.md

@@ -1,3 +1,44 @@
 # rebotes_amstrad_ascii
 
-Versió del joc "Rebotes" del manual de Amstrad per a ascii
+Port a la fantasy console **ascii** del juego *Rebotes* publicado por
+AMSOFT en 1984 (Alexander Martin), originalmente escrito en BASIC de Amstrad CPC.
+
+## El juego
+
+Breakout/Arkanoid clásico: mueves una pala en la base de la pantalla y haces
+rebotar una pelota contra cuatro filas de ladrillos. Los ladrillos de la fila
+superior dan más puntos. Tienes 5 pelotas. Al limpiar la pantalla, se
+regenera y sigues con los puntos y las pelotas que llevabas.
+
+## Controles
+
+- **Flechas izda/dcha** (o **O / P**) — mover la pala
+- **ESPACIO** — empezar / volver desde menús
+- **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:
+
+```sh
+ascii rebotes.lua
+```
+
+El récord se guarda en un fichero `records` junto al juego.
+
+## Ficheros
+
+- `rebotes.lua` — el juego.
+- `rebotes.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 **Alexander Martin** 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.