BlueGit

projects-timfalken-com allianties

Files

allianties / docs / ASSUMPTIONS.md

ASSUMPTIONS.md

ASSUMPTIONS.md 12.3 KiB Download Raw

Aannames — Allianties

Waar de specificatie ruimte liet, gelden deze keuzes. Ze zijn ook in de regelmotor (server/lib/Engine.php) en de tests vastgelegd.

Bord en plaatsing

  • Het bord is vierkant. Grootte: max(6, ceil(sqrt(n × 6))). Twee tot

zes spelers: 6×6; acht spelers: 7×7; twaalf: 9×9.

  • Startposities liggen op een ring rond het midden, beginnend bovenaan en

dan met de klok mee. Bij een botsing schuift de speler naar het dichtstbij zijnde vrije vakje. Dode spelers blokkeren geen vakjes meer, maar blijven visueel op hun laatste plek (uitgegrijsd).

  • Maximaal 16 spelers per spel, minimaal 2 om te starten. Er is geen

aparte “klaar”-stap: de host start wanneer er minstens twee spelers zijn.

  • Kleuren van de omlijning worden in volgorde van aansluiting uit een vaste

palet van 16 contrasterende kleuren gekozen.

Actiepunten en tijd

  • Iedereen begint bij de start met 1 actiepunt, zodat je meteen kunt

handelen.

  • Daarna krijgt elke levende speler 1 punt bij elke dagelijkse uitdeling

(Europe/Amsterdam). Het tijdstip is per lobby instelbaar, standaard 00:00, en volgt de wissel naar en van zomertijd. Als de server een paar dagen offline was, worden gemiste uitdelingen bij de volgende request ingehaald.

  • De countdown bovenaan is HH:MM:SS tot de volgende uitdeling, op basis

van de servertijd (met correctie voor klokverschil in de browser) en tikt live zolang het tabblad open is.

  • Bereik heeft een plafond gelijk aan de maximale Chebyshev-afstand op het

bord (grootte − 1), zodat “het hele bord” het maximum is.

  • Meerdere actiepunten in één keer geven telt als één actie (één tik op de

tijdlijn).

Jury (standaard aan, in de lobby uit te zetten)

  • Alleen uitgeschakelde deelnemers (inclusief wie zich heeft overgegeven)

mogen stemmen, en alleen op een levende speler.

  • Stemmen zijn geheim: anderen zien jouw stem niet. Je kunt hem wijzigen

tot de uitdeling. Daarna worden de stemmen gewist voor de nieuwe dag.

  • Bij een unieke winnaar krijgt die +1 AP bovenop het dagelijkse punt.

Bij een gelijke stand krijgt iedere gelijkstaande levende speler de bonus. Als niemand heeft gestemd, is er geen bonus.

  • De bonus wordt ná een eventuele krimp uitgedeeld, zodat wie die dag

door de krimp sterft geen punten meer krijgt.

Krimpend speelveld (standaard uit)

  • De host zet het interval (1–30 dagen, standaard 7). De eerste krimp is

op uitdeling nummer N na de start (dag N), daarna elke N dagen, op het AP-tijdstip van de lobby.

  • Elke krimp maakt de buitenste begaanbare ring onbegaanbaar

(arena_inset + 1). Minimum speelbaar veld is 3×3, dus op een 6×6-bord stopt de krimp bij 4×4 (max_inset = floor((grootte − 3) / 2)).

  • Spelers op de nieuwe ring verliezen 1 leven. Overleven ze, dan gaan ze

naar het dichtstbijzijnde vrije begaanbare vakje (eerst Chebyshev, dan Euclidean naar het midden, dan een vaste (y, x)-volgorde). Spelers worden in volgorde van hun id verplaatst, zodat het deterministisch is.

  • Is er géén vrij begaanbaar vakje meer, dan is de speler

vermorzeld: 0 levens, uitgeschakeld.

  • Sterven de laatste twee (of meer) in dezelfde krimp, dan is het

gelijkspel.

  • De UI toont wanneer de volgende krimp is en markeert de ring die dan

verdwijnt.

Gedwongen staakt-het-vuren (standaard uit)

  • De host tekent één of meer periodes op een 24-uursklok (0 bovenaan, met

de klok mee), of vult exacte tijden in. Periodes mogen over middernacht lopen. Een periode met gelijke begin- en eindtijd wordt genegeerd. Overlappende periodes worden voor de countdown samengevoegd.

  • Tijden zijn wandkloktijden in Europe/Amsterdam. Bij de overgang naar

zomertijd is een periode korter in echte seconden (het overgeslagen uur telt niet); bij de terugzetting is hij langer (het herhaalde uur telt twee keer). Het einde van een periode is exclusief (06:00 precies is niet meer staakt-het-vuren als de periode tot 06:00 loopt).

  • Tijdens het staakt-het-vuren is schieten server-side geweigerd

(ceasefire). Bewegen, punten geven, bereik vergroten, overgeven, stemmen, notities en chat blijven mogelijk. De knop Aanvallen is uitgeschakeld met een toelichting.

  • Onder de AP-timer staat “Tijd over in het staakt-het-vuren: HH:MM:SS”

of “Tijd tot het staakt-het-vuren: HH:MM:SS”.

  • Staat de regel aan zonder periodes, dan is er feitelijk geen

staakt-het-vuren.

Lobby, sessie, verwante zaken

  • Uitnodigen gaat via een 6-teken-code (zonder 0/O/I/1/L) en een deelbare

link ?join=CODE. Na inloggen kom je terug bij die link.

  • Verlaat de host de lobby vóór de start, dan wordt de vroegst

aangesloten overgebleven speler de nieuwe host. Is de lobby leeg, dan verdwijnt hij.

  • Tijdens een lopend spel kun je niet meer instappen. Eén speler mag in

meerdere spellen tegelijk zitten.

  • Overgeven maakt je dood (0 levens, vlag surrendered); je mag daarna

nog wel als jury stemmen en berichten sturen, als de jury aan staat.

  • Privénotities staan server-side, per kijker, over een andere (of jezelf)

speler. Chat is 1:1, alleen zichtbaar voor de twee betrokkenen. Dode spelers mogen nog chatten.

  • Sessie duurt 30 dagen en wordt bij activiteit verlengd. Avatar komt uit

het profiel van auth.timfalken.com (avatar_url / avatar / picture) of, als fallback, https://auth.timfalken.com/avatar/{id}. Bij een ontbrekende afbeelding toont de client initialen.

  • Taalcodes volgen Meteors: intern zh (HTML zh-Hans), vlaggen gb,

jp, cn, kr. De keuze staat in localStorage (allianties-locale) en in het profiel.

  • Extra regels (harten op het bord, levens kopen, AP plunderen bij een

kill, …) zijn nog niet gebouwd; de motor is modulair zodat ze later als schakelaar kunnen.

Actiepunten-tijdstip en plunderen

  • Elke lobby heeft een dagelijks AP-tijdstip (Europe/Amsterdam),

standaard 00:00. De host stelt het in met een tijdkiezer. Op dat moment gebeuren de AP-uitdeling, de jurybonus en (indien aan) het krimpen van het veld. Een “dag” in het spel is één zo’n uitdeling. Bij een DST-lentesprong bestaat een gekozen tijd in de overgeslagen periode (bijv. 02:30) niet; PHP landt op het eerste geldige moment daarna (typisch 03:30 CEST). Bij de herfst blijft 02:30 geldig (PHP gebruikt de eerste voorkomst).

  • Actiepunten plunderen bij een kill staat standaard uit. Als de

host het aanzet, krijgt de schutter bij een uitschakelend schot de resterende AP van het doelwit (ná het uitgeven van 1 AP voor het schot). Overgave en krimp/verpletteren geven geen AP. Het geplunderde aantal staat op het schot-event (loot) en is zichtbaar volgens de AP-zichtbaarheidsregel (de schutter ziet het altijd).

  • Er zijn geen harten op het bord en je kunt geen levens kopen.

Die regels bestaan niet als optie.

Tijdlijnbediening

Op de tijdlijnbalk: stap terug, afspelen/pauzeren, stap vooruit, en “Live” (naar het heden). Toetsen (alleen in een lopend spel, niet in een invoerveld): ← stap terug, → stap vooruit, spatiebalk afspelen of pauzeren, End springt naar het heden. Klikken/tikken ergens op de balk springt naar het dichtstbijzijnde event; slepen scrubt.

Zichtbaarheid (lobby-opties)

Standaard staat elke optie op de meest open waarde, Openbaar. De host kiest dit in de lobby; na de start liggen de regels vast. De server filtert iedere API-response (volle staat, sync, tijdlijn, replay) per kijker. Eigen gegevens (levens, actiepunten, bereik) zijn altijd zichtbaar voor jezelf. Verplaatsingen zijn altijd openbaar. Levend/dood en overgave zijn altijd openbaar (nodig voor de jury en de winstvoorwaarde); verborgen is alleen het resterende aantal levens.

  • Schoten: Openbaar — iedereen ziet elk schot (schutter, doelwit,

schade). Alleen uitschakelende schoten zijn openbaar — een schot dat niet elimineert is alleen zichtbaar voor schutter en doelwit; een uitschakelend schot is voor iedereen zichtbaar (inclusief wie schoot). Alleen bekend bij het doelwit — alleen schutter en doelwit zien het schot, ook als het elimineert; anderen zien wel de dood, maar zonder schutter (by wordt weggelaten). Alleen een uitschakelend schot is bekend bij het doelwit — een niet-uitschakelend schot is alleen voor de schutter zichtbaar (het doelwit ziet het eigen levensverlies, niet van wie); een uitschakelend schot is bekend bij schutter en doelwit; anderen zien de dood zonder schutter.

  • Giften: Openbaar — iedereen ziet gever, ontvanger en aantal.

Alleen bekend bij de ontvanger — gever en ontvanger zien de gift volledig; anderen zien niets. Anoniem — de ontvanger ziet dat hij punten krijgt en hoeveel, maar niet van wie (player wordt weggelaten, anonymous: true). Anderen zien de gift niet. De gever ziet de eigen gift altijd.

  • Actiepuntentotalen: Openbaar of Verborgen. Bij verborgen is

alleen je eigen totaal in de staat aanwezig; in het dagelijkse event staat alleen je eigen toekenning. Jury-winnaars blijven openbaar (de bekendmaking); stemtellingen worden niet meegestuurd.

  • Bereik: Openbaar, Bekend bij spelers binnen bereik, of

Verborgen. “Binnen bereik” betekent: Chebyshev-afstand tot die speler ≤ diens huidige bereik (je staat in hun schootsveld). Upgrade-events volgen dezelfde regel, op basis van de huidige posities (niet de historische).

  • Levens: Openbaar of Verborgen. Bij een zichtbaar schot gaat

lives_left alleen mee als levens openbaar zijn of jij het doelwit bent. De schade van het schot (damage, nu altijd 1) is wel zichtbaar als je het schot mag zien — dat lekt het resterende aantal levens niet.

  • Verborgen events worden volledig weggelaten (geen generiek streepje

op de tijdlijn): een streepje zou lekken dat er iets gebeurde. Ticks en replay tonen alleen events die deze kijker mag zien.

  • De opgeslagen wedstrijd blijft ongefilterd; present() stuurt een

kopie. Combinaties van opties kunnen aftellen mogelijk maken (bijv. openbare AP-totalen plus anonieme giften); dat is een keuze van de host. Bij openbare levens en verborgen niet-uitschakelende schoten kan een levensverandering in de staat zichtbaar zijn zonder bijbehorend schot-event; de replay verzint geen events.

Weergave van events (geen tekstlog)

Er is geen tekstlog van zetten. Events zijn alleen te zien in de video-weergave van de tijdlijn (afspelen 1 actie per 0,5 s, of scrubben):

  • Een gift: groene pijl van gever naar ontvanger, met het aantal AP.

Bij een anonieme gift (voor de ontvanger) verschijnt alleen “+N” op de ontvanger, zonder bronpijl — een pijl “van nergens” zou nog een richting kunnen suggereren en zo de gever verraden.

  • Een schot: rode pijl van schutter naar doelwit, met de schade (levens

die dit schot kost). Alleen als dit event voor de kijker zichtbaar is.

  • Een zet: de pion schuift van het oude naar het nieuwe vak.
  • Een bereik-upgrade: een korte gouden pulsering om de pion.
  • Levens, AP en bereik staan in het Info-venster van een speler, en

alleen als ze voor de kijker zichtbaar zijn (anders “Verborgen”). Er staan geen permanente getallen op het bord voor verborgen stats.

Klikken of tikken ergens op de tijdlijnbalk springt naar het dichtstbijzijnde event. Slepen scrubt door de events. Dit werkt met muis en touch (pointer + touch, touch-action: none).

De uitnodigingslink (?join=CODE) herstelt na een verversing de lobby of, als het spel al loopt en je lid bent, het lopende spel.

Techniek

  • Geen WebGL/frameworkv3: het bord, de avatars, de modals en de tijdlijn

zijn DOM+CSS, beter voor touch, tekst en toegankelijkheid. De rest van de stapel (PHP-API, SQLite, CI, OAuth, i18n) volgt Meteors.

  • Elke mutatie loopt in BEGIN IMMEDIATE. Een geweigerde zet rolt terug.
  • De client polt elke 3 seconden een licht sync-eindpunt (versie,

servertijd, countdowns). Alleen bij een gewijzigde versie komt de volle staat, inclusief chat. Bij een verborgen tabblad stopt het pollen; bij terugkeer volgt een volle verversing.

  • Lokale testers: auth.php?test=1 t/m ?test=8, alleen op localhost.

Op de live site staat dat uit.

  • Het OAuth-callbackpad is https://projects.timfalken.com/allianties/callback.php.

Dat moet op auth.timfalken.com bij de bestaande client projects.timfalken.com worden toegevoegd. Het clientgeheim wordt níet opnieuw gegenereerd (dat zou de andere sites breken) en komt als projectgeheim auth_client_secret in de CI.

Source
1# Aannames — Allianties
2
3Waar de specificatie ruimte liet, gelden deze keuzes. Ze zijn ook in de
4regelmotor (`server/lib/Engine.php`) en de tests vastgelegd.
5
6## Bord en plaatsing
7
8- Het bord is vierkant. Grootte: `max(6, ceil(sqrt(n × 6)))`. Twee tot
9 zes spelers: 6×6; acht spelers: 7×7; twaalf: 9×9.
10- Startposities liggen op een ring rond het midden, beginnend bovenaan en
11 dan met de klok mee. Bij een botsing schuift de speler naar het dichtstbij
12 zijnde vrije vakje. Dode spelers blokkeren geen vakjes meer, maar blijven
13 visueel op hun laatste plek (uitgegrijsd).
14- Maximaal 16 spelers per spel, minimaal 2 om te starten. Er is geen
15 aparte “klaar”-stap: de host start wanneer er minstens twee spelers zijn.
16- Kleuren van de omlijning worden in volgorde van aansluiting uit een vaste
17 palet van 16 contrasterende kleuren gekozen.
18
19## Actiepunten en tijd
20
21- Iedereen begint bij de start met 1 actiepunt, zodat je meteen kunt
22 handelen.
23- Daarna krijgt elke levende speler 1 punt bij elke dagelijkse uitdeling
24 (Europe/Amsterdam). Het tijdstip is per lobby instelbaar, standaard
25 **00:00**, en volgt de wissel naar en van zomertijd. Als de server een
26 paar dagen offline was, worden gemiste uitdelingen bij de volgende
27 request ingehaald.
28- De countdown bovenaan is `HH:MM:SS` tot de volgende uitdeling, op basis
29 van de servertijd (met correctie voor klokverschil in de browser) en tikt
30 live zolang het tabblad open is.
31- Bereik heeft een plafond gelijk aan de maximale Chebyshev-afstand op het
32 bord (`grootte − 1`), zodat “het hele bord” het maximum is.
33- Meerdere actiepunten in één keer geven telt als één actie (één tik op de
34 tijdlijn).
35
36## Jury (standaard aan, in de lobby uit te zetten)
37
38- Alleen uitgeschakelde deelnemers (inclusief wie zich heeft overgegeven)
39 mogen stemmen, en alleen op een levende speler.
40- Stemmen zijn geheim: anderen zien jouw stem niet. Je kunt hem wijzigen
41 tot de uitdeling. Daarna worden de stemmen gewist voor de nieuwe dag.
42- Bij een unieke winnaar krijgt die +1 AP bovenop het dagelijkse punt.
43 **Bij een gelijke stand krijgt iedere gelijkstaande levende speler de
44 bonus.** Als niemand heeft gestemd, is er geen bonus.
45- De bonus wordt ná een eventuele krimp uitgedeeld, zodat wie die dag
46 door de krimp sterft geen punten meer krijgt.
47
48## Krimpend speelveld (standaard uit)
49
50- De host zet het interval (1–30 dagen, standaard 7). De eerste krimp is
51 op uitdeling nummer *N* na de start (dag *N*), daarna elke *N* dagen, op het AP-tijdstip van de lobby.
52- Elke krimp maakt de buitenste begaanbare ring onbegaanbaar
53 (`arena_inset` + 1). Minimum speelbaar veld is 3×3, dus op een 6×6-bord
54 stopt de krimp bij 4×4 (`max_inset = floor((grootte − 3) / 2)`).
55- Spelers op de nieuwe ring verliezen 1 leven. Overleven ze, dan gaan ze
56 naar het dichtstbijzijnde vrije begaanbare vakje (eerst Chebyshev, dan
57 Euclidean naar het midden, dan een vaste (y, x)-volgorde). Spelers worden
58 in volgorde van hun id verplaatst, zodat het deterministisch is.
59- Is er géén vrij begaanbaar vakje meer, dan is de speler
60 **vermorzeld**: 0 levens, uitgeschakeld.
61- Sterven de laatste twee (of meer) in dezelfde krimp, dan is het
62 **gelijkspel**.
63- De UI toont wanneer de volgende krimp is en markeert de ring die dan
64 verdwijnt.
65
66## Gedwongen staakt-het-vuren (standaard uit)
67
68- De host tekent één of meer periodes op een 24-uursklok (0 bovenaan, met
69 de klok mee), of vult exacte tijden in. Periodes mogen over middernacht
70 lopen. Een periode met gelijke begin- en eindtijd wordt genegeerd.
71 Overlappende periodes worden voor de countdown samengevoegd.
72- Tijden zijn wandkloktijden in **Europe/Amsterdam**. Bij de overgang naar
73 zomertijd is een periode korter in echte seconden (het overgeslagen uur
74 telt niet); bij de terugzetting is hij langer (het herhaalde uur telt
75 twee keer). Het einde van een periode is exclusief (06:00 precies is
76 niet meer staakt-het-vuren als de periode tot 06:00 loopt).
77- Tijdens het staakt-het-vuren is schieten server-side geweigerd
78 (`ceasefire`). Bewegen, punten geven, bereik vergroten, overgeven,
79 stemmen, notities en chat blijven mogelijk. De knop Aanvallen is
80 uitgeschakeld met een toelichting.
81- Onder de AP-timer staat “Tijd over in het staakt-het-vuren: HH:MM:SS”
82 of “Tijd tot het staakt-het-vuren: HH:MM:SS”.
83- Staat de regel aan zonder periodes, dan is er feitelijk geen
84 staakt-het-vuren.
85
86## Lobby, sessie, verwante zaken
87
88- Uitnodigen gaat via een 6-teken-code (zonder 0/O/I/1/L) en een deelbare
89 link `?join=CODE`. Na inloggen kom je terug bij die link.
90- Verlaat de host de lobby vóór de start, dan wordt de vroegst
91 aangesloten overgebleven speler de nieuwe host. Is de lobby leeg, dan
92 verdwijnt hij.
93- Tijdens een lopend spel kun je niet meer instappen. Eén speler mag in
94 meerdere spellen tegelijk zitten.
95- Overgeven maakt je dood (0 levens, vlag `surrendered`); je mag daarna
96 nog wel als jury stemmen en berichten sturen, als de jury aan staat.
97- Privénotities staan server-side, per kijker, over een andere (of jezelf)
98 speler. Chat is 1:1, alleen zichtbaar voor de twee betrokkenen. Dode
99 spelers mogen nog chatten.
100- Sessie duurt 30 dagen en wordt bij activiteit verlengd. Avatar komt uit
101 het profiel van auth.timfalken.com (`avatar_url` / `avatar` / `picture`)
102 of, als fallback, `https://auth.timfalken.com/avatar/{id}`. Bij een
103 ontbrekende afbeelding toont de client initialen.
104- Taalcodes volgen Meteors: intern `zh` (HTML `zh-Hans`), vlaggen `gb`,
105 `jp`, `cn`, `kr`. De keuze staat in `localStorage` (`allianties-locale`)
106 en in het profiel.
107- Extra regels (harten op het bord, levens kopen, AP plunderen bij een
108 kill, …) zijn nog niet gebouwd; de motor is modulair zodat ze later als
109 schakelaar kunnen.
110
111
112
113## Actiepunten-tijdstip en plunderen
114
115- Elke lobby heeft een **dagelijks AP-tijdstip** (Europe/Amsterdam),
116 standaard 00:00. De host stelt het in met een tijdkiezer. Op dat
117 moment gebeuren de AP-uitdeling, de jurybonus en (indien aan) het
118 krimpen van het veld. Een “dag” in het spel is één zo’n uitdeling.
119 Bij een DST-lentesprong bestaat een gekozen tijd in de overgeslagen
120 periode (bijv. 02:30) niet; PHP landt op het eerste geldige moment
121 daarna (typisch 03:30 CEST). Bij de herfst blijft 02:30 geldig
122 (PHP gebruikt de eerste voorkomst).
123- **Actiepunten plunderen bij een kill** staat standaard uit. Als de
124 host het aanzet, krijgt de schutter bij een *uitschakelend* schot de
125 resterende AP van het doelwit (ná het uitgeven van 1 AP voor het
126 schot). Overgave en krimp/verpletteren geven geen AP. Het geplunderde
127 aantal staat op het schot-event (`loot`) en is zichtbaar volgens de
128 AP-zichtbaarheidsregel (de schutter ziet het altijd).
129- Er zijn **geen harten** op het bord en je kunt **geen levens kopen**.
130 Die regels bestaan niet als optie.
131
132## Tijdlijnbediening
133
134Op de tijdlijnbalk: stap terug, afspelen/pauzeren, stap vooruit, en
135“Live” (naar het heden). Toetsen (alleen in een lopend spel, niet in
136een invoerveld): ← stap terug, → stap vooruit, spatiebalk afspelen of
137pauzeren, End springt naar het heden. Klikken/tikken ergens op de balk
138springt naar het dichtstbijzijnde event; slepen scrubt.
139
140## Zichtbaarheid (lobby-opties)
141
142Standaard staat elke optie op de meest open waarde, **Openbaar**. De host
143kiest dit in de lobby; na de start liggen de regels vast. De server filtert
144iedere API-response (volle staat, sync, tijdlijn, replay) per kijker. Eigen
145gegevens (levens, actiepunten, bereik) zijn altijd zichtbaar voor jezelf.
146Verplaatsingen zijn altijd openbaar. Levend/dood en overgave zijn altijd
147openbaar (nodig voor de jury en de winstvoorwaarde); verborgen is alleen
148het resterende *aantal* levens.
149
150- **Schoten:** *Openbaar* — iedereen ziet elk schot (schutter, doelwit,
151 schade). *Alleen uitschakelende schoten zijn openbaar* — een schot dat
152 niet elimineert is alleen zichtbaar voor schutter en doelwit; een
153 uitschakelend schot is voor iedereen zichtbaar (inclusief wie schoot).
154 *Alleen bekend bij het doelwit* — alleen schutter en doelwit zien het
155 schot, ook als het elimineert; anderen zien wel de dood, maar zonder
156 schutter (`by` wordt weggelaten). *Alleen een uitschakelend schot is
157 bekend bij het doelwit* — een niet-uitschakelend schot is alleen voor
158 de schutter zichtbaar (het doelwit ziet het eigen levensverlies, niet
159 van wie); een uitschakelend schot is bekend bij schutter en doelwit;
160 anderen zien de dood zonder schutter.
161- **Giften:** *Openbaar* — iedereen ziet gever, ontvanger en aantal.
162 *Alleen bekend bij de ontvanger* — gever en ontvanger zien de gift
163 volledig; anderen zien niets. *Anoniem* — de ontvanger ziet dat hij
164 punten krijgt en hoeveel, maar niet van wie (`player` wordt weggelaten,
165 `anonymous: true`). Anderen zien de gift niet. De gever ziet de eigen
166 gift altijd.
167- **Actiepuntentotalen:** *Openbaar* of *Verborgen*. Bij verborgen is
168 alleen je eigen totaal in de staat aanwezig; in het dagelijkse event
169 staat alleen je eigen toekenning. Jury-winnaars blijven openbaar
170 (de bekendmaking); stemtellingen worden niet meegestuurd.
171- **Bereik:** *Openbaar*, *Bekend bij spelers binnen bereik*, of
172 *Verborgen*. “Binnen bereik” betekent: Chebyshev-afstand tot die
173 speler ≤ **diens** huidige bereik (je staat in hun schootsveld).
174 Upgrade-events volgen dezelfde regel, op basis van de *huidige*
175 posities (niet de historische).
176- **Levens:** *Openbaar* of *Verborgen*. Bij een zichtbaar schot gaat
177 `lives_left` alleen mee als levens openbaar zijn of jij het doelwit
178 bent. De schade van het schot (`damage`, nu altijd 1) is wel zichtbaar
179 als je het schot mag zien — dat lekt het resterende aantal levens niet.
180- Verborgen events worden **volledig weggelaten** (geen generiek streepje
181 op de tijdlijn): een streepje zou lekken *dat* er iets gebeurde.
182 Ticks en replay tonen alleen events die deze kijker mag zien.
183- De opgeslagen wedstrijd blijft ongefilterd; `present()` stuurt een
184 kopie. Combinaties van opties kunnen aftellen mogelijk maken (bijv.
185 openbare AP-totalen plus anonieme giften); dat is een keuze van de
186 host. Bij openbare levens en verborgen niet-uitschakelende schoten
187 kan een levensverandering in de staat zichtbaar zijn zonder bijbehorend
188 schot-event; de replay verzint geen events.
189
190## Weergave van events (geen tekstlog)
191
192Er is geen tekstlog van zetten. Events zijn alleen te zien in de
193**video-weergave** van de tijdlijn (afspelen 1 actie per 0,5 s, of
194scrubben):
195
196- Een gift: groene pijl van gever naar ontvanger, met het aantal AP.
197 Bij een anonieme gift (voor de ontvanger) verschijnt alleen “+N” op de
198 ontvanger, **zonder** bronpijl — een pijl “van nergens” zou nog een
199 richting kunnen suggereren en zo de gever verraden.
200- Een schot: rode pijl van schutter naar doelwit, met de schade (levens
201 die dit schot kost). Alleen als dit event voor de kijker zichtbaar is.
202- Een zet: de pion schuift van het oude naar het nieuwe vak.
203- Een bereik-upgrade: een korte gouden pulsering om de pion.
204- Levens, AP en bereik staan in het Info-venster van een speler, en
205 alleen als ze voor de kijker zichtbaar zijn (anders “Verborgen”).
206 Er staan geen permanente getallen op het bord voor verborgen stats.
207
208Klikken of tikken **ergens op de tijdlijnbalk** springt naar het
209dichtstbijzijnde event. Slepen scrubt door de events. Dit werkt met
210muis en touch (`pointer` + `touch`, `touch-action: none`).
211
212De uitnodigingslink (`?join=CODE`) herstelt na een verversing de lobby
213of, als het spel al loopt en je lid bent, het lopende spel.
214
215## Techniek
216
217- Geen WebGL/frameworkv3: het bord, de avatars, de modals en de tijdlijn
218 zijn DOM+CSS, beter voor touch, tekst en toegankelijkheid. De rest van
219 de stapel (PHP-API, SQLite, CI, OAuth, i18n) volgt Meteors.
220- Elke mutatie loopt in `BEGIN IMMEDIATE`. Een geweigerde zet rolt terug.
221- De client polt elke 3 seconden een licht `sync`-eindpunt (versie,
222 servertijd, countdowns). Alleen bij een gewijzigde versie komt de volle
223 staat, inclusief chat. Bij een verborgen tabblad stopt het pollen; bij
224 terugkeer volgt een volle verversing.
225- Lokale testers: `auth.php?test=1` t/m `?test=8`, alleen op localhost.
226 Op de live site staat dat uit.
227- Het OAuth-callbackpad is `https://projects.timfalken.com/allianties/callback.php`.
228 Dat moet op auth.timfalken.com bij de bestaande client
229 `projects.timfalken.com` worden toegevoegd. Het clientgeheim wordt níet
230 opnieuw gegenereerd (dat zou de andere sites breken) en komt als
231 projectgeheim `auth_client_secret` in de CI.