Snäckmageddon

Snäckmageddon is a Worms-style, turn-based artillery game with giant African land snails, built as an installable PWA with no build step. The interface is available in Swedish and English (auto-detected, switchable in the menu). Play it at https://snails.se/snailmageddon/ or on itch.io: https://knackpot.itch.io/snailmageddon.

Turbaserat artilleri-spel i Worms Armageddon-anda, fast med afrikanska jättesnäckor (Achatina) i stället för maskar. Byggt som en installerbar PWA i ren HTML/Canvas/JavaScript utan byggsteg eller beroenden.

Köra

Spelet måste serveras över HTTP (ES-moduler + service worker fungerar inte via file://):

npx serve .          # eller: python3 -m http.server 8080

Öppna sedan http://localhost:8080 (eller den port som skrivs ut). Publiceringen sker automatiskt till GitHub Pages vid varje push till main. Spelet ligger på https://snails.se/snailmageddon/: domänen sitter på hubben (Niklaser74/Niklaser74.github.io), och GitHub Pages lägger varje repo på kontot under snails.se/<repo>/. Därför har det här repot ingen CNAME och inga rotrelativa sökvägar — test/paths.test.mjs stoppar dem, och samma regel är det som gör itch- och Poki-zipparna möjliga. Manifestets "id": "/" är kvar från tiden på roten och ska inte ändras: samma id gör att installerade appar uppdateras i stället för att bli dubbletter. Allt på snails.se delar origin, så cache-namn (sw.js) och localStorage-nycklar är prefixade med spelets namn.

Snäckdesign

design/snails.html visar fem förslag på hur snäckorna kan se ut, ritade med samma kod som spelet använder (js/snails.js). Vald stil kan bytas i spelmenyn. Standardstilen sätts i js/main.js (settings.style).

id	Stil
cartoon	Tecknad Worms-stil (standard)
achatina	Naturtrogen Achatina med koniskt skal
kommando	Kommandosnäcka med hjälm och bandana
pixel	Retro 24×16 pixelsprite
flat	Flat/minimalistisk

Spelet

• 2–4 lag, 1–4 snäckor per lag, människa eller dator per lag.
• 45 sekunder per drag, 4 sekunders reträtt efter skott.
• Vapen: Bazooka (vind), Granat (studsar, 3 s), Saltspruta (kort räckvidd), Dynamit, Slemklot (klibbar fast, även på snäckor, 2 s), Saltregn (markörsiktat luftanfall). Dynamit, slemklot och saltregn har begränsad ammunition per lag.
• Lådor faller ner mellan dragen: hälsa (+35) eller extra ammunition. Lådor i en explosion smäller själva.
• Förstörbar terräng, fallskada, vatten som dränker, plötslig död efter 16 drag.
• Språk: svenska eller engelska, väljs automatiskt efter webbläsaren och kan bytas i menyn. All UI-text ligger i js/i18n.js; spelmotorn skickar meddelandenycklar.
• Guide: en fyrstegsguide visas i första matchen (gå, sikta, skjut, reträtt) och kan visas igen från hjälpdialogen.
• Mätning: ett fåtal anonyma händelser (app-öppning, matchstart/slut, guide) räknas i Supabase. Inga namn, inga IP-adresser, av på localhost och vid Do Not Track. Se supabase/README.md.
• Tangentbord: ← → / A D gå, ↑ ↓ / W S sikta, mellanslag ladda+skjut, Enter hoppa, 1–8 / Tab vapen, Esc meny. Touch: knappar på skärmen, dra för att panorera, nyp för zoom. Handkontroll: styrkors/spak, A skjut, B hoppa, LB/RB vapen, högerspak kamera, Start meny.

Snigelpost (asynkront multiplayer)

Spela mot en kompis i egen takt: skapa en match i menyn, skicka länken, spela ditt drag när du hinner. Varje drag lagras som inspelade indata i Supabase (snails_matches, snails_turns) och spelas upp exakt på motståndarens enhet tack vare den deterministiska simuleringen. Motståndarens senaste drag visas i tredubbel hastighet innan du får spela. Väntläget uppdateras automatiskt var åttonde sekund, och med knappen "Meddela mig när det är min tur" får du en push-notis när motståndaren spelat, även när sidan är stängd (iPhone kräver att spelet är installerat på hemskärmen). Kräver att anonym inloggning är påslagen i Supabase-projektet (Authentication → Sign In / Providers → Anonymous).

Deterministisk simulering

Simuleringen går i fasta steg om 1/60 s, all slump är seedad och all matte i simuleringen är motoroberoende (js/dmath.js). Kollisionsmasken beräknas analytiskt, aldrig från canvas-pixlar. Varje indata (tangent, touch eller AI) går genom game.tick() och spelas in som (tick, input)-par i game.recording. En inspelning kan spelas upp bit för bit med Game.fromRecording(canvas, recording), även utan webbläsare:

npm test               # determinismtester i Node, inga beroenden
npm install            # hämtar Playwright för webbläsartesterna
npm run test:browser   # spelar genom riktiga UI:t i Chromium, skärmdumpar i test-results/

Webbläsartestet driver simuleringen tick för tick (window.__manualTick) och jämför webbläsarens stateHash() med en headless Node-körning på samma seed (?seed=1234 i URL:en ger en reproducerbar match). Båda testsviterna körs i CI vid varje push.

game.stateHash() ger en 32-bitars hash av hela speltillståndet och används för att upptäcka om två körningar glider isär. Det här är grunden för replays, asynkront multiplayer och serversidig verifiering.

Distribution

• npm run build:itch bygger dist/snackmageddon-itch.zip för itch.io. Arbetsflödet Release build gör samma sak vid en versionstagg och kan pusha med butler, se docs/store/itch.md.
• js/platform.js känner av var spelet körs (egen sajt, itch.io, Poki) och kopplar in Pokis SDK bara där. ?platform=poki tvingar läget för test. Se docs/store/poki.md.
• Butikstexter, omslag och skärmdumpar ligger i docs/store/.

Struktur

index.html            app-skal, meny, HUD
manifest.webmanifest  PWA-manifest
sw.js                 service worker (cache-first, offline)
css/style.css
js/main.js            meny, HUD, input, kamera, PWA-registrering
js/game.js            spellogik: turordning, fysik, vapen, AI, rendering (regelversioner: docs/REGELVERSIONER.md)
js/daily.js           Dagens skott: bana och vapen ur datumet, topplista
js/cosmetics.js       skalmönster och hattar, upplåsningsregler, ritning
js/season.js          säsong (kvartal), Elo-spegel och ranknivåer
js/themes.js          terrängteman: färger och dekorationer, rent visuellt
js/gamepad.js         handkontroll (Gamepad API), skriver in i game.input
android/              Bubblewrap-konfiguration för Google Play (docs/store/google-play.md)
privacy.html          integritetspolicy (krävs av Google Play)
js/terrain.js         förstörbar terräng (canvas + kollisionsmask)
js/snails.js          snäck-sprites (alla stilar)
js/audio.js           syntetiserade ljudeffekter
js/rng.js             seedad slump, shuffle, tillståndshash
js/dmath.js           motoroberoende sin/cos/atan2
js/i18n.js            ordlista svenska/engelska
js/supa.js            Supabase-klient (anonym auth, RPC) utan bibliotek
js/online.js          Snigelpost: matcher, drag, replay
js/analytics.js       mätning
js/platform.js        web / itch.io / Poki
js/analytics.js       anonym räknare (Supabase)
js/platform.js        plattformsadapter (web, itch.io, Poki)
scripts/build-itch.mjs paketering för itch.io
docs/store/           butikstexter och bilder
test/                 determinism- och webbläsartester (körs i CI)
design/snails.html    designförslag
icons/                app-ikoner