BlueGit

projects-timfalken-com allianties

Files

allianties / README.md

README.md

README.md 4.9 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 (Europe/Amsterdam, standaard 00:00) 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 (Europe/Amsterdam) 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 (Europe/Amsterdam),

standaard 00:00. Jury en krimp vallen samen met dit tijdstip.

  • 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.

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/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 (Europe/Amsterdam, standaard 00:00) 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 (Europe/Amsterdam) 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 (Europe/Amsterdam),
38 standaard 00:00. Jury en krimp vallen samen met dit tijdstip.
39- **Bordgrootte**: de host kiest de zijde van het vierkante bord (6–24).
40 De suggestie is `max(6 + ceil(n / 2), n + 1)` (2 spelers: 7×7; 6: 9×9;
41 10: 11×11; 14: 15×15) en wordt bijgewerkt als er mensen joinen, tenzij
42 de host zelf een maat instelt. `ceil` rondt halven naar boven af.
43- **Zichtbaarheid** (standaard alles openbaar): de host bepaalt wie schoten,
44 giften, actiepuntentotalen, bereik en levens ziet. Voor levens en
45 actiepunten is er een tussenoptie *Binnen bereik*: je ziet die gegevens
46 van een speler die in **jouw** schootsveld staat. Dat verschilt van de
47 bereik-optie *Bekend bij spelers binnen bereik*, die kijkt naar **diens**
48 bereik. De server filtert de staat en de tijdlijn per kijker. Eigen
49 gegevens en verplaatsingen blijven altijd zichtbaar.
50
51Events staan niet in een tekstlog: je ziet ze alleen in de video-weergave
52van de tijdlijn (groene pijl bij een gift, rode pijl bij een schot, een
53schuivende pion bij een zet, een pulsering bij een bereik-upgrade). Klik
54of tik ergens op de balk om naar het dichtstbijzijnde event te springen;
55slepen scrubt, ook met touch.
56
57De aannames bij deze regels staan in [`docs/ASSUMPTIONS.md`](docs/ASSUMPTIONS.md).
58
59## Lokaal bouwen en draaien
60
61```bash
62# Tests
63node --test test/*.test.js
64php server/tests/run.php
65
66# Bundel (src/ → build/game.js) en kopieer de PHP-API naar build/
67./src/build.sh
68# of: npm run build
69
70# Met API (lokale testers: auth.php?test=1 tot ?test=8)
71php -S 127.0.0.1:8080 -t build build/router.php
72# spel: http://127.0.0.1:8080/
73```
74
75De testlogins (`auth.php?test=1` … `?test=8`) werken alleen op localhost en
76zijn op de live site uitgeschakeld.
77
78## Architectuur
79
80| Pad | Rol |
81| --- | --- |
82| `src/i18n.js` | Vertalingen en vlaggenkiezer (Engels als standaard, 10 talen) |
83| `src/rules.js` | Client-spiegel van raster, Chebyshev, staakt-het-vuren (incl. zomertijd) |
84| `src/api.js` | API-client, CSRF, lichte `sync`-poll |
85| `src/main.js` | Menu, lobby, bord, tijdlijn, klok-editor, countdowns |
86| `server/lib/Engine.php` | Authoritatieve regelmotor: zetten, jury, krimp, staakt-het-vuren, einde |
87| `server/lib/Store.php` | SQLite, `BEGIN IMMEDIATE`, JSON-game, profielen |
88| `server/lib/i18n.json` | Gedeelde catalogus (JS en PHP) |
89| `docs/ASSUMPTIONS.md` | Alle aannames waar de specificatie ruimte liet |
90| `src/build.sh` | Bundelt bronnen naar `build/` |
91| `ci/` | FTP-deploy **zonder** `--delete`. Expandeert `$timftproot`. Raakt `favicon.ico` en `data/` niet aan. |
92
93De server is leidend bij elke actie. De client toont legale zetten die de
94server meestuurt en speelt de tijdlijn af uit het eventlog.
95
96## Vertalingen
97
98Standaardtaal is Engels. Rechtsonder kies je een van tien talen via de vlag
99(Verenigd Koninkrijk, Nederland, Duitsland, Frankrijk, Japan, China, Korea,
100Polen, Rusland, Spanje). De keuze staat in `localStorage` en, als je
101ingelogd bent, in je profiel, en wordt bij inloggen weer toegepast. De
102spelnaam blijft altijd **Allianties**.