metro-puzzle-jp/doc/spelbeskrivning.md

# Metro Puzzle JP – spelbeskrivning

Renskriven och omsorterad version av den ursprungliga idébeskrivningen
(2026-10-23). Allt innehåll från originalet finns med; där originalet var
otydligt står tolkningen i [§15](#15-tolkningar-av-originalet).

## 1. Koncept i korthet

- 2D-pusselspel i pixel art.
- Du leder ett sällskap – *lämmeltåget* – genom japanska tågstationer som
  är byggda som labyrinter.
- Målet på varje bana: **hitta rätt tåg och anländ till rätt resmål.**
- Nästan alla skyltar är på japanska. Hur mycket du förstår beror på vad du
  har lärt dig.
- Svårigheten kommer från sällskapets behov (mat, dryck, toa), tidsgränser,
  tågkort och biljetter, samt stationer och UI som är byggda för att förvirra.

## 2. Story

- Några polare är på semester i Japan.
- Spelet **börjar på flygplatsen** när man landar och **slutar när man ska
  tillbaka till flygplatsen**.
- Under resan upplever man Japan och köper saker: kläder, masker, hattar
  m.m. Dessa kan tas på och ger olika buffar allt eftersom man spelar.
- Slutet är en animation där karaktärerna flyger iväg. Alla items och poäng
  från omgången visas, sedan rullar eftertexterna.
- När storyn är klar låses **Oändligt läge** och **New Game+** upp.

## 3. Spellägen

### 3.1 Story-läge

- Banorna är statiska (handgjorda).
- Minispelen är slumpade utifrån en **seed** som genereras när banan startas
  och sparas när man sparar spelet, så en laddad omgång ger samma utfall.
- Två navigeringslägen att välja mellan:

  | Läge | Så funkar det | Poäng |
  |------|---------------|-------|
  | **Listläge** | Du får en lista över vilket tåg du ska ta härnäst för att komma rätt. | Normal |
  | **Skyltläge** | Ingen lista. Du använder skyltar och terminaler för att lista ut vilka tåg som tar dig rätt. 1–4 olika vägar kan vara korrekta. Tar du ett tåg/buss vars slutstation ligger i fel riktning i förhållande till starten, eller hamnar för långt bort, förlorar du. | Högre |

### 3.2 Oändligt läge

- Låses upp när storyn är klar. Separat spelläge med egen poänglista.
- Du får en slutstation. När du är framme får du dina poäng och sedan nästa
  mål. Målen är slumpade.

### 3.3 New Game+

- Spela om storyn och behåll alla dina skills.

### 3.4 Titelskärm, tutorial och trygghet (tillägg 2026-10-25)

- En **titelskärm** med spelets premiss i text, och val: fortsätt/starta,
  tutorial, inställningar, avsluta. **Första gången** spelet startas väljer
  man språk.
- En **tutorial** om grundmekaniken med tips och trix: **hur man läser
  skyltar** och **vad man bör memorera** (resmålets tecken) för att kunna
  köpa rätt biljett – gärna med **markering** av det viktiga och
  **nedtoning** av all annan information.
- **Esc-skydd:** trycker man Esc (flera gånger) ska en fråga dyka upp så att
  man inte råkar lämna/starta om banan av misstag. Det ska också gå att
  **stänga spelet** inifrån.
- Texten på bankartan ska få plats på bredden på svenska.

## 4. En bana – kärnloopen

1. Du startar på en station (eller kliver av ett tåg).
2. Stationen är en labyrint med skyltar. Du navigerar med hjälp av symboler,
   skyltar, terminaler och det du lärt dig (se §6).
3. Du passerar spärrar (kräver kort eller biljett, se §8), hittar rätt
   perrong och kliver på rätt tåg innan det går.
4. Banan är klar när du **anländer till rätt resmål**.

- De första och enklaste banorna är **ett enda tåg eller en buss**. Längre
  fram består en bana av **flera stopp och byten**.
- På vissa tåg och bussar förekommer minispel: att **få plats** på ett fullt
  fordon, att **kunna ta sig av**, och att **veta vilken station** man ska
  gå av på.
- Tåg avgår enligt tidtabell. Missar du ett tåg får du vänta på nästa, och på
  svåra banor kostar det tid du inte har (se §9).

**Tåg som kommer och går** (tillägg 2026-10-24):

- När ett tåg kör in eller avgår **blåser det nära rälsen** – en synlig
  vind (damm, papper, kläder och hår som fladdrar) för den som står vid
  perrongkanten.
- Står man nära rälsen ska det finnas en **visuell indikator på att ett tåg
  är på väg in** till stationen, innan det syns: vinden drar igång, lampor
  vid perrongkanten, strålkastare i tunneln.
- **Tåg och bussar har animationer** när de kör in till och ut från sina
  stationer och hållplatser, i stället för att bara dyka upp och försvinna.
- **Räls och väg har egen grafik** så att man ser var tågen och bussarna går.
- **De ikoniska melodierna** (発車メロディー) hörs när ett tåg är på väg in
  och när det strax ska avgå, innan dörrarna stängs.

**Stationen lever** (tillägg 2026-10-24):

- **Folk** – NPC:er som går på och av tåg och bussar, rör sig mellan
  butiker och in och ut från stationen. De är i vägen: man måste undvika
  dem och de kan sakta ned en.
- **Vänster- eller högertrafik**: på vissa ställen, i trappor och gångar,
  ska man gå på vänster eller höger sida. Går man fel sida krockar man med
  strömmen.
- **Bredare gångar**: vissa gångar och vägar på banorna är breda nog att
  man kan gå mellan folk.

**Vagnar** (tillägg 2026-10-24):

- Vissa tåg har **flera vagnar**, och man väljer vilken man kliver på.
- Det kan finnas **kvinnovagnar** (女性専用車). Har man en man i sällskapet
  och går på en sådan får man **grova minus**. Vagnen kan vara kvinnovagn
  **bara under vissa tider**, som står på skyltarna, och den markeras **rosa**.
- Perrongen har **kömarkeringar** som visar var man ställer sig för att komma
  på en vagn.
- Vagnarna har **olika mycket folk**. Tar man en vagn med **mindre folk** får
  man **mer poäng**. Tar man en med **mycket folk** kan man få **debuffar** av
  att bli svettig, och **minispelet blir svårare**: det blir svårare att kliva
  av på rätt station, och man måste **släppa förbi andra passagerare** som ska
  av på stationer där man själv inte ska av.
- Man **släpper av folk från tåget först** innan man får gå på.

**Flera våningar** (tillägg 2026-10-24):

- Banor och stationer kan ha **flera våningar**. Trappor (och rulltrappor/
  hissar) tar dig upp och ner mellan dem – ännu ett sätt att justera
  svårigheten på en bana.
- En bana kan **börja med en trappa** upp eller ner, eftersom en station kan
  ligga under mark, ovan mark eller i marknivå.

## 5. Sällskapet – lämmeltåget

- Dina polare följer efter dig i en rad – därav *lämmeltåget*.
- Varje karaktär har mätare för **mat**, **dryck** och **toa**.
- Folk måste gå på toa, köpa dricka och kan bli distraherade.
- **Ju fler i lämmeltåget, desto svårare** blir det och desto oftare händer
  specialhändelser (dricka, mat, toa m.m.).
- **Toaletter innanför och utanför** (tillägg 2026-10-24): toaletter kan
  ibland finnas **bara innanför** spärrarna, ibland **bara utanför** och
  ibland **på båda sidor**. Tillsammans med spärrar utan återvändo (§8)
  avgör det om man bör gå på toa före eller efter spärren.

## 6. Japanska, skyltar och hjälp

- Nästan alla skyltar i banorna är på japanska.
- Hur mycket **engelska** som finns på skyltarna beror på banans svårighet:
  lätt bana = mer engelska, svår bana = nästan bara japanska.
- Allt som översätts åt dig baserat på dina skills eller din japanska-nivå
  visas i **en annan färg**, eller måste **interageras med** för att visa
  översättningen.
- Översättningen kan vara **delvis**: bara de tecken eller ord du har lärt
  dig översätts, resten står kvar på japanska.
- Du kan **fråga en japan om hjälp**. Det tar tid, och tiden beror på hur bra
  din japanska är.
- Ju bättre din japanska är, desto **fler hintar** kan synas i UI och i banan.
- Huvudsyftet med stationslabyrinten är att navigera med symboler och
  skyltar, med stöd av dina skills.

**Så lär man sig ord** (tillägg 2026-10-23):

- **Bra poäng på en bana lär ut resmålets namn.** Klarar man banan med
  tillräckligt bra resultat kan man resmålets ord efteråt.
- **Ord man läser kan ge framsteg.** Varje gång man läser en skylt har varje
  okänt ord på den en chans att ge ett steg framåt. Har man fått tillräckligt
  många steg kan man ordet.
- **Fråga någon om hjälp** översätter skylten och lär ut ett ord direkt (§6
  ovan).
- **Språkpoäng kan läggas på valfria ord.** Man tjänar språkpoäng på banor
  och kan i sitt språkträd/sin ordlista välja fritt vilka ord ur hela listan
  man vill lära sig, mot en kostnad i poäng.

## 7. Minikarta

- Visar bara **avgångar** och några **riktmärken** som man kan förhålla sig
  till.
- När du upptäcker delar av stationen **fylls minikartan i** – för just den
  banan under just den spelomgången.

## 8. Tågkort, biljetter och telefon

- Du har ett **tågkort** (IC-kort) med saldo. Att hålla koll på kortet är en
  egen svårighetsgrad.
- Är kortet tomt måste du **hitta en automat** och klara ett **minispel** för
  att fylla på.
- På svårare banor måste du ibland köpa en **separat biljett**. Då kör du ett
  separat minispel för att köpa **rätt** biljett, annars kommer du inte på
  tåget i slutet av banan.
- Har du kortet **i telefonen** får du en **speed-buff**, men med en liten
  procentchans att behöva **skanna flera gånger** i spärren eller vid
  påfyllning.
- Telefonen har **batteri**. Dör det måste du köpa biljett i stället. Detta
  ska nästan bara kunna hända på **långa banor**.
- **Sittplatser** (tillägg 2026-10-24): som svårighet i biljettminispelet
  kan sällskapet ha önskemål om platser – någon vill sitta **bredvid en
  viss person**, någon vill sitta vid **gången eller fönstret**, någon på
  **höger eller vänster sida** av tåget. Du måste placera alla så att det
  stämmer.
- **Vem betalar** (tillägg 2026-10-24): har man fler än en person i
  följet ska man kunna **välja vem som köper** drickan i automaten, så att
  man kan vara strategisk och se till att **alla har pengar kvar på sina
  kort** till spärrarna.
- **Spärrar utan återvändo** (tillägg 2026-10-24): på vissa stationer kan
  man **inte gå tillbaka ut** genom spärren efter att man kommit in utan att
  åka någonstans. Måste man ut ändå får man **kalla på personal** – det
  finns oftast en **knapp vid spärren eller vid ett kontor** – så att de
  kan **låsa upp korten** åt en.

## 9. Svårighet och tid

- **Lätta banor:** ingen tidsgräns, försök hur länge du vill.
- **Svåra banor:** tidsgräns. Gör du för många fel missar du för många tåg
  och banan misslyckas.
- **Extra svårigheter:** överstimulerande UI och banor byggda för att förvirra
  spelaren räknas som egna, extra svårigheter.
- **Visuell röra** (tillägg 2026-10-24): banor med mer visuellt brus –
  reklam, affischer, blinkande skyltar – gör det svårare att hitta vart man
  ska. En egen svårighetsvariabel.
- **Ljudröra** (tillägg 2026-10-24): japanskt prat, utrop och reklam som
  ljudeffekter är också en svårighet; de konkurrerar med det man behöver
  höra (melodierna, utropen om spåret).
- Variabler som styr svårighet: antal i sällskapet, andel engelska på
  skyltar, kort-/biljettkrav, tidsgräns, antal byten, UI-störningar, antal
  våningar, egna kort, sittplatsönskemål.
- **Egna kort** (tillägg 2026-10-24): som svårighetsinställning har varje
  person i sällskapet **sitt eget tågkort**. Alla måste ha pengar på kortet
  för att komma igenom spärren – och på biljettbanor måste alla ha en
  biljett.

## 10. Poäng

Per bana baseras poängen på:

- **Tid.**
- **Minst pengar spenderade** och färst kortpåfyllningar.
- Hur bra **alla karaktärers mat-, dryck- och toamätare** står vid målgång.
- Skyltläge (§3.1) ger mer poäng än listläge.

## 11. Stats, buffar och debuffar

**Stats** som påverkas: speed, törst, fokus, toalett, tur.

**Debuffar** man kan drabbas av under spelet:

- onda fötter
- trötthet
- hunger / irritation
- matförgiftning (kortare toamätare)

**Temporära debuffar** från sidouppdrag (varar 1–4 banor), beroende på hur
bra man gjorde ifrån sig:

- träningsvärk
- skoskav (köpt dåliga skor)
- köpt något tungt eller stort
- proppmätt
- svettig och varm

**Buffar** kommer från kläder, masker, hattar och items som köps längs vägen,
från skills i skill tree, och från unika skills man får av sidouppdrag.

## 12. Progression och upplåsningar

- **Level-ups** och ett **skill tree**.
- **Skins** låses upp efter banor.
- **Bankarta** i spelbrädes-/världskartestil där man väljer bana.
- **Sidobanor** ger speciella skins, powers och items. Vissa items låser upp
  **genvägar** i andra huvudbanor.
- **Många items och skills** – man ska knappt få tag på 33 % av allt under
  en omgång.
- Sidouppdrag kan ge unika skills men också temporära debuffar (§11).

## 13. Ljud och grafik

- Pixel art.
- Ljud som påminner om japanska stationer: **avgångsmelodier** och
  **ankomstjinglar** som spelas när tåg kommer och går – melodin när tåget
  är på väg in, dörrsignalen strax före avgång.
- Bakgrundsljud: japanskt prat, utrop och reklam (se §9, ljudröra).

## 14. Slump och sparande

- Story-banor är statiska. Minispel är slumpade utifrån banans seed.
- Seeden genereras när banan startas och sparas med spelet.
- Oändligt läge drar slumpade mål.
- Sparfilen innehåller framsteg, items, skills, aktiva debuffar och seed.

## 15. Tolkningar av originalet

| Originalet | Tolkning här | Kommentar |
|------------|--------------|-----------|
| "Lämel tåg" | *Lämmeltåg*: sällskapet som följer efter dig i rad | Styr §5 |
| "level maps game box liknande styl av level väljande" | Bankarta i spelbrädes-/världskartestil | Kan ändras om något annat avsågs |
| "bilder och eventuella språk och tester" (resursmappen) | bilder, språk och *texter* | Se resurslayouten i roadmap |
| "slutstation ligger i fel riktning … eller hamnar för långt bort" (skyltläge) | Linjenätet (`network.json`) bedömer varje tåg: *fel håll* om linjen går till resmålet men tåget åt andra hållet; *för långt bort* om resmålet nås först efter fler än 12 stationer (fel varv på Yamanote-ringen, omvägen via city). Båda förlorar banan – i båda lägena, eftersom fel tåg alltid har förlorat | Gränsen 12 är `nav.MaxStops` och kan ändras |
| "skyltar och terminaler" | Terminalen är biljettautomaten: på nätkopplade banor visar den linjetavlan (linjer vid stationen med grannstationer åt båda hållen), läst genom ens japanska som en skylt | Egna terminalrutor kan komma senare |
| "flera stopp och byten" | En resa är en kedja av banfiler (`next` → delbana med `kind: "leg"`). Samma omgång fortsätter på nästa station med klocka, plånbok och sällskap; resmålet i HUD:en visas "via" bytesstationen. Vilken bytesstation som gäller bestämmer banan – spelaren väljer tåg, inte rutt | Fri ruttplanering (välj själv var man byter) är en möjlig utbyggnad |
| "slutar när man ska tillbaka till flygplatsen" | Sista huvudbanan (008) går Tokyo → Nippori → Narita flygplats med Keisei. När den klaras första gången visas hemresan: planet lyfter, resan summeras, eftertexter | Slutet går att se igen via `-ending` |
| Buss | Ett tåg med `vehicle: "bus"`: samma tidtabell och bedömning, ett fordon på väg med hållplatsskylt; flygbussterminalen (001b) är en biljettbana med tre bussar | Vägrutor som golv och hållplatser mitt i banan kan komma senare |
| "De ikoniska melodierna" | Egna syntetiserade stationsmelodier i klockklang (fyra stycken, en per station) – riktiga JR-melodier är upphovsrättsskyddade och spelas inte in | Byt filerna i `resources/sound/` om egna inspelningar finns |
| "Oändligt läge … målen är slumpade" | Målen är storyns stationer med lottade resmål (samma labyrint, samma tåg, nytt resmål avgör vilket tåg som är rätt), seedat; sällskapet växer och tidsgränsen krymper per mål; omgången slutar vid första förlust och hamnar i en egen poänglista | Slumpade labyrinter vid körning kan komma senare |
| "New Game+ … behåll alla dina skills" | Skills, XP och språkkunskap behålls; items, stjärnor, pengar och debuffar nollställs; sällskapet är en person större per NG+-varv | |
| Repo-namnet | Arbetsnamnet var "jp-subway-pussel"; Björn döpte Gitea-repot till **metro-puzzle-jp** (2026-10-23), så repo, modul, binär och titel heter så | Spelets visningsnamn "Metro Puzzle JP" kan ändras fritt i `resources/text/*.json` |