# Allianties Webspel naar de basisregels van *Tank Turn Tactics* (Halfbrick). Gebouwd voor [projects.timfalken.com](https://projects.timfalken.com/allianties/). De spelnaam blijft in elke taal **Allianties**. Live (na de eerste deploy): https://projects.timfalken.com/allianties/ ## Spelen 1. Log in met je account op [auth.timfalken.com](https://auth.timfalken.com). 2. Maak een lobby of voer een uitnodigingscode in. Deel de link of de code. 3. De host start het spel zodra er minstens twee spelers zijn. Het spel blijft daarna lopen, dagenlang, tot er één overlevende is. 4. Elke tank begint met 3 levens, bereik 2 (Chebyshev, ook diagonaal) en 1 actiepunt. Elke dag op het ingestelde tijdstip (standaard 00:00, in de lokale tijd van de host) krijgt elke levende speler 1 actiepunt erbij. 5. Voor 1 actiepunt kun je: één vakje bewegen (8 richtingen, niet op een bezet of onbegaanbaar vakje), een speler binnen bereik beschieten (−1 leven), je bereik met 1 vergroten, of actiepunten geven aan een speler binnen bereik. 6. Bij 0 levens ben je uitgeschakeld. De laatste overlevende wint. Overgeven kan via het instellingenmenu, na een duidelijke bevestiging. Optionele regels (in de lobby, vóór de start): - **Jury** (standaard aan): dode spelers stemmen dagelijks op één levende speler. Wie de meeste stemmen heeft, krijgt +1 actiepunt bij de volgende uitdeling. Stemmen zijn geheim en tot de uitdeling te wijzigen. - **Krimpend speelveld** (standaard uit): na een instelbaar aantal dagen (standaard 7) wordt de buitenste ring onbegaanbaar. Spelers die erop staan verliezen een leven en worden naar binnen geduwd. - **Gedwongen staakt-het-vuren** (standaard uit): in door de host gekozen uren mag niemand schieten. De periodes zijn te tekenen op een 24-uursklok. - **Actiepunten plunderen bij een kill** (standaard uit): alleen bij een uitschakelend schot krijgt de schutter de resterende AP van het doelwit. - **Dagelijks AP-tijdstip**: per lobby instelbaar, standaard 00:00. Jury en krimp vallen samen met dit tijdstip. - **Tijdzones**: iedere speler ziet en voert alle tijden in zijn eigen lokale tijd in (browserzone). De host definieert tijden in zijn zone; de server bewaart ze met die IANA-zone en rekent exact, ook rond zomertijd. - **Alleen de host** mag de spelregels wijzigen (server: 403). - **Bordgrootte**: de host kiest de zijde van het vierkante bord (6–24). De suggestie is `max(6 + ceil(n / 2), n + 1)` (2 spelers: 7×7; 6: 9×9; 10: 11×11; 14: 15×15) en wordt bijgewerkt als er mensen joinen, tenzij de host zelf een maat instelt. `ceil` rondt halven naar boven af. - **Zichtbaarheid** (standaard alles openbaar): de host bepaalt wie schoten, giften, actiepuntentotalen, bereik en levens ziet. Voor levens en actiepunten is er een tussenoptie *Binnen bereik*: je ziet die gegevens van een speler die in **jouw** schootsveld staat. Dat verschilt van de bereik-optie *Bekend bij spelers binnen bereik*, die kijkt naar **diens** bereik. De server filtert de staat en de tijdlijn per kijker. Eigen gegevens en verplaatsingen blijven altijd zichtbaar. Events staan niet in een tekstlog: je ziet ze alleen in de video-weergave van de tijdlijn (groene pijl bij een gift, rode pijl bij een schot, een schuivende pion bij een zet, een pulsering bij een bereik-upgrade). Klik of tik ergens op de balk om naar het dichtstbijzijnde event te springen; slepen scrubt, ook met touch. De aannames bij deze regels staan in [`docs/ASSUMPTIONS.md`](docs/ASSUMPTIONS.md). ## Lokaal bouwen en draaien ```bash # Tests node --test test/*.test.js php server/tests/run.php # Bundel (src/ → build/game.js) en kopieer de PHP-API naar build/ ./src/build.sh # of: npm run build # Met API (lokale testers: auth.php?test=1 tot ?test=8) php -S 127.0.0.1:8080 -t build build/router.php # spel: http://127.0.0.1:8080/ ``` De testlogins (`auth.php?test=1` … `?test=8`) werken alleen op localhost en zijn op de live site uitgeschakeld. Met `&avatar=none` (geen profielplaatje) of `&avatar=broken` (plaatje-URL die 404 geeft) test je spelers zonder plaatje. Browsertests (Playwright, met de lokale server): ```bash python3 test/ui-playwright.py # hele flow, desktop + mobiel python3 test/lobby-interaction-playwright.py # klok slepen, focus, host-only, tijdzones python3 test/avatar-layout-playwright.py # speelstukken zonder plaatje, geen scroll op mobiel ``` ## Architectuur | Pad | Rol | | --- | --- | | `src/i18n.js` | Vertalingen en vlaggenkiezer (Engels als standaard, 10 talen) | | `src/rules.js` | Client-spiegel van raster, Chebyshev, staakt-het-vuren (incl. zomertijd) | | `src/api.js` | API-client, CSRF, lichte `sync`-poll | | `src/avatar.js` | Speelstukken: kleurcirkel met initialen, plaatje erbovenop (robuust bij laadfouten) | | `src/main.js` | Menu, lobby, bord, tijdlijn, klok-editor, countdowns | | `server/lib/Engine.php` | Authoritatieve regelmotor: zetten, jury, krimp, staakt-het-vuren, einde | | `server/lib/Store.php` | SQLite, `BEGIN IMMEDIATE`, JSON-game, profielen | | `server/lib/i18n.json` | Gedeelde catalogus (JS en PHP) | | `docs/ASSUMPTIONS.md` | Alle aannames waar de specificatie ruimte liet | | `src/build.sh` | Bundelt bronnen naar `build/` | | `ci/` | FTP-deploy **zonder** `--delete`. Expandeert `$timftproot`. Raakt `favicon.ico` en `data/` niet aan. | De server is leidend bij elke actie. De client toont legale zetten die de server meestuurt en speelt de tijdlijn af uit het eventlog. ## Vertalingen Standaardtaal is Engels. Rechtsonder kies je een van tien talen via de vlag (Verenigd Koninkrijk, Nederland, Duitsland, Frankrijk, Japan, China, Korea, Polen, Rusland, Spanje). De keuze staat in `localStorage` en, als je ingelogd bent, in je profiel, en wordt bij inloggen weer toegepast. De spelnaam blijft altijd **Allianties**.