# IDEA.md – ett eget realtidsstrategispel i webbläsaren Det här är en fristående uppdragsbeskrivning. Ge den i sin helhet till Claude Code (eller ett liknande verktyg) för att bygga ett eget spel. Den bygger på det som lärdes när Chronicles of the Core byggdes, ett realtidsstrategispel i Warcraft III:s anda som kodades av Claude Code, ritades av Codex och fick röster, ljud och musik från ElevenLabs. ## 1. Vad som ska byggas Ett realtidsstrategispel (RTS) i webbläsaren med de klassiska spelens mekanik: bygga bas, samla resurser, träna en armé och leda hjältar. Allt innehåll – värld, folk, enheter, namn, bilder och ljud – ska vara ert eget. Mekaniken får ha en förebild; innehållet får inte lånas. Spelet ska ha: - **flera raser** (Chronicles har fyra), var och en med arbetare, ett tiotal stridsenheter, hjältar och ett tolvtal byggnader, med tier-uppgraderingar av huvudbyggnaden - **resurser** (guld, timmer, food-tak) och **upkeep** som minskar guldinkomsten när armén växer - **hjältar** med nivåer, förmågor och inventarium - **creeps, föremål, dag och natt** och en egen mekanik som drar spelarna mot kartans mitt - **skirmish** mot datorn på flera kartor och svårighetsgrader, gärna kartor med egna mål - en **kampanj** med berättelse före och efter uppdragen - senare: **multiplayer**, **repriser**, ett **kartverktyg**, sparade spel och en mobilversion **Inte i början**: multiplayer. Bygg för det från första dagen (se nedan), men gör singleplayer först, och en spelbar ras före de andra. ## 2. Stack och arkitektur Det som **spelar roll** är markerat; resten går att byta. - **Klienten**: TypeScript och Vite, React för menyer och HUD, **PixiJS** (WebGL) för spelvärlden, isometrisk 2D. - **Servern** bär inget av själva spelet: konton, sparade spel, kampanjframsteg, statistik, repriser och egna kartor. Chronicles använder PHP med MariaDB; vad som helst går. - **Viktigt: en simulering utan DOM, rendering eller React** (`sim/`). Beroenden går bara nedåt: gränssnitt och rendering läser simuleringen, aldrig tvärtom. Då kan den köras i Node för tester och på andra datorer för multiplayer. - **Viktigt: all balans och allt innehåll i datafiler** (`data/`), inte i koden. - **Fast tick** (20 per sekund); renderingen interpolerar mellan två tick. - **Order är det enda sättet att påverka simuleringen** – från spelaren, datorn och kampanjskripten. Samma format blir repriser och multiplayer. - **Entiteter i en tabell** med komponentfält, ingen klasshierarki. A* på ett rutnät med åttariktad rörelse, grupper som delar väg och håller formation. ## 3. Beslut som visade sig avgörande **Deterministisk simulering från början.** Samma startläge och samma order ska ge exakt samma förlopp, i alla webbläsare. Egen seedad slump, inga `Math.random` eller `Date`, inga osorterade iterationer, entiteter i id-ordning. Webbläsarna räknar inte `Math.sin`, `Math.pow`, `**` eller `Math.hypot` exakt likadant: förbjud dem med en lintregel i simuleringen, datorspelaren och kartgeneratorn, och skriv ersättare som bara använder `+ - * /` och `Math.sqrt`. Då fungerar lockstep-multiplayer, repriser och rapporter som går att spela upp. **Prova determinismen i tre motorer.** Kör samma matcher i Chromium, Firefox och WebKit och jämför en checksumma för varje spelminut. **Flera agenter med kontrakt emellan.** Kodagenten skriver koden och beställer grafik och ljud av andra agenter. De läser inte varandras kod; de arbetar mot kontrakt: - **Grafik**: ett `manifest.json` och en stilguide med cellstorlek, ankarpunkter, bildrutor, palett, ljusriktning och konturer. En beställning är en markdownfil. Bildagenten arbetar i en sandlåda som bara når grafikmappen, skalar ner och exporterar till rätt palett med egna verktyg och gör ett kontaktark. Ett skript prövar leveransen mot kontraktet. - **Ljud**: ett skript läser spelets data och skriver ett ljudmanifest – id, filnamn, text och röst för varje klipp. Ett test kontrollerar att varje berättelsesida har en inspelning med rätt text. En lyssningssida låter människan höra igenom och välja innan något kommer in i spelet. - **Reserver**: det som inte är levererat ritas i kod och låter med Web Audio, så att spelet alltid går att spela. **Människan bedömer smak.** Agenterna kontrollerar mått, format och funktion. Om något ser bra ut och känns roligt avgör människan, och ingen bild räknas som godkänd automatiskt. **Rapporter med repris.** Spelare kan skicka en rapport från spelet med den pågående matchen som repris och de senaste felmeddelandena. Repriset spelas upp till rapportens tick och checksumman jämförs. En liten MCP-server ger kodagenten rapporterna. **Datorspelaren skickar order som en spelare** och läser bara det en spelare får se. ## 4. Fallgropar - **Flyttal skiljer sig mellan webbläsare.** Se ovan – det märks först i multiplayer, och då är det dyrt. - **Arbetare som skickas till otillgängliga resurser** söker väg om och om igen. Dela upp marken i sammanhängande regioner och välj bara mål i den egna. - **Bildfrekvens i automatiska tester säger ingenting** – testwebbläsaren ritar i mjukvara. Mät på riktig hårdvara. - **Siffror i koden** blir omöjliga att balansera. Allt i datafiler. - **Stora uppdrag går sönder.** Korta kort med ett mål och en mätning fungerar bättre. - **Under WSL är filöverföringen mot en Windows-disk långsam.** Kör byggverktygen med Windows egen node, eller lägg projektet på Linux-sidan. ## 5. Krav och mätningar - Simuleringen kör samma match två gånger med samma checksumma, i tre webbläsarmotorer. - Ett test spelar en match mellan datorspelare och mäter vinstandelen per ras och svårighetsgrad. - Hundratals enheter på skärmen utan att bildfrekvensen faller på riktig hårdvara. ## 6. Så verifieras det - Lint, enhetstester, typkontroll och produktionsbygge utan fel. - **I en riktig webbläsare** (Playwright): det kortet gäller går att göra, konsolen är tom på fel, skärmbilder sparas. - **Determinismprov** i tre motorer. - **Provspelning** av människan för spelkänsla och utseende, som egna kort. ## 7. Arbetssätt - **Research först**: förebildens mekanik – resurser, upkeep, attack- och rustningstyper, XP-tabeller – skriven som ett eget underlag. - **En designbibel** (världen, raserna, enheterna, kampanjen) och en arkitektur i repot. Ärendena håller *vad*, repot håller *varför*. - **Besluten först**: grafikstil, tillgångar, multiplayer eller inte, omfång, språk. - **Ett ärende i taget**, med mätningen i den avslutande kommentaren. ## 8. Prompten > Bygg ett realtidsstrategispel i webbläsaren i [TypeScript med React och PixiJS], med [Warcraft III] som förebild för mekaniken men med helt eget innehåll: en egen värld, [fyra] egna folk, enheter, hjältar och en kampanj. Börja med singleplayer mot datorn och en spelbar ras. > > Läs hela IDEA.md nedan först. Den beskriver spelet, arkitekturen, de beslut som visade sig avgörande och fallgroparna att undvika. > > Arbeta så här: > 1. Gör research på förebildens mekanik och skriv en designbibel. Fråga mig om grafikstil, tillgångar, multiplayer och omfång innan något byggs. > 2. Håll simuleringen deterministisk och fri från rendering från första dagen. > 3. Lägg all balans i datafiler. > 4. Beställ grafik och ljud genom manifest, och låt mig godkänna utseendet. > 5. Prova varje funktion i en riktig webbläsare, och lämna spelkänslan åt mig att provspela. > > [klistra in IDEA.md här]