commit b187556b53534da698ecb2b555c5856be97f4858 Author: Matteo Benedetto Date: Wed Jul 1 10:21:51 2026 +0000 init: Home diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..04d6fc0 --- /dev/null +++ b/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).