BlueGit

projects-timfalken-com allianties

Files

allianties
README.md

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.