# IDEA.md – ett eget sidscrollande arkadspel i webbläsaren Det här är en fristående uppdragsbeskrivning. Ge den i sin helhet till Claude Code (eller ett liknande verktyg), gärna tillsammans med ett designpaket från Claude Design, för att bygga ett eget spel. Den bygger på Thaleon, ett sidscrollande arkadspel i Rygars anda som designades i Claude Design, byggdes i Claude Code och fick sin ikon av Codex. ## 1. Vad som ska byggas Ett sidscrollande actionspel i webbläsaren med de klassiska arkadspelens mekanik och helt eget innehåll. Förebilden får bara låna genre och mekanik – inga namn, figurer, logotyper eller grafik. I Thaleon: - **24 rundor i sex riken**, var och en med tidsgräns, kontrollpunkter och en helgedom i slutet som räknar ihop tid, besegrade fiender och stenar (dubbelt om man inte dött i rundan) - **en hjälte** med ett vapen på kedja: kast framåt, i huk, i luften och i en båge över huvudet; hopp på huvudet bedövar; rep att klättra i - **en träff är döden**, tre liv, extraliv vid fasta poäng, continue bara i de tidiga rundorna - **stenar som reser sig och släpper föremål** när vapnet krossar dem: power-ups, poäng, tid, liv - **en jagare som kommer när tiden tar slut**, går genom väggar och blir snabbare - **två bossar** med egna faser - **attract-loop, menyer, inställningar** (skala, scanlines, skakning, volym, assist-läge, ombindning) och en gemensam topplista ## 2. Stack och arkitektur Det som **spelar roll** är markerat; resten går att byta. - **TypeScript och Vite, ren Canvas 2D, ingen spelmotor.** 384 × 216 internt, heltalsskalat med letterbox, fast tidssteg 60 Hz. - **Viktigt: designpaketets bilder och data är sanningen.** Figurer, rutor och bakgrunder som PNG-remsor med en atlas (bildrutor, ankare, tider), speldata som JSON (fysik, fiender, power-ups, poäng, alla rundor). Importera dem som de är – kopiera eller redigera dem aldrig i koden. Rita skärmarna i kod efter designens egna skärmbilder, så att de går att jämföra pixel för pixel. - **Viktigt: fysik och nåbarhet utan webbläsarberoenden**, så att verktygen kör exakt samma fysik som hjälten. - **Topplistan**: ett litet PHP-API som sparar i en JSON-fil utanför webbroten, med rimlighetskontroll per runda och en spärr per adress. `localStorage` som reserv. Ingen databas. - **Ljud**: syntetiserad chiptune i Web Audio, ett spår per rike plus boss, titel och skärmar, och effekter. Inga ljudfiler. ## 3. Beslut som visade sig avgörande **En rundgenerator i stället för handritade rundor.** Designen har en komplett första runda och speldata för alla 24. De andra byggs av en generator med ett frö per runda, ur varje rikes egna byggstenar: gropar med vätska, broar, steg, rep upp för för höga klippor, stenpelare i lava, öar över tomrum. Gropens bredd följer hoppfysiken. En runda skrivs först när nåbarhetsanalysen når målet – annars provas nästa frö. Generatorn är deterministisk: ändra generatorn och kör om den, redigera aldrig en genererad runda för hand. **Nåbarhet med spelets egen fysik.** Testet simulerar riktiga hopp med samma kod som hjälten och kontrollerar att målet eller bossarenan nås från start och att varje sten står på mark som går att nå. **Ett speltest som stegar exakt.** En krok i spelet som fryser loopen, stegar n tick och låter testet styra input. Testa flödet genom alla skärmar, inställningarna, fysiken (springfart, hopphöjd och -längd), vapnets räckvidd, varje fiende, varje föremål, död och continue, namninmatning till topplistan, båda bossarna, slutet och en körning genom alla rundor. **Tolka där designen lämnar något öppet, och skriv ner tolkningen.** ## 4. Fallgropar - **Låga fiender under vapnets höjd.** Ett vapen i midjehöjd träffar inte det som är lägre. Ge hjälten ett kast från huk, rakt fram i handens höjd. - **Bakgrund som flyter ihop med spelplanen.** Det närmaste parallaxlagret kan behöva ritas mörkare – byt varje färg mot närmaste färg i samma palett, så att paletten hålls. - **Bedövning som går att upprepa.** Ett hopp på en redan bedövad fiende ska inte bedöva den igen. - **Provspela tidigt.** Designens siffror (vapnets räckvidd, kastets vinkel) behövde justeras efter första provspelningen. - **Lita inte på poäng från klienten.** ## 5. Krav och mätningar - Springfart runt 1,5 px per tick, hopp runt 54 px högt och 62 px långt, vapnets räckvidd runt 72 px. - Alla 24 rundor nåbara enligt testet; speltestet grönt genom alla rundor och båda bossarna. ## 6. Så verifieras det - Typkontroll före bygget. - Nåbarhetstestet för alla rundor, och speltestet i en headless webbläsare mot det byggda spelet, inklusive att topplistans API svarar. - Spelkänsla, svårighet, ljud, handkontroll och mobil provspelas av en människa. ## 7. Arbetssätt - **Ärenden i ordning**: motor, hjälte, fiender, stenar och föremål, rundor och nåbarhet, bossar, skärmflöde, ljud, topplista. - **Provspelning som eget ärende**, med en lista över vad som ska kännas efter. - **Designuppdateringar läggs in som de är**, när de kommer. ## 8. Prompten > Bygg ett sidscrollande actionspel i webbläsaren i [TypeScript och Vite på ren Canvas 2D], med [Rygar] som förebild för mekaniken men med helt eget innehåll. [24] rundor i [sex] riken, en hjälte med [ett vapen på kedja], stenar som släpper power-ups, en jagare när tiden tar slut, [två] bossar och en gemensam topplista. > > Läs hela IDEA.md nedan först, och designpaketet om det finns. Designens bilder och data är sanningen. > > Arbeta så här: > 1. Dela upp bygget i ärenden och fråga mig om det som är öppet. > 2. Bygg rundorna med en deterministisk generator, och skriv en runda först när ett nåbarhetstest med spelets egen fysik når målet. > 3. Lägg in en krok som stegar spelet exakt, och testa det byggda spelet i en webbläsare. > 4. Låt mig provspela tidigt. > > [klistra in IDEA.md här]