BlueGit

projects-timfalken-com allianties

Files

allianties / README.md

README.md

README.md 5.7 KiB Download Raw

Allianties

Webspel naar de basisregels van Tank Turn Tactics (Halfbrick). Gebouwd voor projects.timfalken.com. 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. 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.

Lokaal bouwen en draaien

# 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):

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

PadRol
src/i18n.jsVertalingen en vlaggenkiezer (Engels als standaard, 10 talen)
src/rules.jsClient-spiegel van raster, Chebyshev, staakt-het-vuren (incl. zomertijd)
src/api.jsAPI-client, CSRF, lichte sync-poll
src/avatar.jsSpeelstukken: kleurcirkel met initialen, plaatje erbovenop (robuust bij laadfouten)
src/main.jsMenu, lobby, bord, tijdlijn, klok-editor, countdowns
server/lib/Engine.phpAuthoritatieve regelmotor: zetten, jury, krimp, staakt-het-vuren, einde
server/lib/Store.phpSQLite, BEGIN IMMEDIATE, JSON-game, profielen
server/lib/i18n.jsonGedeelde catalogus (JS en PHP)
docs/ASSUMPTIONS.mdAlle aannames waar de specificatie ruimte liet
src/build.shBundelt 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.

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