init: Home

Home.md

@@ -0,0 +1,52 @@
+# A Scream from the Dark — Wiki
+
+Benvenuto nella wiki ufficiale del progetto **A Scream from the Dark**, un survival-horror procedurale in prospettiva isometrica per Game Boy (DMG/CGB), scritto in C con GBDK-2020.
+
+## Indice
+
+- [Build & Run](Build-&-Run) — come compilare il ROM partendo dal sorgente
+- [Play in Browser](Play-in-Browser) — come giocare nel browser con un emulatore WebAssembly
+- [Architecture](Architecture) — motore grafico, AI, audio, map generation
+- [Controls](Controls) — schema dei controlli
+- [Test & QA](Test-&-QA) — script di test headless
+- [Changelog](Changelog) — storia delle release
+
+## Informazioni sul progetto
+
+- **Autore**: Matteo Benedetto (`me@enne2.net`)
+- **Piattaforma**: Nintendo Game Boy / Game Boy Color (DMG/CGB)
+- **Toolchain**: GBDK-2020, SDCC, PNG2Asset
+- **Linguaggio**: C (con qualche assembly inline)
+- **Licenza**: da definire
+
+## Stack tecnico
+
+| Componente | Tecnologia |
+|---|---|
+| Compilatore | SDCC 4.x via GBDK-2020 |
+| Build system | GNU Make |
+| Grafica | tile 32×16 isometrica, 2-bpp palette |
+| Audio | 4 canali APU, sequencer VBL |
+| Maze | DFS iterativo + loop al 15% |
+| AI nemico | greedy Manhattan, cooldown scalabile |
+| Test | PyBoy + OpenCV |
+
+## ROM
+
+- **Dimensione**: 32 KB (esattamente il limite DMG)
+- **Bancaggio**: nessuno (no MBC, ROM flat)
+- **Header**: standard GB (`0xCE 0xED 0x66 0x66 0xCC ...`)
+
+Il ROM finale è `build/AScreamFromTheDark.gb` (rinominato per release) o `build/hello_iso.gb` (nome di build). Entrambi sono bit-identici.
+
+## Repository
+
+- **Source**: https://git.enne2.net/enne2/ascreamfromthedark-gb
+- **Release v1.0**: https://git.enne2.net/enne2/ascreamfromthedark-gb/releases/tag/v1.0
+- **ROM download diretto**: https://git.enne2.net/enne2/ascreamfromthedark-gb/releases/download/v1.0/AScreamFromTheDark.gb
+
+## Stato
+
+Il progetto è in stato **playable**: il gameplay loop è completo, 8 livelli sono raggiungibili, e la musica suona su hardware reale. La versione 1.0 copre tutto il gameplay fino al livello 8 incluso.
+
+Per dettagli tecnici vedi [Architecture](Architecture).