# Metro Puzzle JP

Ett pixel art-pusselspel om att hitta rätt tåg i Tokyo. Du leder ett
sällskap – *lämmeltåget* – genom japanska tågstationer byggda som
labyrinter. Nästan allt står på japanska: läs skyltarna, håll sällskapet
mätt, torrt och på toa, hitta rätt perrong och kliv på rätt tåg innan det
går. Storyn följer några polare på semester, från landningen på Narita till
hemresan; efteråt väntar ett oändligt läge och New Game+.

![Titelskärmen](doc/img/title.png)

![Skyltarna läser du genom att leta efter resmålets tecken](doc/img/tips-sign.png)

![Välj vagn när tåget står inne](doc/img/cars.png)

## Spela

Ladda ner zippen för Linux eller Windows från releasen
[latest](https://gitea.brasse-pc.eu/brasse/metro-puzzle-jp/releases/tag/latest)
(eller en versionerad `vX.Y.Z`), packa upp och kör `metro-puzzle-jp`;
mappen `resources/` ska ligga bredvid. Första gången väljer du språk, och
**Tutorial** i menyn går igenom grunderna. Hur allt fungerar – skyltar,
kort och biljetter, sällskapet, tåg och byten, lägena, inställningarna –
står i [wikin](https://gitea.brasse-pc.eu/brasse/metro-puzzle-jp/wiki).

## Bygga

Enda kravet är **Go ≥ 1.27**; Linux behöver dessutom gcc och X11/GL/ALSA-
headers för fönstret (`sudo pacman -S --needed go gcc pkgconf mesa libx11
libxrandr libxcursor libxinerama libxi libxxf86vm alsa-lib` på Arch/Garuda).
Windows-bygget är ren Go och kan korsbyggas från Linux.

```bash
go run ./tools/build                           # debug  → build/debug/
go run ./tools/build -mode release -os linux   # release → build/release/linux-amd64/
go run ./tools/build -mode release -os windows # korsbygge → build/release/windows-amd64/
go test ./...
```

VS Code: `Ctrl+Shift+B` bygger, `F5` debuggar. Flaggor, verktyg, styrning,
beroenden och katalogstruktur:
[Bygga och verktyg](https://gitea.brasse-pc.eu/brasse/metro-puzzle-jp/wiki/Bygga-och-verktyg)
i wikin.

## Dokumentation

- [Wikin](https://gitea.brasse-pc.eu/brasse/metro-puzzle-jp/wiki) – så fungerar spelet, bygga och verktyg
- [doc/spelbeskrivning.md](doc/spelbeskrivning.md) – hela speldesignen
- [doc/roadmap.md](doc/roadmap.md) – teknikval och milstolpar
- [doc/mal-och-tester.md](doc/mal-och-tester.md) – mål, teststrategi, checklistor
- [doc/plan.md](doc/plan.md) – navet med öppna frågor
- [CHANGELOG.md](CHANGELOG.md)