Så fungerar spelet: skärmdumpar (M1) + hur bilderna uppdateras

Home.md

@@ -4,6 +4,8 @@ Pixel art-pusselspel: led *lämmeltåget* (ditt sällskap) genom japanska
 tågstationer byggda som labyrinter, läs skyltarna, hitta rätt tåg och kom fram
 till rätt resmål.
 
+![Bana 001 – Flygplatsen](/brasse/metro-puzzle-jp/raw/branch/master/doc/img/level-001.png)
+
 **Den detaljerade dokumentationen ligger i repot** och är alltid sanningen:
 
 | Fil i repot | Innehåll |
@@ -14,6 +16,49 @@ till rätt resmål.
 | [`doc/roadmap.md`](../src/branch/master/doc/roadmap.md) | Teknikval, katalogstruktur, milstolpar M0–M12 |
 | [`doc/mal-och-tester.md`](../src/branch/master/doc/mal-och-tester.md) | Projektmål, teststrategi, checklistor |
 
+## Så fungerar spelet (läget efter M1)
+
+**Menyn** listar banorna i `resources/data/levels/` med resmål. Pilar/WASD
+väljer, Enter startar, Esc avslutar. Gamepad fungerar också.
+
+![Meny](/brasse/metro-puzzle-jp/raw/branch/master/doc/img/menu.png)
+
+**I banan** startar du på den gröna dörrmattan. Stationen är en labyrint:
+mörka väggar, ljust golv, skyltar (blå tavla på stolpe), biljettautomat
+(låda med cyan skärm) och spärrar (stolpar med grön lampa). Rörelsen är
+rutbaserad – en ruta i taget, mjukt animerad, och riktning byts vid
+rutgränser. HUD:en visar bana, resmål, tid och antal steg.
+
+![Bana 001](/brasse/metro-puzzle-jp/raw/branch/master/doc/img/level-001.png)
+
+**Större stationer** scrollar: kameran följer dig och stannar vid kartans
+kanter. Bana 002 (Shinjuku, 33×21 rutor) finns för att testa just det.
+
+![Bana 002 – Shinjuku](/brasse/metro-puzzle-jp/raw/branch/master/doc/img/level-002.png)
+
+**Perrongen** (gul ledlinje längs kanten) avslutar banan. Står du på rätt
+perrong tar tåget dig till resmålet; fel perrong ger "Fel tåg!". R spelar om,
+Enter/Esc går till menyn. I M2 får perrongerna riktiga tåg med tidtabell och
+spärrarna börjar kräva kort.
+
+![Resultat](/brasse/metro-puzzle-jp/raw/branch/master/doc/img/result.png)
+
+> Japanska tecken (新宿, 山手線 …) visas först i M3 när en pixelfont med
+> kana/kanji är på plats – debugfonten saknar dem, därför romaji tills dess.
+
+### Uppdatera bilderna
+
+Bilderna ovan är pixelexakta skärmdumpar som spelet tar om sig självt i
+skriptläge. När grafik eller UI ändras:
+
+```bash
+go run ./tools/shots     # skriver doc/img/*.png (bygger debug, kör -script)
+git add doc/img && git commit
+```
+
+Wikin länkar till `doc/img/` på master, så den uppdateras automatiskt när
+repot gör det. Nya vyer: lägg till i listan i `tools/shots/main.go`.
+
 ## Arkitektur i korthet
 
 ```