Aannames — Meteors
Waar de specificatie ruimte liet, staat hier hoe we het hebben ingevuld. Als iets onduidelijk was, volgden we de geest van Meteos en (voor de selectie-tween) Tim's bestaande KWin-effecten.
Fase 1 — physics-fixes (t1098u, t1100u, t1101u)
1. Vallende blokken landen op vliegende clusters
Een gespawnd (vallend) blok ging soms door een vliegende cluster heen, omdat de val alleen keek naar stilliggende/settling/locked blokken.
Aanname: het vallende blok botst alleen in dezelfde kolom. Het landt op het hoogste vliegende clustermlid onder hem, wordt vracht van die cluster (state = flying, zelfde clusterId en vy, geen vlam) en vliegt mee, inclusief omhoog als de cluster nog stijgt. Nieuwe vracht zit precies 1 tegel boven het hoogste clustermlid in die kolom.
Omgekeerd, als een stijgende cluster een vallend blok inrijdt, geldt hetzelfde. Een cluster die al geland is (rigid settling) telt als vaste ondergrond: daar landt een vallend blok gewoon op, het wordt geen vracht.
2. Grijze clusters landen als starre groep
Voorheen werd elke kolom bij landing platgedrukt op de stapel, waardoor gaten verdwenen.
Aanname: zodra één lid de vloer of een stil blok raakt, stopt de hele cluster als star lichaam. De relatieve posities blijven; een deel kan dus boven een gat blijven hangen. Gekleurde vracht (meegedragen blokken) blijft tot het einde van de settle-tijd van 3 s bij de groep — ze verkleuren niet opnieuw, maar vallen ook niet eerder. Na de conversie van de grijze blokken naar willekeurige kleuren laat de hele groep los. Blokken mét steun blijven liggen; blokken zónder steun vallen afzonderlijk, vanuit rust, met dezelfde zwaartekracht als een gewone val (eerst versnellen tot fallSpeed, zie punt 3). Gestapelde hangende blokken vallen als stapel (ze blijven op elkaar rusten, zonder te overlappen).
3. Vloeiende snelheidsovergang op de apex
Voorheen sprong vy op de apex in één frame naar -fallSpeed.
Aanname: vanaf de apex (vy = 0) versnelt de cluster (en een handmatige sprong) met constante fallAccel totdat fallSpeed is bereikt; daarna constante daalsnelheid. apexEaseTime = 0.15 * fallTime en fallAccel = fallSpeed / apexEaseTime. Lage luchtweerstand (kleine fallTime) geeft dus een kortere, snellere overgang. Voor Terra (fallTime = 3) is dat 0,45 s. Hetzelfde geldt voor hangende blokken die na conversie uit rust gaan vallen. Blokken die van boven het veld binnenkomen (spawn) starten al op fallSpeed — die vallen al een tijdje.
4. Bounce bij landing (planeetparameter)
Aanname: de bounce is visueel (squash van de sprite, plus een heel klein optisch terugveren in Y) en verandert de simulatiefysica niet. Elk blok dat op de vloer of op een ander blok landt, krijgt een bounce; hangende leden van een starre groep die niets raken, niet.
Snelheid hangt af van de luchtweerstand van het veld, via fallTime (1 = weinig lucht, 5 = veel lucht):
bounceDuration = 0.12 * fallTime(Terra: 0,36 s; bijfallTime = 1
twee keer zo snel als bij fallTime = 2, enz.)
bounceSquash = 0.16(subtiele verticale squash naar 84%, met lichte
horizontale compensatie)
Beide zijn planeetparameters, klaar voor fase 3.
5. Handmatige sprong van het bovenste blok (t1100u)
Het naar boven slepen van een blok dat al het bovenste van zijn kolom is, moest een handmatige sprong starten (tot net onder de bovenrand). De core vroeg eerder dat de aanwijzer in de lege ruimte boven de stapel kwam (y > top + 1 + 0,25). Wie het bovenste blok vasthad en het voorbij zijn eigen positie trok, maar niet een hele tegel het gat in, kreeg geen sprong. Op touch kon lostpointercapture de sleep ook te vroeg beëindigen.
Aanname:
- Begon de sleep al op het bovenste blok, dan is een trek van
LAUNCH_PULL = 0,35 tegel omhoog vanaf het drukpunt genoeg (“voorbij zijn eigen positie”), voor muis én touch (zelfde Pointer-Events-pad).
- Begon de sleep lager in de stapel, dan blijft de oude drempel gelden:
eerst wisselen, en pas lanceren als de aanwijzer in de lege ruimte boven de (nieuwe) top zit. Zo lanceer je niet per ongeluk een blok dat je alleen naar de bovenste plek wilt schuiven.
- De view luistert na
pointerdownopwindowvoorpointermove/
pointerup / pointercancel, zodat een sleep boven het canvas (nodig bij een volle kolom) niet verloren gaat. lostpointercapture beëindigt de sleep niet meer.
6. Selectie-tween (t1101u)
Een vastgehouden (geselecteerd) blok krijgt dezelfde schaal-animatie als de DEFAULT-instellingen van Tim's KWin Click Tween-effect.
Bron (op deze box): /workspace/click-tween/, specifiek:
settings.h:clickTime = 150ms,releaseTime = 720ms,
clickEasing = easeOutBack, releaseEasing = easeOutElastic
clicktween.cpp: pers-doel0.8, loslaat-doel1.0; een onderbroken
animatie start vanaf de huidige schaal (QVariantAnimation)
README.md: “krimpt naar 80% in 150 ms”, “groeit in 720 ms terug”,
“curveparameters zijn Qt-standaardwaarden”
Qt QEasingCurve-standaardwaarden, ook in de README genoemd:
- Back-overshoot:
1.70158 - Elastic: amplitude
1.0, periode0.3
Het blok blijft op 80% zolang het geselecteerd is, en veert bij loslaten terug (ook als het ondertussen gelanceerd wordt). Muis en touch gebruiken dezelfde tween.
Fase 2 — multiplayer (samenvatting)
De miss-kans van 30% was de stage-2-parameter; stage 3 vervangt die door parameter (missChance, standaard 0,30); de planeetformule Planet.missChance (60%–5% via Power) is voor fase 3.
Deploy: vreemde bestanden en favicon.ico
De FTP-guard blokkeert alleen een duidelijk verkeerd doel (FTP-root, pad zonder meteors als laatste segment, map buiten $timftproot). Extra bestanden die al in de remote map staan, worden alleen gelogd: we gebruiken nooit --delete, dus ze blijven staan en zijn onschadelijk.
favicon.ico op de server wordt niet overschreven en niet verwijderd (mogelijk van Tim of de host). De deploy sluit dat bestand uit van de upload, ook als er lokaal een build/favicon.ico staat voor eigen gebruik.
7. Recolor stuurt blokken niet extra hard naar boven (t1102)
Na het herkleuren van een gelande grijze groep schoten blokken erboven soms heel hard van de bovenkant af. Oorzaak: een restant van de lanceringssnelheid (vy omhoog) of van een handmatige sprong, dat na de release in integrateFalling alsnog werd gebruikt. Daarnaast telde releaseUnsupported in dezelfde tick nog de hangende leden als steun, zodat blokken die erop stonden still bleven en in resolveMatches een match in de lucht konden vormen.
Aanname / aanpak:
- Bij elke overgang naar
stilloffallingna release (en bij het
loslaten van ongesteunde still-blokken) wordt clearFlightState aangeroepen: vy = 0, geen vlam, geen restant van een handmatige sprong.
releaseUnsupporteddraait opnieuw náadvanceSettle, zodat
blokken op zojuist losgelaten hangende leden vanaf rust vallen voordat er gematcht wordt.
- Een échte nieuwe match na herkleuren is toegestaan en gebruikt de
normale sprong: launchVelocity(planet, jumpHeight) en de bijbehorende deceleratie, niet een opgetelde of achtergebleven vy. Dat zit in een regressietest (inclusief een kunstmatig achtergebleven vy = 40).
8. Botsende vliegende clusters smelten samen (t1102)
Twee (of meer) vliegende clusters die in dezelfde kolom in Y overlappen, worden één cluster.
Aanname: de nieuwe snelheid is het massagewogen gemiddelde op blok-aantal (niet het eenvoudige gemiddelde van de twee clustersnelheden):
vy = (n1·vy1 + n2·vy2) / (n1 + n2)
Hetzelfde gewogen gemiddelde geldt voor decel en jumpHeight. De fase is up als de samengevoegde vy > 0, anders down. Overlappende leden in één kolom worden van onder naar boven aangepakt, zodat de hogere strak op de lagere rust (geen twee blokken in dezelfde cel). Keuze vastgelegd: gewogen op blok-aantal.
9. Direct vastpakken, geen long-press (t1102 / t1103)
Er is geen long-press en geen wachttijd. Een blok wordt op pointerdown (tap of klik) meteen vastgepakt en blijft in de sleep zolang de vinger of muisknop omlaag is; loslaten beëindigt de sleep. De click-tween start in hetzelfde moment als pointerdown.
Aanname:
- Verticaal: snap naar het dichtstbijzijnde still-blok in de kolom,
tot SNAP_Y = 0,65 tegel (een iets misplaatste druk pakt nog).
- Horizontaal: op de druk, als de aanwijzer binnen
HORIZONTAL_SLOP = 0,35 tegel van de kolomrand zit, mag het buurblok gepakt worden. Tijdens de sleep blijft de startkolom vast, ook bij een iets diagonale beweging.
- Wisselen: alleen een minimale opgetelde verticale afstand
SWAP_DISTANCE = 0,25 tegel per stap, zonder vertraging vóór de sleep. Een enkele grote pointermove (snelle swipe) loopt alle tegels langs (één wissel per tegel, geen overslaan). Er is geen extra drempel of hold voordat de sleep begint.
touch-action: noneop canvas en pagina,preventDefaultop
pointer-events met { passive: false }, setPointerCapture, en window-listeners voor move/up (zoals al bij t1100).
Fase 2 — multiplayer
Polling en autorisatie
- De client pollt elke 0,75 s (
Online.POLL_MS). Dat valt in de gevraagde
0,5–1 s. Er is geen websocket.
- Login via auth.timfalken.com (
/oauth/authorize,/oauth/token,/api/me),
client_id projects.timfalken.com. Callback https://projects.timfalken.com/meteors/callback.php. Het geheim zet Tim als protected projectgeheim auth_client_secret (niet opnieuw genereren); de deploy schrijft dan data/config.php. Zonder geheim blijft solo werken, met een duidelijke online-melding.
- Testers
auth.php?test=1/?test=2alleen alslocalDev()waar is:
loopback-host én loopback-remote-adres (zelfde regel als verhalenboek).
- Sessies staan in
data/sessions, cookie-pad is de map van het script
(/meteors/ live). CSRF-token op elke POST (X-CSRF-Token).
Lobby en wedstrijd
- Onbeperkt in de zin van de regel; praktisch maximum 32 (
METEORS_MAX_PLAYERS). - De host start alleen als iedereen gereed is en er minstens twee spelers zijn.
- Eigen veld is het hoofdspel; miniaturen van anderen staan in een strook
boven het veld (onder de HUD).
- Afgeschoten blokjes gaan als
outgoingShotsmee in de volgende poll. De
server kiest het doel en gooit de miss-kans (niet de client, zodat die niet kan valsspelen). Doel is een willekeurige andere speler die nog niet is uitgeschakeld.
missChanceis een parameter, standaard 0,30, op de lobby én op
GameCore. Planet.missChance (Power, 60 %–5 %) blijft voor stage 3 en wordt hier niet gebruikt.
- Een raak schot komt na
flight_duration = 1,2 sbij de ontvanger aan als
vallend donkergrijs vuil (ingestGarbage), dat na de gewone 3 s settle een willekeurige kleur krijgt.
- De vlucht-tween is een kwadratische Bézier, met semi-willekeurige rotatie
(tot ±720°) en krimpen (“de verte in”). Een miss vliegt het scherm af en vervaagt; een raak schot landt in de miniatuur van het doel.
- Uitgeschakelde spelers zijn toeschouwer (geen doelwit, geen shots). De
laatste die overblijft is 1e; de eerder uitgeschakelden 2e, 3e, … Het podium blijft 5 seconden (METEORS_PODIUM_SECONDS) en daarna gaat de lobby terug naar waiting (ready-vlaggen gereset).
data/(sqlite, sessies) wordt nooit gespiegeld of gewist. Alleen
data/.htaccess (Require all denied) wordt na de mirror gezet. Als het projectgeheim auth_client_secret niet leeg is, schrijft de deploy data/config.php vanuit dat geheim (waarde nooit in de logs). Is het leeg of afwezig, dan blijft een bestaand bestand staan. De groep projects-timfalken-com en verhalenboek hebben dit geheim niet (alleen FTP); Tim zet het op het meteors-project. Optioneel: auth_client_id (standaard projects.timfalken.com). favicon.ico blijft ongemoeid. router.php is alleen voor lokale php -S en gaat niet mee naar live.
Fase 3 — planeten (velden)
- Een veld is een planeet, met een naam voor de planeet en voor het volk.
De catalogus staat in server/lib/planets.json (bron voor JS én PHP) en telt 12 werelden, van makkelijk (Aurel: gameplay-Power 0, 60 % miss, getoonde Power 0 %) tot moeilijk (Cinder: gameplay-Power 1, 5 % miss, getoonde Power 92 %). Terra (44 % getoonde Power) blijft de standaard.
- Zwaartekracht (
jumpsToClear1–4): één sprong haalt
1,5 / jumpsToClear van de veldhoogte (t1119, +50 %). Luchtweerstand (fallTime 1–5 s tot de bodem voor losse blokjes; een vliegende cluster zweeft na de apex in 2× fallTime naar beneden, t1122/t1124). Massa (riseTime 0,5–3 s tot de apex). Lage massa en lage luchtweerstand en hoge zwaartekracht zijn moeilijker. Bounce-duur en apex-ease schalen al met fallTime (gebouwd in stage 1).
- De interne (gameplay-)Power is het gemiddelde van die drie assen,
genormaliseerd 0–1. Miss-kans = 0,60 − 0,55 × Power (60 % bij 0, 5 % bij 1). Dat formule blijft de gameplay: schoten en de server gebruiken hem onveranderd. De getoonde Power in kiezer, HUD en lobby is 1 − miss / 0,60 als percentage (0 % miss → 100 % Power, 60 % miss → 0 % Power). Dat is alleen weergave (t1105). In multiplayer gebruikt de server de gameplay-Power van jouw planeet voor de blokjes die jij afschiet (niet de lobby-waarde, niet de planeet van het doel). De client kan dat niet vervalsen.
- De vier getallen op de kiezers en in de HUD:
gals
zwaartekrachtsconstante (m/s²), d als luchtdichtheid, F in newton, getoonde Power als percentage. Alleen de getallen, zonder uitleg. Verticale match van 3 = 120 % sprong, +5 % per extra blokje (al gebouwd, nergens uitgelegd).
- Elk veld heeft een eigen set van 5 kleuren, elk met een uniek vormpje
en een uniek placeholder-PNG (build/images/block-{planeet}-{kleur}.png). Tim kan die bestanden zelf vervangen; de namen blijven gelijk. Te (her)genereren met python3 scripts/gen_planet_blocks.py.
- Planeetkeuze komt vóór solo-spel (
Spelenopent de kiezer) en in de
lobby (iedereen kiest zelf; zichtbaar voor de anderen). De keuze wordt onthouden in localStorage (meteors-planet). Na de start van een wedstrijd kun je niet meer wisselen.
t1104 — 1:1-slepen en spontane raketten
- Oorzaak van de sleepbug:
moveDragwerkte met een opgetelde
pointer-delta en een drempel van SWAP_DISTANCE (0,25 tegel). Een klein stukje sleep deed daardoor al een hele tegel, en één grote pointermove (typisch op touch) kon de rest van de kolom aflopen — precies “meestal gelijk helemaal omlaag of omhoog”. De doelrij was niet de rij onder de vinger, dus als de vinger stopte kon het blokje al aan de top of de bodem zitten. Daarnaast liep de pointer-mapping via canvas.width / app.tile, wat deltas zou vermenigvuldigen met de devicePixelRatio als de backing-store en de CSS-maat ooit uit elkaar lopen.
- Nu: de doelrij is
floor(pointerY), geklemd op de still-stapel van
de kolom. swapToward wisselt stap voor stap met elke buur, en stopt precies daar. Als de pointer stilstaat, beweegt er niets meer. Optrekken-boven-de-top om te lanceren blijft. Coordinaten komen uit getBoundingClientRect en de veldgrootte (10×13), zonder canvas-backing of app.tile.
- Spontane rijen (na vallen, settle/recolor, cargo-attach op een
vliegende cluster, cluster-merge) worden altijd raketten, net als wanneer de speler ze maakt. In een al vliegende cluster geeft dat een extra sprong vanaf de huidige positie (checkChainRelaunch, dezelfde hoogte als bij een player-push). Mid-air hangend cargo na recolor valt nog steeds vanuit stilstand (t1102), geen launch.
t1105 — getoonde Power omgekeerd
- Alleen de weergave. Gameplay
power()enmissChance()zijn
onveranderd (miss = 0,60 − 0,55 × power). Getoonde Power = 1 − missChance / 0,60, afgerond als percentage, in JS (Planet.displayValues / formatStats) en PHP (Planets::displayValues), dus op de planeetkiezer, in de HUD en in de lobby. 0 % miss is 100 % Power; Aurel 0 %, Terra 44 %, Cinder 92 %.
t1106 — touch is leidend bij een echte aanraking
- De Playwright-tests van t1104 waren circulair: ze rekenden
field_to_client
met dezelfde CSS-rectformule als fieldFromEvent, dus ze konden de bug op Tims echte telefoon niet reproduceren. Onderzoek met CDP-touch op emulated Android (DPR 2,625/3), live site, URL-balk-resize, pointercancel en vallende kolommen liet zien dat correcte CSS-coördinaten wél 1:1 blijven. De echte fout zat in de gebeurtenissen zelf.
- Op mobiel kan
PointerEvent.clientX/Ytijdens een touch verkeerd zijn
(onder andere bij een gezoomde visual viewport), terwijl TouchEvent.changedTouches de juiste plek houdt. Een reeks pointermoves die naar een ander veld-Y interpoleren, liep daardoor de hele kolom af — precies “één vakje slepen, blokje helemaal naar boven of beneden”.
- Aanvullend:
preventDefaultop een PointerEvent houdt op veel mobiele
browsers het touch-scrollen niet tegen (daarvoor is een niet-passieve touchmove nodig). setPointerCapture eindigt daar vaak in pointercancel. layout() draaide elke frame en kon het canvas midden in een sleep verplaatsen (URL-balk).
- Oplossing: zolang een echte
touchstartis binnengekomen
(app.activeTouchId), zijn Touch Events leidend. pointermove / pointerup / pointercancel worden dan genegeerd. Als er geen TouchEvent komt (pointer-only touch, zoals sommige Playwright-paden), blijven de pointer-events gewoon werken. Document-listeners voor touch staan tijdens het spel op {capture:true, passive:false} en roepen preventDefault aan. Geen setPointerCapture. pointercancel en touchcancel beëindigen de sleep zonder lancering. layout() bevriest zolang er een sleep loopt en layoutIfNeeded slaat over als de viewport niet veranderde. Canvas heeft touch-action:none en position:fixed; html,body hebben overscroll-behavior: none.
- Debug:
?debug=dragoflocalStorage.meteors-debug-drag=1toont een
overlay (#drag-debug) met fase, event, bron, fieldY, doelrij, blockY, launch-intent, touchId en pointerId.
- Regressietest: vergiftigde
pointermoves naar fieldY 9,5 plus
correcte touchmoves naar 1,5 laten het blokje op y=1 staan, niet op de top. Die test faalde op het oude pointer-only pad.
t1107 — slepen onder een vliegende cluster en door een gelande
isColumnStillblijft streng (false zodra er iets vliegt, valt of
settlet in de kolom). Alleen het sleep-pad gebruikt columnAllowsDrag (!isColumnLocked) en isDraggableBlock.
- Blokjes die stil of settlend op de grond staan, zijn sleepbaar, ook
als er in dezelfde kolom een vliegende cluster boven hangt. De vliegende cluster zelf is niet sleepbaar: in Meteos speel je op de grond, raketten in de lucht herschik je niet.
- Een gelande cluster (fase
landed: grijze raketblokjes en gekoppeld
cargo, state SETTLING) is wél sleepbaar, zolang de kolom een aaneengesloten stapel is (geen gat). swapToward stopt bij een gat. Hangende leden (SETTLING telt als grounded) horen bij de stapel-top.
- Van plaats wisselen binnen dezelfde gelande cluster verandert alleen
de posities. Een blokje uit de cluster wisselen haalt het eruit: een grijs blokje blijft settlen op zijn eigen resterende timer en recolored alleen; gekleurd cargo wordt STILL als het steun heeft, anders FALLING. Een blokje in de cluster wisselen krijgt dat clusterId, wordt SETTLING en flame uit. Een grijs blokje dat instapt met settleTime 0 kan de groeps-release vertragen tot zijn eigen 3 s om is. Lidmaatschap wordt pas ná de join van de ander gewist, zodat leaveCluster een nog niet-lege cluster niet verwijdert.
startManualLaunchroept eerstleaveClusteraan, zodat een gooien
vanuit een gelande groep het blokje losmaakt.
t1108 — een gegooid blokje botst met vallende blokjes
- Een handmatig omhoog gegooid blokje (state MANUAL) botst met vallende
blokjes op dezelfde manier als twee vliegende clusters: ze smelten samen tot één vliegende cluster. Snelheid, vertraging en spronghoogte zijn het massagemiddelde per blokje (zelfde regel als mergeClusterGroup). Een stapel aaneengesloten vallende blokjes gaat in één keer mee.
- Ze kunnen elkaar in één substep niet kruisen: zowel
integrateManual
als integrateFalling kijken naar het hele pad van die stap (swept overlap) en mergen vóór de posities elkaar passeren. packClusterOverlaps legt ze naast elkaar.
- De cluster krijgt
fromManual: true. Vallend cargo dat daarna op
zo'n cluster landt, wordt óók middeled (niet alleen “meegepakt” met de clustersnelheid). Gewone match-raketten houden de oude regel: cargo neemt cluster.vy over, zonder middelen. Dat pad is onveranderd.
- De spronghoogte van de worp wordt bij lancering bewaard als
manualJumpHeight, zodat de merge die kan middelen.
t1109 — pakken per rooster-cel, niet per sprite
- Hit-testing keek naar de afstand tot de simulatie-rechthoek van het
blokje, met een drempel. Visueel staan sprites vaak iets naar binnen (padding, bounce, scale, tween), en de speler moest precies op de getekende sprite drukken.
- Nu: de druk wordt een cel
floor(col),floor(y). Elke druk binnen
die cel — hoeken, kieren tussen sprites, een visueel verschoven sprite — pakt het blokje dat die cel inneemt. Dat gebruikt simulatiecellen, niet de getekende bounds (tweens blijven view-only).
- Staat er geen blokje in die cel (midden in een animatie, y niet
geheel), dan de dichtstbijzijnde sleepbare in dezelfde kolom binnen een halve tegel (SNAP_Y = 0,5). Alleen als de primaire cel leeg is en de druk dicht bij de rand zit, geldt nog een kleine horizontale slop naar de buurkolom. Lanceren-door-optrekken blijft.
t1110 — match na landing van een cluster, en grotere vlammen
- Als een vliegende cluster landt en samen met al liggende blokjes een
geldige rij vormt (3 of meer dezelfde kleur, horizontaal of verticaal), telt dat als een match en worden het raketten.
- Aanname: grijze raketblokjes hebben geen kleur en doen niet mee aan
een match zolang ze grijs zijn. Gekleurd cargo in de gelande cluster (SETTLING) is wél matchbaar, meteen bij de landing, ook in een gemengde rij met al stilliggende blokjes. Zodra de grijze blokjes recoloren en de groep wordt losgelaten, geldt hetzelfde voor die nieuwe kleuren: een gemengde rij met rustende buren lanceert in dezelfde tick.
findMatchLinesneemt daarom STILL én SETTLING mee, zolang
color >= 0. Grijze SETTLING (geen kleur) blijft uitgesloten.
- De vlam onder raketten is 3× zo groot, in lengte én breedte
(0,85 × 3 tegels). De bovenkant van de vlam blijft op dezelfde overlap in het blokje; de extra lengte steekt naar beneden uit.
t1111 / t1112 — schot in een cluster, en physics-audit
- Zie
docs/PHYSICS.mdvoor de volledige lijst van gevonden oorzaken
(video t1111.webm) en de herschreven regels.
- Schot in een vliegende cluster: de geraakte kolom 1 cel omhoog, het
schot sluit onderaan aan, rooster-uitgelijnd, als lid. Elke volgende worp hetzelfde. Vliegende clusters zijn één star lichaam (één y/vy, gehele offsets). Geen twee blokjes delen een cel of overlappen; volgorde in een kolom blijft; verdwijnen/dupliceren/kleur veranderen alleen via de bekende regels (match → grijs, grijs recolor, of scoren over de bovenkant).
?debug(of?debug=physics/?debug=drag) zet de
invariant-checker aan en toont overtredingen in de overlay.
t1119 — Offline Strijd, en +50 % spronghoogte
- Offline Strijd is een knop op het hoofdmenu. Het speelt als
multiplayer (zelfde schoten, miss-kans van jouw planeet, zichtbare tegenstandervelden), maar volledig client-side tegen lokale bots. Geen server, geen login.
- De speler kiest zelf een planeet (dezelfde kiezer als solo). Elke
bot krijgt altijd een willekeurig veld en een willekeurige planeet uit de catalogus.
- Progressie, tot de speler verliest: 1 tegenstander voor 1 ronde;
daarna N tegenstanders voor N−1 rondes (N ≥ 2). Dus: ronde 1 → 1 bot; ronde 2 → 2 bots; ronde 3–4 → 3 bots; ronde 5–7 → 4 bots; enz. Na een gewonnen ronde (alle bots uitgeschakeld, dezelfde winconditie als multiplayer) volgt de volgende ronde met een vers veld. Na verlies een eindscherm met de bereikte ronde (de ronde waarin je verloor) en terug naar het menu.
- Bot-skill start op 5 % in ronde 1 en stijgt 1 % per ronde,
met een plafond van 100 %. De HUD toont ronde, aantal tegenstanders en skill.
- Skill-mechaniek: elke 0,5 s dobbelt elke levende bot. Als
roll < skill mag hij één blokje verticaal in een kolom verplaatsen, zo ver als nodig is om een match te maken, mits zo'n zet bestaat (kortste zet, daarna laagste kolom / fromY / toY). Anders doet hij die tick niets. Bots gehoorzamen verder normale fysica, inclusief landing-chain, schoten en miss-kans van hun planeet.
- Mini's zijn klein (kleiner naarmate er meer bots zijn) en worden
maximaal 10 keer per seconde getekend, zodat veel botvelden op mobiel blijven lopen.
- Minimum spronghoogte +50 % (t1119, alle modes, ook bots):
baseJumpHeight = 1,5 × FIELD_HEIGHT / jumpsToClear. Verticale en extra-blok-bonussen blijven relatief hetzelfde (120 %, +5 %). De omhoog-snelheid volgt daaruit via de bestaande launchVelocity / launchDeceleration (massa / riseTime onveranderd). De PHP-server berekent geen spronghoogte; die fysica leeft in planet.js, gedeeld door solo, online-client en Offline Strijd. De miss-kans-formules (Power) zijn onveranderd.
t1120 — landing-chain sprongbonus
- Als een cluster landt en die landing direct een match maakt
(gekleurd cargo in dezelfde tick, of na recolor van de grijzen in dezelfde landing), is die lancering 25 % sterker.
- Valt het cluster opnieuw en maakt de volgende landing weer een
match, dan komt er weer +25 % bij. De keten is additief: stap 1, 2, 3, … → ×1,25, ×1,50, ×1,75 (1 + 0,25 × chain), niet multiplicatief (niet 1,25³).
- De teller hoort bij het cluster. Hij gaat naar 0 als het cluster
verdwijnt (scoort over de bovenkant, of oplost) of landt zonder match. Mid-lucht-matches (keten-herlancering) gebruiken de bestaande spronghoogte en wijzigen de teller niet. Geldt voor grond- én stapellandingen, en voor bots. Een klein HUD-label toont x2 +50% (keten en totale bonus).
t1121 — visuele wissel-tween
- Als twee blokjes van plaats wisselen (spelersleep én bot-zetten),
animeert het verplaatste blokje naar zijn nieuwe cel in 100 ms met easeOutCubic (in het gevraagde bereik 80–120 ms).
- Puur visueel: de simulatie en het rooster zijn meteen bijgewerkt,
de invariant-checker ziet alleen de logische posities.
- Het vastgehouden (gesleepte) blokje volgt de pointer, zonder tween.
- Bij snelle opeenvolgende wissels start een lopende tween opnieuw
vanaf de huidige visuele y, zodat er niet wordt gesnapt.
t1122 / t1124 — alleen de cluster-zweef naar beneden is gehalveerd
- Tim bedoelde met „daalsnelheid” alleen hoe een cluster na zijn sprong
weer omlaag zweeft (t1124). Nieuwe blokjes die het scherm in vallen waren al goed en gaan weer op de oude snelheid: fallSpeed = FIELD_HEIGHT / fallTime. Hetzelfde geldt voor losgelaten of ongesteunde losse blokjes en gevallen cargo, tenzij ze lid zijn van een dalende cluster (dan zweven ze mee).
- Alleen de post-apex-zweef van een vliegende cluster is gehalveerd
(alle modes, inclusief bots): clusterFallSpeed = 0,5 × FIELD_HEIGHT / fallTime. De relatieve verschillen tussen planeten (omgekeerd evenredig met fallTime) blijven. Een handmatige sprong (omhooggetrokken blokje) daalt op de volle fallSpeed.
- De apex-ease van die clusterzweef duurt nog steeds
0,15 × fallTime; clusterFallAccel schaalt mee met de gehalveerde eindsnelheid. Bounce-duur is onveranderd (0,12 × fallTime). Omhoog-lancering is onveranderd, behalve de aparte +50 % spronghoogte van t1119. fallTime in de catalogus en in de Power-formule blijft hetzelfde getal (1–5).
t1123 — rode puls bij volle kolommen
- Een kolom die minstens 10 van de 13 rijen gevuld heeft (net
boven 70 %) pulst rood, als een vloeiende sinus-alpha (ongeveer 0,55 Hz, alpha 0,16–0,44) achter de blokjes.
- Geteld worden alleen rustende blokjes:
still,settlingen
locked. Vliegende, vallende en handmatig gelanceerde (in de lucht) blokjes tellen niet mee: die zijn tijdelijk en zouden de waarschuwing laten flikkeren.
- Geldt voor het veld van de speler én voor tegenstander-/bot-mini's
(zelfde puls-klok). Rendering is goedkoop: tien quads op het hoofdveld, één fillRect per waarschuwingskolom op de mini-canvas.
t1125 — mini's links/rechts en boogjes tussen velden
- Breed scherm: als er aan weerszijden van het geschaalde veld
genoeg marge is voor minstens één mini (eventueel een kleinere) én de tegels minstens 18 px blijven, staan de tegenstanders naast het veld. Alleen écht smalle of staande vensters (korter dan 700 px breed, of staand onder 850 px) houden de rij boven het veld (t1131). Geen harde 960 px-drempel: een kort liggend venster zoals 1024×532 met 3 bots is dus sides.
- Plaatsing (t1127, t1133): mini's worden aan de buitenrand
van het scherm verankerd en vullen naar binnen, richting het veld. Volgorde: 1e links buiten, 2e rechts buiten, 3e links één stap naar binnen, 4e rechts één stap naar binnen, enzovoort. De onderste rij sluit aan op de onderkant van het veld. Eerst wordt een rij horizontaal volgelegd; pas als er aan die kant geen kolom meer bij past, komt er een extra rij naar boven (weer beginnend aan de buitenrand). Mini's worden kleiner als gestapelde rijen anders in de HUD zouden lopen. Het veld gebruikt de volle hoogte onder de HUD plus de boog-padding (miniH = 0).
- Smal scherm / telefoon: de bestaande layout blijft: mini's in
een wrappende rij boven het veld.
- Boogjes zijn puur visueel. De vluchttijd blijft 1,2 s, gelijk
aan de bestaande aflevering (deliver_at / Offline _deliver). We vertragen de gameplay-aflevering níét: een late poll stapt mid-arc in via de server-age (seconden sinds created). Als de vlucht al voorbij is (age ≥ duration), tekenen we geen inhaalboog; de incoming is dan al op schema afgeleverd.
- Vorm: een parabool in schermcoördinaten,
x = lerp, y = lerp − 4·h·t·(1−t) (y groeit naar beneden). Booghoogte h is 0,28 × afstand, geklemd tussen 48 en 220 px, met ease-in-out-cubic. Hits van vijand→speler schalen van mini-tegel naar volle tegel; speler→vijand andersom; vijand→vijand blijven klein. Missers hergebruiken de bestaande fade-en-wegvlieg-animatie; vijand-missers starten kleiner (mini-schaal).
- Vijand→vijand (bot-bot of remote-remote) worden in
#flights-back
getekend (z-index 5, onder #flights z-index 6). Een CSS clip-path spaart het rechthoek van het spelersveld uit, zodat die blokjes achter het veld langs gaan, niet ervoor. Ze blijven zichtbaar in de zijmarges.
- Online ziet elke client alle recente schoten via
shot_flights
op de poll (from_id, target_id, miss, age, flight_duration). Eigen shot_results blijven bestaan; de client de-dupliceert op id. Extra velden zijn backward compatible.
- Performance: alleen CSS-transforms, één tick per frame, beelden
verdwijnen na 1,2 s. Geen pooling nodig voor tientallen bots.
t1126 — boogje eindigt in de kolom waar het blok verschijnt
- De landingskolom (
land_col) wordt gekozen **bij het begin van de
vlucht**, niet pas bij aflevering, en dezelfde waarde geldt voor het eindpunt van de boog én voor ingestGarbage.
- Offline: bij het afvuren kiest het doel-veld een open kolom
(pickGarbageColumn); die zit op het flight-resultaat en op de pending delivery.
- Online: de server kiest
land_col(0–9) bijrecordShots, slaat
het op bij het schot, en stuurt het mee in shot_results, shot_flights en incoming. Een late poll of mid-arc (age) ziet dus dezelfde kolom. De client onthoudt land_col ook zelf (_pendingLandCol) als vangnet.
- Als de gekozen kolom bij aflevering niet meer open is (vol of
vergrendeld in de 1,2 s vliegtijd), valt ingestGarbage terug op een andere open kolom. Dat is zeldzaam; dan kan de boog van de echte kolom afwijken.
- Speler→vijand en vijand→vijand richten óók op
land_col: het
eindpunt is de bovenkant van die kolom op de mini van het doel (makkelijk, zelfde veld).
t1128 — vijand↔speler-boogjes gaan om het veld heen
- Boogjes tussen een vijand en het veld van de speler (beide
richtingen) mogen niet over het binnenveld bewegen. Het pad gaat eerst omhoog aan de buitenkant, dan over de bovenrand, en buigt pas daar de doelkolom in. Het eindpunt blijft de bovenkant van land_col.
- Als begin- en eindpunt al boven de bovenrand liggen (smalle
layout, mini's boven het veld) is een gewone parabool genoeg: die blijft vanzelf boven het veld.
- Vijand→vijand blijft een kleine parabool achter het veld
(#flights-back + clip-path), onveranderd.
t1129 — padding boven het veld in de brede weergave
- Alleen in de brede (sides) layout krijgt het veld extra ruimte
bovenin (ARC_TOP_PAD = 100 px tussen HUD en veld, tegels iets kleiner indien nodig) zodat de omweg-boogjes over de bovenrand passen. Smal en mobiel blijven onveranderd (mini's boven het veld, geen extra pad).
t1130 — raak-schoten zijn visueel grijs
- Wat de ontvanger binnenkrijgt is altijd een grijs vuilblok
(ingestGarbage). Daarom worden alle raak-schoten — vijand→ speler, speler→vijand en vijand→vijand — als grijze blokjes getekend (images/block-gray.png), niet in de kleur van de schutter. Zo komt het boogje overeen met wat er landt.
- Missers houden de kleur van de schutter: daar wordt niets
ontvangen, het blokje vliegt weg en vervaagt zoals voorheen.
t1127 / t1131 / t1133 — mini's van de rand naar binnen, horizontaal eerst
- Tim wilde eerst horizontaal plaatsen en pas verticaal stapelen als
de marge vol is (t1127), en de mini's „uitgelijnd van ons veld weg” (t1131 / t1133): verankerd aan de buitenrand van het scherm, elke volgende op die kant één stap verder naar het veld toe. Dat is het omgekeerde van „eerst tegen het veld, dan naar buiten”.
- Bij 8 tegenstanders past één rij op 1400×900 en 1920×1080; op een
smaller breed scherm (bijv. 1280×900) wrapt de vierde per kant naar een rij daarboven, opnieuw aan de buitenrand.
- De drempel voor sides is versoepeld (t1131): zodra er een mini
naast het veld past — ook een kleinere — kiezen we sides, ook in een kort liggend venster (1024×532, 3 bots). Boogjes vertrekken vanaf de bovenkant van de mini, gaan omhoog en in een ruime boog over de bovenrand naar de landingskolom, niet over de mini's of over het binnenveld.
t1134 — soepele boogjes, en écht uit het veld vliegen
- De oude polyline met hoekpunten (omhoog, horizontaal, omlaag) is
vervangen door een C¹-ketting van kubische Béziers: omhoog uit de lanceerkolom (of langs de buitenkant), een vloeiende kwart-draai, een rechte kruising boven het veld, en een vloeiende duik de landingskolom in. Raaklijnen en snelheid sluiten aan de gewrichten naadloos aan — geen zichtbare hoeken, geen ruk in het tempo. easeInOutCubic (snelheid 0 aan begin en eind) is voor raak-schoten verdwenen; smoothParam houdt aan de uiteinden een niet-nul snelheid.
- Speler↔vijand gaat nog steeds om het veld heen en mag alleen de
lanceer- en landingskolom gebruiken, niet het binnenveld. Vijand→vijand blijft een kleine soepele boog achter het veld.
- Een uitgaand schot start op de echte exit-pose van de raket
(zelfde positie en formaat, fieldToViewport met het +0,5-tegel-midden, y ≥ 13). De boog gaat vanaf daar omhoog verder, zonder pop-in boven het veld. (De vroege overname bij y ≳ 11,6 is in t1137 teruggedraaid.)
t1135 — soepel het veld invliegen, naadloze overdracht
- De boog duikt de landingskolom in en eindigt op de
spawn-pose van ingestGarbage: y = 13 (een halve tegel boven de canvasrand), volle tegelgrootte, raaklijn recht naar beneden. De eindsnelheid is afgestemd op fallSpeed van de planeet, zodat het vallende grijze blok dezelfde positie, grootte en snelheid overneemt — geen pop-in aan de bovenkant. Offline levert battle.tick het blok eerst af en verwijdert daarna de vlucht (één frame overlap op dezelfde pose).
- Aankomst bij een vijand-mini gaat het blokje iets de mini in
(y = 12 in de landingskolom, op mini-formaat). Er is geen live vallende sprite op de mini; het volgende snapshot toont het cel.
t1136 — multiplayer ziet er hetzelfde uit als Offline Strijd
- Online en offline delen dezelfde presentatie:
MiniLayout
(buitenrand, horizontaal eerst, onder uitgelijnd, ARC_TOP_PAD), Online.spawnFlights / tickFlights (C¹-bogen om het veld, land_col, grijze raak-schoten, uitvliegen vanuit de cel, invliegen naar de spawn-pose, vijand→vijand achter het veld) en dezelfde startregel voor de lokale raket (pas bij het echte schot, y ≥ 13).
- De server bewaart nu ook de lanceercel (
from_col,from_y)
en stuurt die mee op shot_results en shot_flights, zodat een andere client het blokje uit de juiste cel van de mini ziet vertrekken (niet vanaf een vast punt boven de mini). Zonder lokale startX (typisch voor een remote poll) gebruikt spawnFlights die col/y.
- Geverifieerd met Playwright: lokale PHP-server, test-auth,
twee Playwright-clients in een echte lobby (lokale PHP-server met test-auth), daarna shot_flights via Online._handleTransitions (het echte poll-pad) op 1920×1080 en 1024×532, plus dezelfde bogen in Offline Strijd (early/mid/ late en een korte webm).
t1137 — pas een boogje als het blok echt het veld verlaat
- Tim zag raketten die net niet hoog genoeg gingen een boogje
maken, het veld uit en weer in, omdat de visuele overname al bij y ≳ 11,6 (met vy > 0) begon. Een raket die daar piekt en terugvalt is nog van het veld en mag geen boog krijgen.
- Een vlucht start alleen bij het echte schot, hetzelfde moment
als cullOffTop: y ≥ 13 (hoogte van het veld). Dat geldt voor het spelersveld, vijand-mini's, offline en online. Online.hasLeftTheField en previewExit weigeren alles daaronder. De overdracht blijft naadloos: start op de exit-pose, volle grootte, raaklijn omhoog, daarna de soepele boog naar het doel.
- Een raket die onder de rand piekt produceert geen
outgoingShot
en geen vlucht; een raket die y ≥ 13 kruist precies één schot en één vlucht, beginnend op die exit-pose.
t1138 — één grote, vloeiende ballistische boog
- Tim vond de bogen na t1134–t1137 al beter, maar wilde ze nóg
vloeiender: geen ketting van stukjes (kwart-draai, rechte kruising op de top, duik) maar één grote, ronde, doorlopende curve, als een ballistische parabool.
- Speler↔vijand is nu één enkele Bézier van graad 7 (één
polynoom, dus C^∞ op (0, 1)): start op de exit-pose (y = 13, raaklijn recht omhoog), een ruime ronde kroon boven het veld (mag hoger — we gebruiken de top-padding ruim, apex zo'n 150 px boven de veldrand), en een duik de land_col in, recht naar beneden, met een eindsnelheid afgestemd op fallSpeed. Het binnenveld wordt nooit gekruist: horizontaal verkeer zit op de top, verticaal alleen in de lanceer-/landingskolom of buiten het veld. Geen rechte cruise, geen zichtbare knikken; de kromming verandert geleidelijk. De parameter loopt over de booglengte (arc-length) met een zachte Hermite-easing, zodat de snelheid langs het pad glad is en de aankomst bij fallSpeed past.
- Vijand→vijand krijgt dezelfde soepele parabool, getekend achter
het veld (#flights-back, clip-path). De startregel van t1137 (y ≥ 13) en de grijze raak-schoten blijven ongewijzigd.
- Unit-tests toetsen krommingscontinuïteit, maximale
krommingsverandering, geen lange rechte middenstukken, verticale uiteinden, corridors, en de fallSpeed-overdracht. Playwright legt early/mid/late vast op 1024×532 en 1920×1080, plus een webm van beide formaten.
t1139 — Planeetontwerper
- De ontwerper is alleen beschikbaar op het hoofdmenu, en alleen als
je bent ingelogd. Tot de live OAuth-callback en het CI-geheim auth_client_secret zijn ingericht, is dat op productie onzichtbaar. Lokaal kun je inloggen met auth.php?test=1 (of test=2).
- Levenslange punten staan in het server-profiel (
profiles). Alleen
ingelogde spellen tellen mee. Bots leveren geen punten op.
- Spelen (solo): de score aan het einde van het spel.
- Offline Strijd: de score van elke ronde, gewonnen of
verloren, omdat de score per ronde opnieuw begint.
- Online: de server kent de score via de poll; punten worden
toegekend bij uitschakeling of als de lobby klaar is, één keer per online:{lobbyId}:{userId}. De client kan hier geen punten insturen.
- Anti-cheat voor solo/offline:
play_begingeeft een eenmalig token
(geldig 6 uur). play_finish klempt de score op 0–10000, weigert een positieve score als het spel korter dan 3 seconden duurde, en laat maximaal 4 punten per seconde door. Herhaalde finishes van hetzelfde token zijn een no-op. Overduidelijk valsspelen wordt geklemd, niet keihard verboden, zodat een trage verbinding geen eerlijke score weggooit.
- Het blokjesregister (
server/lib/blocks.json) is append-only: de
volgorde ligt nu vast. Eerst Terra's vijf (gratis), daarna 43 nieuwe icoontjes (eerste, Fehu, op 500 punten; daarna telkens 14,5 % meer, afgerond en strikt stijgend — de laatste icoon zit rond de 147 000 punten), daarna de 55 kleuren van de officiële niet-Terra-planeten als lange staart (de laatste zit in de honderden miljoenen). Punten zijn een eis, geen uitgave. Officiële planeten blijven hun eigen blokjes gebruiken zonder ontgrendeling; ontgrendelen is alleen voor de ontwerper.
- Een speler mag tot 30 eigen planeten hebben. Id's zijn
c_plus
16 hex-tekens. Namen (planeet en volk) zijn 1–32 tekens, zonder tags. De vijf blokjes moeten verschillend en ontgrendeld zijn.
- Nieuwe blokjes-plaatjes staan in
build/images/block-*.png, 64×64,
in dezelfde stijl als Terra (gekleurde silhouet, donkere omtrek, highlight, slagschaduw). Gegenereerd door scripts/gen_unlock_blocks.py.
t1140 — Eigen planeten in elke modus
- In Spelen, Offline Strijd en Online Spelen toont de planeetkiezer
naast de officiële catalogus ook je eigen ontworpen planeten (badge "Eigen"). Planeten van anderen staan daar niet in.
- Voor Online stuurt de client alleen het planeet-id. De server
controleert eigendom, legt een snapshot (planet_json) vast bij kiezen/aanmaken/joinen, en stuurt de volledige configuratie (variabelen, kleuren, miss_chance) mee in de lobby. Tegenstanders onthouden die snapshot om fysica, miss-kans en sprites te simuleren; een latere wijziging of verwijdering verandert een lopend spel niet.
t1141 — taalkeuze (i18n)
- De standaardtaal is Engels, ook als de browser op Nederlands staat.
Er is geen automatische detectie van de browsertaal.
- De keuze staat in
localStorage(meteors-locale) en in een cookie
(voor de inlogpagina’s). Ben je ingelogd, dan wordt ze ook in het serverprofiel bewaard (set_locale). Bij inloggen wint de profieltaal; is die nog leeg, dan wordt de lokale keuze naar de server geschreven.
- Vlaggen zijn lokale SVG’s in
build/images/flags/(geen emoji).
Engels gebruikt de vlag van het Verenigd Koninkrijk, Chinees die van de Volksrepubliek (vereenvoudigd Chinees), Koreaans die van Zuid-Korea.
- Officiële planeetnamen (Terra, Aurel, …) blijven eigennaam;
bevolkingsnamen en blokjesnamen zijn vertaald. Zelfgekozen namen van eigen planeten blijven ongewijzigd.
- Serverfouten blijven in het Nederlands in de API (bestaande tests);
de client vertaalt bekende meldingen naar de actieve taal.
- CJK-tekst gebruikt systeemfonts (Hiragino, PingFang, YaHei, Malgun
Gothic, Noto Sans CJK, …) als fallback. Knoppen mogen wrappen zodat langere vertalingen (Duits, Nederlands) niet over de rand lopen.
t1143 — leeg speelscherm na inloggen
- De live-screenshot (HUD “PUNTEN 0” en “Terra”, geen veld, wel sterren)
kwam doordat new Scene “WebGL is not supported” gooide nadat de HUD al zichtbaar was met de standaard-HTML (“Terra”, score 0). De Scene-constructor plaatst eerst een transparant canvas en initialises daarna WebGL; bij een blocklist blijft dat canvas leeg en schijnt het sterrenveld erdoorheen. In de page-console staat die fout, in het Chrome-GPU-log “WebGL1 blocklisted”.
- Dat is geen fout in de planeetkeuze,
?online=1, i18n ofplay_begin.
Dezelfde flow (inloggen, Back, Nederlands, eigen planeet “Testplaneet Ada”, Spelen) toont het veld en de juiste HUD-naam zodra WebGL beschikbaar is (o.a. met SwiftShader). Uitgelogd solo op live ook.
startPlaytoont de HUD nu pas ná een geslaagde scene, vangt een
WebGL-fout, ruimt wees-canvasses op en toont een melding op het menu.
- Solo-game-over roept
play_finishaan; verdiende punten gaan bij een
ingelogde speler naar het levenslange totaal (anti-cheat: o.a. min. 3 s bij score > 0, max. 4 punten/s).
t1144 — bots kijken 1 of 2 zetten vooruit
- Alleen in Offline Strijd. Online is PvP: er zijn geen server-side
bots, en die zijn ook niet toegevoegd.
- Als een bot zijn kansrol haalt (
roll < skill) en er ligt al een
match op het veld, doet hij niets (zoals in t1119) en vergeet hij een eventueel onthouden plan.
- Anders zoekt hij eerst een onmiddellijke match: dezelfde kortste
verticale zet als in t1119 (daarna laagste kolom / fromY / toY). Die gaat altijd voor, ongeacht de skill.
- Is er geen onmiddellijke match, dan kan hij tot diepte 2 zoeken:
een eerste verschuiving die zelf geen match maakt, maar een tweede mogelijk maakt. Hij voert alleen de eerste zet van het beste plan uit en onthoudt de rest (bot.plan).
- Het beste plan is dat met de kleinste som van de twee afstanden,
dan de kortste eerste zet, daarna dezelfde kolom/fromY/toY-volgorde als t1119 (eerst voor de eerste zet, dan voor de tweede).
- Op de volgende geslaagde rol volgt hij de onthouden tweede zet als
die nog legaal is en (als laatste stap) nog een match maakt — ook als de skill dan te laag is om een nieuw plan te starten. Een gevolgde zet vereist nog steeds een gewonnen rol die tick. Is het plan ongeldig geworden, dan plant hij opnieuw (eerst onmiddellijk, dan eventueel een nieuwe setup).
- De kans om een nieuw 2-stapsplan te zoeken hangt van de skill af:
0 % bij skill ≤ 10 % (rondes 1–6), daarna lineair naar 100 % bij skill ≥ 40 % (ronde 36 en verder). Zo blijven vroege rondes makkelijk en worden late bots slimmer.
- De zoektocht blijft goedkoop op een veld van 10×13: alleen legale
verticale zetten binnen aaneengesloten segmenten (geen sprong over een gat, geen vergrendelde kolom, geen enkel blokje alleen), apply+undo op één rooster, korte zetten eerst, stop bij het eerste 1+1-plan (dat is door de sorteervolgorde al de winnaar), en een plafond van 4000 bord-evaluaties per tick. Als dat plafond wordt bereikt kan een zeldzame langere setup worden gemist.
t1173 / t1174 — puntenscherm na een spel of ronde
- Alleen voor ingelogde spelers. Uitgelogd blijft alles zoals het
was (game-over-overlay in solo, de oude vertraging tussen Offline-rondes, podium in Online).
- Gewonnen of verloren: Spelen (solo) eindigt altijd doordat je
veld vol loopt, dus daar staat “You lost...”. Offline Strijd: een gewonnen ronde (alle bots uit) → “You won!”, verlies → “You lost...”. Online: plek 1 → “You won!”, anders “You lost...”. Teksten staan in alle tien talen (reward.won / reward.lost).
- Volgorde: de titel staat 1 s gecentreerd en schuift dan in 0,6 s
naar boven. Pas als de server het nieuwe totaal heeft bevestigd begint het tellen: het getal onderaan start op het totaal vóór de ronde en elk aankomend blokje telt er 1 bij op, tot het nieuwe totaal. Bij 0 verdiende punten staat het getal kort (1,5 s) in beeld zonder blokjes. Aan het eind blijft het eindtotaal 1,5 s staan.
- Tempo (t1174, i.p.v. een overslaanknop; aangepast in t1175, t1177 en t1178):
rate = 15 + 10·t blokjes/s (RATE0 = 15, ACCEL = 10 in src/reward.js; t1174 had 5 + 1·t, t1175 5 + 3·t, t1177 10 + 5·t). Na t seconden zijn er 15t + 10t²/2 vertrokken; blokje i vertrekt op t = (−15 + √(225 + 20i)) / 10. Het laatste blokje vertrekt bij 253 punten na ≈ 5,8 s, bij 800 na ≈ 11,2 s en bij 2000 na ≈ 18,6 s, plus 0,7 s vlucht.
- Prestaties (t1178): aan het eind van 2000 punten gaan er ~200
blokjes/s weg en zijn er ~140 tegelijk in de lucht. Gemeten in headless Chrome: desktop 1280×800 ~59 fps; mobiel 390×844 @3× met 4× CPU-vertraging ~59 fps (p95 16,7 ms), ook met een lopend speelveld erachter. Eén 2D-canvas, geen DOM-element per blokje, dus geen extra begrenzing nodig. Er is geen overslaan-knop en geen sneltoets om meteen naar het eindtotaal te springen. Wel mag je tijdens die laatste 1,5 s (eindtotaal staat al) tikken/klikken of Spatie/Enter drukken om meteen door te gaan.
- Bron van de getallen: solo en Offline gebruiken het antwoord van
play_finish: nieuw totaal = lifetime_points, start = lifetime_points − awarded. Online is er geen play_finish; de server kent de punten zelf toe bij uitschakeling/einde. Het start- getal is het profieltotaal bij de start van de wedstrijd, het eindgetal het totaal uit de poll die de wedstrijd als afgelopen meldt (de toekenning gebeurt in dezelfde transactie, vóór het antwoord). Antwoordt de server niet binnen 8 s of met een fout, dan wordt niets geteld en gaat het scherm na 1,5 s verder.
- Blokjes: willekeurig gekozen uit de vijf blokjes (plaatjes) van
de planeet waarmee je die ronde speelde, ook bij eigen planeten. Ze starten op een willekeurige x net boven het scherm en volgen een kwadratische boog met een willekeurig controlepunt naar het getal.
- Daarna: solo → menu; Offline gewonnen → volgende ronde; Offline
verloren → het bestaande resultaatscherm; Online → de lobby. Omdat de server de lobby na 5 s podium al terugzet, wacht de client met teruggaan tot het puntenscherm klaar is. Is de lobby dan nog niet terug, dan zie je de rest van het podium.
- Techniek: een DOM-overlay met één 2D-canvas voor de vliegende
blokjes (geen extra WebGL-context), ~20 tegelijk in beeld, getekend via requestAnimationFrame (frames worden afgekapt op 0,1 s, dus een achtergrondtab springt niet). Werkt op desktop en mobiel. Bij prefers-reduced-motion vliegen er geen blokjes en springt de titel zonder animatie naar boven; het getal telt in hetzelfde tempo op.
Source
| 1 | # Aannames — Meteors |
| 2 | |
| 3 | Waar de specificatie ruimte liet, staat hier hoe we het hebben ingevuld. |
| 4 | Als iets onduidelijk was, volgden we de geest van Meteos en (voor de |
| 5 | selectie-tween) Tim's bestaande KWin-effecten. |
| 6 | |
| 7 | ## Fase 1 — physics-fixes (t1098u, t1100u, t1101u) |
| 8 | |
| 9 | ### 1. Vallende blokken landen op vliegende clusters |
| 10 | |
| 11 | Een gespawnd (vallend) blok ging soms door een vliegende cluster heen, |
| 12 | omdat de val alleen keek naar stilliggende/settling/locked blokken. |
| 13 | |
| 14 | Aanname: het vallende blok botst alleen in dezelfde kolom. Het landt op |
| 15 | het hoogste vliegende clustermlid onder hem, wordt vracht van die |
| 16 | cluster (`state = flying`, zelfde `clusterId` en `vy`, geen vlam) en |
| 17 | vliegt mee, inclusief omhoog als de cluster nog stijgt. Nieuwe vracht |
| 18 | zit precies 1 tegel boven het hoogste clustermlid in die kolom. |
| 19 | |
| 20 | Omgekeerd, als een stijgende cluster een vallend blok inrijdt, geldt |
| 21 | hetzelfde. Een cluster die al geland is (rigid settling) telt als vaste |
| 22 | ondergrond: daar landt een vallend blok gewoon op, het wordt geen vracht. |
| 23 | |
| 24 | ### 2. Grijze clusters landen als starre groep |
| 25 | |
| 26 | Voorheen werd elke kolom bij landing platgedrukt op de stapel, waardoor |
| 27 | gaten verdwenen. |
| 28 | |
| 29 | Aanname: zodra één lid de vloer of een stil blok raakt, stopt de hele |
| 30 | cluster als star lichaam. De relatieve posities blijven; een deel kan |
| 31 | dus boven een gat blijven hangen. Gekleurde vracht (meegedragen blokken) |
| 32 | blijft tot het einde van de settle-tijd van 3 s bij de groep — ze |
| 33 | verkleuren niet opnieuw, maar vallen ook niet eerder. Na de conversie |
| 34 | van de grijze blokken naar willekeurige kleuren laat de hele groep los. |
| 35 | Blokken mét steun blijven liggen; blokken zónder steun vallen |
| 36 | afzonderlijk, vanuit rust, met dezelfde zwaartekracht als een gewone |
| 37 | val (eerst versnellen tot `fallSpeed`, zie punt 3). Gestapelde hangende |
| 38 | blokken vallen als stapel (ze blijven op elkaar rusten, zonder te |
| 39 | overlappen). |
| 40 | |
| 41 | ### 3. Vloeiende snelheidsovergang op de apex |
| 42 | |
| 43 | Voorheen sprong `vy` op de apex in één frame naar `-fallSpeed`. |
| 44 | |
| 45 | Aanname: vanaf de apex (vy = 0) versnelt de cluster (en een handmatige |
| 46 | sprong) met constante `fallAccel` totdat `fallSpeed` is bereikt; daarna |
| 47 | constante daalsnelheid. `apexEaseTime = 0.15 * fallTime` en |
| 48 | `fallAccel = fallSpeed / apexEaseTime`. Lage luchtweerstand (kleine |
| 49 | `fallTime`) geeft dus een kortere, snellere overgang. Voor Terra |
| 50 | (`fallTime = 3`) is dat 0,45 s. Hetzelfde geldt voor hangende blokken |
| 51 | die na conversie uit rust gaan vallen. Blokken die van boven het veld |
| 52 | binnenkomen (spawn) starten al op `fallSpeed` — die vallen al een |
| 53 | tijdje. |
| 54 | |
| 55 | ### 4. Bounce bij landing (planeetparameter) |
| 56 | |
| 57 | Aanname: de bounce is visueel (squash van de sprite, plus een heel klein |
| 58 | optisch terugveren in Y) en verandert de simulatiefysica niet. Elk blok |
| 59 | dat op de vloer of op een ander blok landt, krijgt een bounce; hangende |
| 60 | leden van een starre groep die niets raken, niet. |
| 61 | |
| 62 | Snelheid hangt af van de luchtweerstand van het veld, via `fallTime` |
| 63 | (1 = weinig lucht, 5 = veel lucht): |
| 64 | |
| 65 | - `bounceDuration = 0.12 * fallTime` (Terra: 0,36 s; bij `fallTime = 1` |
| 66 | twee keer zo snel als bij `fallTime = 2`, enz.) |
| 67 | - `bounceSquash = 0.16` (subtiele verticale squash naar 84%, met lichte |
| 68 | horizontale compensatie) |
| 69 | |
| 70 | Beide zijn planeetparameters, klaar voor fase 3. |
| 71 | |
| 72 | ### 5. Handmatige sprong van het bovenste blok (t1100u) |
| 73 | |
| 74 | Het naar boven slepen van een blok dat al het bovenste van zijn kolom |
| 75 | is, moest een handmatige sprong starten (tot net onder de bovenrand). |
| 76 | De core vroeg eerder dat de aanwijzer in de lege ruimte boven de stapel |
| 77 | kwam (`y > top + 1 + 0,25`). Wie het bovenste blok vasthad en het |
| 78 | voorbij zijn eigen positie trok, maar niet een hele tegel het gat in, |
| 79 | kreeg geen sprong. Op touch kon `lostpointercapture` de sleep ook te |
| 80 | vroeg beëindigen. |
| 81 | |
| 82 | Aanname: |
| 83 | |
| 84 | - Begon de sleep al op het bovenste blok, dan is een trek van |
| 85 | `LAUNCH_PULL = 0,35` tegel omhoog vanaf het drukpunt genoeg |
| 86 | (“voorbij zijn eigen positie”), voor muis én touch (zelfde |
| 87 | Pointer-Events-pad). |
| 88 | - Begon de sleep lager in de stapel, dan blijft de oude drempel gelden: |
| 89 | eerst wisselen, en pas lanceren als de aanwijzer in de lege ruimte |
| 90 | boven de (nieuwe) top zit. Zo lanceer je niet per ongeluk een blok |
| 91 | dat je alleen naar de bovenste plek wilt schuiven. |
| 92 | - De view luistert na `pointerdown` op `window` voor `pointermove` / |
| 93 | `pointerup` / `pointercancel`, zodat een sleep boven het canvas |
| 94 | (nodig bij een volle kolom) niet verloren gaat. `lostpointercapture` |
| 95 | beëindigt de sleep niet meer. |
| 96 | |
| 97 | ### 6. Selectie-tween (t1101u) |
| 98 | |
| 99 | Een vastgehouden (geselecteerd) blok krijgt dezelfde schaal-animatie |
| 100 | als de **DEFAULT**-instellingen van Tim's KWin Click Tween-effect. |
| 101 | |
| 102 | Bron (op deze box): `/workspace/click-tween/`, specifiek: |
| 103 | |
| 104 | - `settings.h`: `clickTime = 150` ms, `releaseTime = 720` ms, |
| 105 | `clickEasing = easeOutBack`, `releaseEasing = easeOutElastic` |
| 106 | - `clicktween.cpp`: pers-doel `0.8`, loslaat-doel `1.0`; een onderbroken |
| 107 | animatie start vanaf de huidige schaal (`QVariantAnimation`) |
| 108 | - `README.md`: “krimpt naar 80% in 150 ms”, “groeit in 720 ms terug”, |
| 109 | “curveparameters zijn Qt-standaardwaarden” |
| 110 | |
| 111 | Qt `QEasingCurve`-standaardwaarden, ook in de README genoemd: |
| 112 | |
| 113 | - Back-overshoot: `1.70158` |
| 114 | - Elastic: amplitude `1.0`, periode `0.3` |
| 115 | |
| 116 | Het blok blijft op 80% zolang het geselecteerd is, en veert bij loslaten |
| 117 | terug (ook als het ondertussen gelanceerd wordt). Muis en touch gebruiken |
| 118 | dezelfde tween. |
| 119 | |
| 120 | ## Fase 2 — multiplayer (samenvatting) |
| 121 | |
| 122 | De miss-kans van 30% was de stage-2-parameter; stage 3 vervangt die door |
| 123 | parameter (`missChance`, standaard 0,30); de planeetformule |
| 124 | `Planet.missChance` (60%–5% via Power) is voor fase 3. |
| 125 | |
| 126 | ## Deploy: vreemde bestanden en favicon.ico |
| 127 | |
| 128 | De FTP-guard blokkeert alleen een duidelijk verkeerd doel (FTP-root, pad |
| 129 | zonder `meteors` als laatste segment, map buiten `$timftproot`). Extra |
| 130 | bestanden die al in de remote map staan, worden alleen gelogd: we gebruiken |
| 131 | nooit `--delete`, dus ze blijven staan en zijn onschadelijk. |
| 132 | |
| 133 | `favicon.ico` op de server wordt niet overschreven en niet verwijderd |
| 134 | (mogelijk van Tim of de host). De deploy sluit dat bestand uit van de |
| 135 | upload, ook als er lokaal een `build/favicon.ico` staat voor eigen gebruik. |
| 136 | |
| 137 | ### 7. Recolor stuurt blokken niet extra hard naar boven (t1102) |
| 138 | |
| 139 | Na het herkleuren van een gelande grijze groep schoten blokken erboven |
| 140 | soms heel hard van de bovenkant af. Oorzaak: een restant van de |
| 141 | lanceringssnelheid (`vy` omhoog) of van een handmatige sprong, dat |
| 142 | na de release in `integrateFalling` alsnog werd gebruikt. Daarnaast |
| 143 | telde `releaseUnsupported` in dezelfde tick nog de hangende leden als |
| 144 | steun, zodat blokken die erop stonden `still` bleven en in |
| 145 | `resolveMatches` een match in de lucht konden vormen. |
| 146 | |
| 147 | Aanname / aanpak: |
| 148 | |
| 149 | - Bij elke overgang naar `still` of `falling` na release (en bij het |
| 150 | loslaten van ongesteunde still-blokken) wordt `clearFlightState` |
| 151 | aangeroepen: `vy = 0`, geen vlam, geen restant van een handmatige |
| 152 | sprong. |
| 153 | - `releaseUnsupported` draait opnieuw ná `advanceSettle`, zodat |
| 154 | blokken op zojuist losgelaten hangende leden vanaf rust vallen |
| 155 | voordat er gematcht wordt. |
| 156 | - Een échte nieuwe match na herkleuren is toegestaan en gebruikt de |
| 157 | normale sprong: `launchVelocity(planet, jumpHeight)` en de bijbehorende |
| 158 | deceleratie, niet een opgetelde of achtergebleven `vy`. Dat zit in |
| 159 | een regressietest (inclusief een kunstmatig achtergebleven `vy = 40`). |
| 160 | |
| 161 | ### 8. Botsende vliegende clusters smelten samen (t1102) |
| 162 | |
| 163 | Twee (of meer) vliegende clusters die in dezelfde kolom in Y |
| 164 | overlappen, worden één cluster. |
| 165 | |
| 166 | Aanname: de nieuwe snelheid is het **massagewogen gemiddelde op |
| 167 | blok-aantal** (niet het eenvoudige gemiddelde van de twee |
| 168 | clustersnelheden): |
| 169 | |
| 170 | vy = (n1·vy1 + n2·vy2) / (n1 + n2) |
| 171 | |
| 172 | Hetzelfde gewogen gemiddelde geldt voor `decel` en `jumpHeight`. |
| 173 | De fase is `up` als de samengevoegde `vy > 0`, anders `down`. |
| 174 | Overlappende leden in één kolom worden van onder naar boven |
| 175 | aangepakt, zodat de hogere strak op de lagere rust (geen twee |
| 176 | blokken in dezelfde cel). Keuze vastgelegd: gewogen op blok-aantal. |
| 177 | |
| 178 | ### 9. Direct vastpakken, geen long-press (t1102 / t1103) |
| 179 | |
| 180 | Er is **geen** long-press en **geen** wachttijd. Een blok wordt op |
| 181 | `pointerdown` (tap of klik) meteen vastgepakt en blijft in de sleep |
| 182 | zolang de vinger of muisknop omlaag is; loslaten beëindigt de sleep. |
| 183 | De click-tween start in hetzelfde moment als `pointerdown`. |
| 184 | |
| 185 | Aanname: |
| 186 | |
| 187 | - Verticaal: snap naar het dichtstbijzijnde still-blok in de kolom, |
| 188 | tot `SNAP_Y = 0,65` tegel (een iets misplaatste druk pakt nog). |
| 189 | - Horizontaal: op de druk, als de aanwijzer binnen |
| 190 | `HORIZONTAL_SLOP = 0,35` tegel van de kolomrand zit, mag het |
| 191 | buurblok gepakt worden. Tijdens de sleep blijft de startkolom |
| 192 | vast, ook bij een iets diagonale beweging. |
| 193 | - Wisselen: alleen een **minimale** opgetelde verticale afstand |
| 194 | `SWAP_DISTANCE = 0,25` tegel per stap, zonder vertraging vóór de |
| 195 | sleep. Een enkele grote `pointermove` (snelle swipe) loopt alle |
| 196 | tegels langs (één wissel per tegel, geen overslaan). Er is geen |
| 197 | extra drempel of hold voordat de sleep begint. |
| 198 | - `touch-action: none` op canvas en pagina, `preventDefault` op |
| 199 | pointer-events met `{ passive: false }`, `setPointerCapture`, |
| 200 | en window-listeners voor move/up (zoals al bij t1100). |
| 201 | |
| 202 | ## Fase 2 — multiplayer |
| 203 | |
| 204 | ### Polling en autorisatie |
| 205 | |
| 206 | - De client pollt elke **0,75 s** (`Online.POLL_MS`). Dat valt in de gevraagde |
| 207 | 0,5–1 s. Er is geen websocket. |
| 208 | - Login via auth.timfalken.com (`/oauth/authorize`, `/oauth/token`, `/api/me`), |
| 209 | client_id `projects.timfalken.com`. Callback |
| 210 | `https://projects.timfalken.com/meteors/callback.php`. Het geheim zet Tim |
| 211 | als protected projectgeheim `auth_client_secret` (niet opnieuw genereren); |
| 212 | de deploy schrijft dan `data/config.php`. Zonder geheim blijft solo |
| 213 | werken, met een duidelijke online-melding. |
| 214 | - Testers `auth.php?test=1` / `?test=2` alleen als `localDev()` waar is: |
| 215 | loopback-host **én** loopback-remote-adres (zelfde regel als verhalenboek). |
| 216 | - Sessies staan in `data/sessions`, cookie-pad is de map van het script |
| 217 | (`/meteors/` live). CSRF-token op elke POST (`X-CSRF-Token`). |
| 218 | |
| 219 | ### Lobby en wedstrijd |
| 220 | |
| 221 | - Onbeperkt in de zin van de regel; praktisch maximum **32** (`METEORS_MAX_PLAYERS`). |
| 222 | - De host start alleen als iedereen gereed is en er minstens twee spelers zijn. |
| 223 | - Eigen veld is het hoofdspel; miniaturen van anderen staan in een strook |
| 224 | boven het veld (onder de HUD). |
| 225 | - Afgeschoten blokjes gaan als `outgoingShots` mee in de volgende poll. De |
| 226 | **server** kiest het doel en gooit de miss-kans (niet de client, zodat die |
| 227 | niet kan valsspelen). Doel is een willekeurige andere speler die nog niet |
| 228 | is uitgeschakeld. |
| 229 | - `missChance` is een **parameter**, standaard **0,30**, op de lobby én op |
| 230 | `GameCore`. `Planet.missChance` (Power, 60 %–5 %) blijft voor stage 3 en |
| 231 | wordt hier niet gebruikt. |
| 232 | - Een raak schot komt na `flight_duration = 1,2 s` bij de ontvanger aan als |
| 233 | vallend donkergrijs vuil (`ingestGarbage`), dat na de gewone 3 s settle |
| 234 | een willekeurige kleur krijgt. |
| 235 | - De vlucht-tween is een kwadratische Bézier, met semi-willekeurige rotatie |
| 236 | (tot ±720°) en krimpen (“de verte in”). Een miss vliegt het scherm af en |
| 237 | vervaagt; een raak schot landt in de miniatuur van het doel. |
| 238 | - Uitgeschakelde spelers zijn toeschouwer (geen doelwit, geen shots). De |
| 239 | laatste die overblijft is 1e; de eerder uitgeschakelden 2e, 3e, … Het |
| 240 | podium blijft **5 seconden** (`METEORS_PODIUM_SECONDS`) en daarna gaat de |
| 241 | lobby terug naar `waiting` (ready-vlaggen gereset). |
| 242 | - `data/` (sqlite, sessies) wordt nooit gespiegeld of gewist. Alleen |
| 243 | `data/.htaccess` (Require all denied) wordt na de mirror gezet. |
| 244 | Als het projectgeheim `auth_client_secret` niet leeg is, schrijft de |
| 245 | deploy `data/config.php` vanuit dat geheim (waarde nooit in de logs). |
| 246 | Is het leeg of afwezig, dan blijft een bestaand bestand staan. De groep |
| 247 | `projects-timfalken-com` en verhalenboek hebben dit geheim niet (alleen |
| 248 | FTP); Tim zet het op het meteors-project. Optioneel: `auth_client_id` |
| 249 | (standaard `projects.timfalken.com`). `favicon.ico` blijft ongemoeid. |
| 250 | `router.php` is alleen voor lokale `php -S` en gaat niet mee naar live. |
| 251 | |
| 252 | ## Fase 3 — planeten (velden) |
| 253 | |
| 254 | - Een veld is een planeet, met een naam voor de planeet en voor het volk. |
| 255 | De catalogus staat in `server/lib/planets.json` (bron voor JS én PHP) en |
| 256 | telt **12** werelden, van makkelijk (Aurel: gameplay-Power 0, 60 % miss, |
| 257 | getoonde Power 0 %) tot moeilijk (Cinder: gameplay-Power 1, 5 % miss, |
| 258 | getoonde Power 92 %). Terra (44 % getoonde Power) blijft de standaard. |
| 259 | - Zwaartekracht (`jumpsToClear` 1–4): één sprong haalt |
| 260 | `1,5 / jumpsToClear` van de veldhoogte (t1119, +50 %). Luchtweerstand |
| 261 | (`fallTime` 1–5 s tot de bodem voor losse blokjes; een vliegende |
| 262 | cluster zweeft na de apex in 2× `fallTime` naar beneden, t1122/t1124). |
| 263 | Massa |
| 264 | (`riseTime` 0,5–3 s tot de apex). Lage massa en lage luchtweerstand en |
| 265 | hoge zwaartekracht zijn moeilijker. Bounce-duur en apex-ease schalen al |
| 266 | met `fallTime` (gebouwd in stage 1). |
| 267 | - De interne (gameplay-)Power is het gemiddelde van die drie assen, |
| 268 | genormaliseerd 0–1. Miss-kans = `0,60 − 0,55 × Power` (60 % bij 0, |
| 269 | 5 % bij 1). Dat formule blijft de gameplay: schoten en de server |
| 270 | gebruiken hem onveranderd. De **getoonde** Power in kiezer, HUD en |
| 271 | lobby is `1 − miss / 0,60` als percentage (0 % miss → 100 % Power, |
| 272 | 60 % miss → 0 % Power). Dat is alleen weergave (t1105). In |
| 273 | multiplayer gebruikt de **server** de gameplay-Power van **jouw** |
| 274 | planeet voor de blokjes die jij afschiet (niet de lobby-waarde, niet |
| 275 | de planeet van het doel). De client kan dat niet vervalsen. |
| 276 | - De vier getallen op de kiezers en in de HUD: `g` als |
| 277 | zwaartekrachtsconstante (m/s²), `d` als luchtdichtheid, `F` in newton, |
| 278 | getoonde Power als percentage. Alleen de getallen, zonder uitleg. |
| 279 | Verticale match van 3 = 120 % sprong, +5 % per extra blokje (al |
| 280 | gebouwd, nergens uitgelegd). |
| 281 | - Elk veld heeft een eigen set van 5 kleuren, elk met een uniek vormpje |
| 282 | en een uniek placeholder-PNG (`build/images/block-{planeet}-{kleur}.png`). |
| 283 | Tim kan die bestanden zelf vervangen; de namen blijven gelijk. Te |
| 284 | (her)genereren met `python3 scripts/gen_planet_blocks.py`. |
| 285 | - Planeetkeuze komt vóór solo-spel (`Spelen` opent de kiezer) en in de |
| 286 | lobby (iedereen kiest zelf; zichtbaar voor de anderen). De keuze wordt |
| 287 | onthouden in `localStorage` (`meteors-planet`). Na de start van een |
| 288 | wedstrijd kun je niet meer wisselen. |
| 289 | |
| 290 | ## t1104 — 1:1-slepen en spontane raketten |
| 291 | |
| 292 | - Oorzaak van de sleepbug: `moveDrag` werkte met een opgetelde |
| 293 | pointer-delta en een drempel van `SWAP_DISTANCE` (0,25 tegel). Een |
| 294 | klein stukje sleep deed daardoor al een hele tegel, en één grote |
| 295 | `pointermove` (typisch op touch) kon de rest van de kolom aflopen — |
| 296 | precies “meestal gelijk helemaal omlaag of omhoog”. De doelrij was |
| 297 | niet de rij onder de vinger, dus als de vinger stopte kon het blokje |
| 298 | al aan de top of de bodem zitten. Daarnaast liep de pointer-mapping |
| 299 | via `canvas.width` / `app.tile`, wat deltas zou vermenigvuldigen met |
| 300 | de devicePixelRatio als de backing-store en de CSS-maat ooit |
| 301 | uit elkaar lopen. |
| 302 | - Nu: de doelrij is `floor(pointerY)`, geklemd op de still-stapel van |
| 303 | de kolom. `swapToward` wisselt stap voor stap met elke buur, en stopt |
| 304 | precies daar. Als de pointer stilstaat, beweegt er niets meer. |
| 305 | Optrekken-boven-de-top om te lanceren blijft. Coordinaten komen uit |
| 306 | `getBoundingClientRect` en de veldgrootte (10×13), zonder |
| 307 | canvas-backing of `app.tile`. |
| 308 | - Spontane rijen (na vallen, settle/recolor, cargo-attach op een |
| 309 | vliegende cluster, cluster-merge) worden altijd raketten, net als |
| 310 | wanneer de speler ze maakt. In een al vliegende cluster geeft dat |
| 311 | een extra sprong vanaf de huidige positie (`checkChainRelaunch`, |
| 312 | dezelfde hoogte als bij een player-push). Mid-air hangend cargo na |
| 313 | recolor valt nog steeds vanuit stilstand (t1102), geen launch. |
| 314 | |
| 315 | ## t1105 — getoonde Power omgekeerd |
| 316 | |
| 317 | - Alleen de weergave. Gameplay `power()` en `missChance()` zijn |
| 318 | onveranderd (`miss = 0,60 − 0,55 × power`). Getoonde Power = |
| 319 | `1 − missChance / 0,60`, afgerond als percentage, in JS |
| 320 | (`Planet.displayValues` / `formatStats`) en PHP (`Planets::displayValues`), |
| 321 | dus op de planeetkiezer, in de HUD en in de lobby. 0 % miss is 100 % |
| 322 | Power; Aurel 0 %, Terra 44 %, Cinder 92 %. |
| 323 | |
| 324 | |
| 325 | ## t1106 — touch is leidend bij een echte aanraking |
| 326 | |
| 327 | - De Playwright-tests van t1104 waren circulair: ze rekenden `field_to_client` |
| 328 | met dezelfde CSS-rectformule als `fieldFromEvent`, dus ze konden de bug |
| 329 | op Tims echte telefoon niet reproduceren. Onderzoek met CDP-touch op |
| 330 | emulated Android (DPR 2,625/3), live site, URL-balk-resize, pointercancel |
| 331 | en vallende kolommen liet zien dat correcte CSS-coördinaten wél 1:1 |
| 332 | blijven. De echte fout zat in de gebeurtenissen zelf. |
| 333 | - Op mobiel kan `PointerEvent.clientX/Y` tijdens een touch verkeerd zijn |
| 334 | (onder andere bij een gezoomde visual viewport), terwijl |
| 335 | `TouchEvent.changedTouches` de juiste plek houdt. Een reeks |
| 336 | `pointermove`s die naar een ander veld-Y interpoleren, liep daardoor de |
| 337 | hele kolom af — precies “één vakje slepen, blokje helemaal naar boven |
| 338 | of beneden”. |
| 339 | - Aanvullend: `preventDefault` op een PointerEvent houdt op veel mobiele |
| 340 | browsers het touch-scrollen niet tegen (daarvoor is een niet-passieve |
| 341 | `touchmove` nodig). `setPointerCapture` eindigt daar vaak in |
| 342 | `pointercancel`. `layout()` draaide elke frame en kon het canvas |
| 343 | midden in een sleep verplaatsen (URL-balk). |
| 344 | - Oplossing: zolang een echte `touchstart` is binnengekomen |
| 345 | (`app.activeTouchId`), zijn Touch Events leidend. `pointermove` / |
| 346 | `pointerup` / `pointercancel` worden dan genegeerd. Als er geen |
| 347 | TouchEvent komt (pointer-only touch, zoals sommige Playwright-paden), |
| 348 | blijven de pointer-events gewoon werken. Document-listeners voor |
| 349 | touch staan tijdens het spel op `{capture:true, passive:false}` en |
| 350 | roepen `preventDefault` aan. Geen `setPointerCapture`. `pointercancel` |
| 351 | en `touchcancel` beëindigen de sleep zonder lancering. `layout()` |
| 352 | bevriest zolang er een sleep loopt en `layoutIfNeeded` slaat over als |
| 353 | de viewport niet veranderde. Canvas heeft `touch-action:none` en |
| 354 | `position:fixed`; `html,body` hebben `overscroll-behavior: none`. |
| 355 | - Debug: `?debug=drag` of `localStorage.meteors-debug-drag=1` toont een |
| 356 | overlay (`#drag-debug`) met fase, event, bron, fieldY, doelrij, blockY, |
| 357 | launch-intent, touchId en pointerId. |
| 358 | - Regressietest: vergiftigde `pointermove`s naar fieldY 9,5 plus |
| 359 | correcte `touchmove`s naar 1,5 laten het blokje op y=1 staan, niet |
| 360 | op de top. Die test faalde op het oude pointer-only pad. |
| 361 | |
| 362 | ## t1107 — slepen onder een vliegende cluster en door een gelande |
| 363 | |
| 364 | - `isColumnStill` blijft streng (false zodra er iets vliegt, valt of |
| 365 | settlet in de kolom). Alleen het sleep-pad gebruikt |
| 366 | `columnAllowsDrag` (`!isColumnLocked`) en `isDraggableBlock`. |
| 367 | - Blokjes die stil of settlend op de grond staan, zijn sleepbaar, ook |
| 368 | als er in dezelfde kolom een vliegende cluster boven hangt. De |
| 369 | vliegende cluster zelf is niet sleepbaar: in Meteos speel je op de |
| 370 | grond, raketten in de lucht herschik je niet. |
| 371 | - Een gelande cluster (fase `landed`: grijze raketblokjes en gekoppeld |
| 372 | cargo, state SETTLING) is wél sleepbaar, zolang de kolom een |
| 373 | aaneengesloten stapel is (geen gat). `swapToward` stopt bij een gat. |
| 374 | Hangende leden (SETTLING telt als grounded) horen bij de stapel-top. |
| 375 | - Van plaats wisselen *binnen* dezelfde gelande cluster verandert alleen |
| 376 | de posities. Een blokje *uit* de cluster wisselen haalt het eruit: |
| 377 | een grijs blokje blijft settlen op zijn eigen resterende timer en |
| 378 | recolored alleen; gekleurd cargo wordt STILL als het steun heeft, |
| 379 | anders FALLING. Een blokje *in* de cluster wisselen krijgt dat |
| 380 | `clusterId`, wordt SETTLING en `flame` uit. Een grijs blokje dat |
| 381 | instapt met `settleTime` 0 kan de groeps-release vertragen tot zijn |
| 382 | eigen 3 s om is. Lidmaatschap wordt pas ná de join van de ander |
| 383 | gewist, zodat `leaveCluster` een nog niet-lege cluster niet verwijdert. |
| 384 | - `startManualLaunch` roept eerst `leaveCluster` aan, zodat een gooien |
| 385 | vanuit een gelande groep het blokje losmaakt. |
| 386 | |
| 387 | ## t1108 — een gegooid blokje botst met vallende blokjes |
| 388 | |
| 389 | - Een handmatig omhoog gegooid blokje (state MANUAL) botst met vallende |
| 390 | blokjes op dezelfde manier als twee vliegende clusters: ze smelten |
| 391 | samen tot één vliegende cluster. Snelheid, vertraging en spronghoogte |
| 392 | zijn het massagemiddelde per blokje (zelfde regel als |
| 393 | `mergeClusterGroup`). Een stapel aaneengesloten vallende blokjes |
| 394 | gaat in één keer mee. |
| 395 | - Ze kunnen elkaar in één substep niet kruisen: zowel `integrateManual` |
| 396 | als `integrateFalling` kijken naar het hele pad van die stap |
| 397 | (swept overlap) en mergen vóór de posities elkaar passeren. |
| 398 | `packClusterOverlaps` legt ze naast elkaar. |
| 399 | - De cluster krijgt `fromManual: true`. Vallend cargo dat daarna op |
| 400 | zo'n cluster landt, wordt óók middeled (niet alleen “meegepakt” met |
| 401 | de clustersnelheid). Gewone match-raketten houden de oude regel: |
| 402 | cargo neemt `cluster.vy` over, zonder middelen. Dat pad is |
| 403 | onveranderd. |
| 404 | - De spronghoogte van de worp wordt bij lancering bewaard als |
| 405 | `manualJumpHeight`, zodat de merge die kan middelen. |
| 406 | |
| 407 | ## t1109 — pakken per rooster-cel, niet per sprite |
| 408 | |
| 409 | - Hit-testing keek naar de afstand tot de simulatie-rechthoek van het |
| 410 | blokje, met een drempel. Visueel staan sprites vaak iets naar binnen |
| 411 | (padding, bounce, scale, tween), en de speler moest precies op de |
| 412 | getekende sprite drukken. |
| 413 | - Nu: de druk wordt een cel `floor(col)`, `floor(y)`. Elke druk binnen |
| 414 | die cel — hoeken, kieren tussen sprites, een visueel verschoven |
| 415 | sprite — pakt het blokje dat die cel inneemt. Dat gebruikt |
| 416 | simulatiecellen, niet de getekende bounds (tweens blijven view-only). |
| 417 | - Staat er geen blokje in die cel (midden in een animatie, y niet |
| 418 | geheel), dan de dichtstbijzijnde sleepbare in dezelfde kolom binnen |
| 419 | een halve tegel (`SNAP_Y = 0,5`). Alleen als de primaire cel leeg is |
| 420 | en de druk dicht bij de rand zit, geldt nog een kleine horizontale |
| 421 | slop naar de buurkolom. Lanceren-door-optrekken blijft. |
| 422 | |
| 423 | ## t1110 — match na landing van een cluster, en grotere vlammen |
| 424 | |
| 425 | - Als een vliegende cluster landt en samen met al liggende blokjes een |
| 426 | geldige rij vormt (3 of meer dezelfde kleur, horizontaal of |
| 427 | verticaal), telt dat als een match en worden het raketten. |
| 428 | - Aanname: grijze raketblokjes hebben geen kleur en doen niet mee aan |
| 429 | een match zolang ze grijs zijn. Gekleurd cargo in de gelande cluster |
| 430 | (SETTLING) is wél matchbaar, meteen bij de landing, ook in een |
| 431 | gemengde rij met al stilliggende blokjes. Zodra de grijze blokjes |
| 432 | recoloren en de groep wordt losgelaten, geldt hetzelfde voor die |
| 433 | nieuwe kleuren: een gemengde rij met rustende buren lanceert in |
| 434 | dezelfde tick. |
| 435 | - `findMatchLines` neemt daarom STILL én SETTLING mee, zolang |
| 436 | `color >= 0`. Grijze SETTLING (geen kleur) blijft uitgesloten. |
| 437 | - De vlam onder raketten is 3× zo groot, in lengte én breedte |
| 438 | (`0,85 × 3` tegels). De bovenkant van de vlam blijft op dezelfde |
| 439 | overlap in het blokje; de extra lengte steekt naar beneden uit. |
| 440 | |
| 441 | ## t1111 / t1112 — schot in een cluster, en physics-audit |
| 442 | |
| 443 | - Zie `docs/PHYSICS.md` voor de volledige lijst van gevonden oorzaken |
| 444 | (video `t1111.webm`) en de herschreven regels. |
| 445 | - Schot in een vliegende cluster: de geraakte kolom 1 cel omhoog, het |
| 446 | schot sluit onderaan aan, rooster-uitgelijnd, als lid. Elke volgende |
| 447 | worp hetzelfde. Vliegende clusters zijn één star lichaam (één `y`/`vy`, |
| 448 | gehele offsets). Geen twee blokjes delen een cel of overlappen; |
| 449 | volgorde in een kolom blijft; verdwijnen/dupliceren/kleur veranderen |
| 450 | alleen via de bekende regels (match → grijs, grijs recolor, of |
| 451 | scoren over de bovenkant). |
| 452 | - `?debug` (of `?debug=physics` / `?debug=drag`) zet de |
| 453 | invariant-checker aan en toont overtredingen in de overlay. |
| 454 | |
| 455 | ## t1119 — Offline Strijd, en +50 % spronghoogte |
| 456 | |
| 457 | - **Offline Strijd** is een knop op het hoofdmenu. Het speelt als |
| 458 | multiplayer (zelfde schoten, miss-kans van jouw planeet, zichtbare |
| 459 | tegenstandervelden), maar volledig client-side tegen lokale bots. |
| 460 | Geen server, geen login. |
| 461 | - De speler kiest zelf een planeet (dezelfde kiezer als solo). Elke |
| 462 | bot krijgt altijd een willekeurig veld en een willekeurige planeet |
| 463 | uit de catalogus. |
| 464 | - Progressie, tot de speler verliest: **1 tegenstander voor 1 ronde**; |
| 465 | daarna **N tegenstanders voor N−1 rondes** (N ≥ 2). Dus: ronde 1 → 1 |
| 466 | bot; ronde 2 → 2 bots; ronde 3–4 → 3 bots; ronde 5–7 → 4 bots; enz. |
| 467 | Na een gewonnen ronde (alle bots uitgeschakeld, dezelfde winconditie |
| 468 | als multiplayer) volgt de volgende ronde met een vers veld. Na verlies |
| 469 | een eindscherm met de bereikte ronde (de ronde waarin je verloor) en |
| 470 | terug naar het menu. |
| 471 | - Bot-skill start op **5 %** in ronde 1 en stijgt **1 % per ronde**, |
| 472 | met een plafond van 100 %. De HUD toont ronde, aantal tegenstanders |
| 473 | en skill. |
| 474 | - Skill-mechaniek: elke 0,5 s dobbelt elke levende bot. Als |
| 475 | `roll < skill` mag hij één blokje verticaal in een kolom verplaatsen, |
| 476 | zo ver als nodig is om een match te maken, mits zo'n zet bestaat |
| 477 | (kortste zet, daarna laagste kolom / fromY / toY). Anders doet hij |
| 478 | die tick niets. Bots gehoorzamen verder normale fysica, inclusief |
| 479 | landing-chain, schoten en miss-kans van *hun* planeet. |
| 480 | - Mini's zijn klein (kleiner naarmate er meer bots zijn) en worden |
| 481 | maximaal 10 keer per seconde getekend, zodat veel botvelden op mobiel |
| 482 | blijven lopen. |
| 483 | - **Minimum spronghoogte +50 %** (t1119, alle modes, ook bots): |
| 484 | `baseJumpHeight = 1,5 × FIELD_HEIGHT / jumpsToClear`. Verticale en |
| 485 | extra-blok-bonussen blijven relatief hetzelfde (120 %, +5 %). De |
| 486 | omhoog-snelheid volgt daaruit via de bestaande `launchVelocity` / |
| 487 | `launchDeceleration` (massa / `riseTime` onveranderd). De PHP-server |
| 488 | berekent geen spronghoogte; die fysica leeft in `planet.js`, gedeeld |
| 489 | door solo, online-client en Offline Strijd. De miss-kans-formules |
| 490 | (Power) zijn onveranderd. |
| 491 | |
| 492 | ## t1120 — landing-chain sprongbonus |
| 493 | |
| 494 | - Als een cluster landt en die landing **direct** een match maakt |
| 495 | (gekleurd cargo in dezelfde tick, of na recolor van de grijzen in |
| 496 | dezelfde landing), is die lancering **25 % sterker**. |
| 497 | - Valt het cluster opnieuw en maakt de volgende landing weer een |
| 498 | match, dan komt er weer **+25 %** bij. De keten is **additief**: |
| 499 | stap 1, 2, 3, … → ×1,25, ×1,50, ×1,75 |
| 500 | (`1 + 0,25 × chain`), niet multiplicatief (niet 1,25³). |
| 501 | - De teller hoort bij het cluster. Hij gaat naar 0 als het cluster |
| 502 | verdwijnt (scoort over de bovenkant, of oplost) of landt **zonder** |
| 503 | match. Mid-lucht-matches (keten-herlancering) gebruiken de bestaande |
| 504 | spronghoogte en wijzigen de teller niet. Geldt voor grond- én |
| 505 | stapellandingen, en voor bots. Een klein HUD-label toont |
| 506 | `x2 +50%` (keten en totale bonus). |
| 507 | |
| 508 | ## t1121 — visuele wissel-tween |
| 509 | |
| 510 | - Als twee blokjes van plaats wisselen (spelersleep én bot-zetten), |
| 511 | animeert het **verplaatste** blokje naar zijn nieuwe cel in **100 ms** |
| 512 | met `easeOutCubic` (in het gevraagde bereik 80–120 ms). |
| 513 | - Puur visueel: de simulatie en het rooster zijn meteen bijgewerkt, |
| 514 | de invariant-checker ziet alleen de logische posities. |
| 515 | - Het vastgehouden (gesleepte) blokje volgt de pointer, zonder tween. |
| 516 | - Bij snelle opeenvolgende wissels start een lopende tween opnieuw |
| 517 | vanaf de huidige visuele y, zodat er niet wordt gesnapt. |
| 518 | |
| 519 | ## t1122 / t1124 — alleen de cluster-zweef naar beneden is gehalveerd |
| 520 | |
| 521 | - Tim bedoelde met „daalsnelheid” alleen hoe een cluster na zijn sprong |
| 522 | weer omlaag zweeft (t1124). Nieuwe blokjes die het scherm in vallen |
| 523 | waren al goed en gaan weer op de oude snelheid: |
| 524 | `fallSpeed = FIELD_HEIGHT / fallTime`. Hetzelfde geldt voor |
| 525 | losgelaten of ongesteunde losse blokjes en gevallen cargo, tenzij ze |
| 526 | lid zijn van een dalende cluster (dan zweven ze mee). |
| 527 | - Alleen de post-apex-zweef van een **vliegende cluster** is gehalveerd |
| 528 | (alle modes, inclusief bots): |
| 529 | `clusterFallSpeed = 0,5 × FIELD_HEIGHT / fallTime`. De relatieve |
| 530 | verschillen tussen planeten (omgekeerd evenredig met `fallTime`) |
| 531 | blijven. Een handmatige sprong (omhooggetrokken blokje) daalt op de |
| 532 | volle `fallSpeed`. |
| 533 | - De apex-ease van die clusterzweef duurt nog steeds |
| 534 | `0,15 × fallTime`; `clusterFallAccel` schaalt mee met de gehalveerde |
| 535 | eindsnelheid. Bounce-duur is onveranderd (`0,12 × fallTime`). |
| 536 | Omhoog-lancering is onveranderd, behalve de aparte +50 % spronghoogte |
| 537 | van t1119. `fallTime` in de catalogus en in de Power-formule blijft |
| 538 | hetzelfde getal (1–5). |
| 539 | |
| 540 | ## t1123 — rode puls bij volle kolommen |
| 541 | |
| 542 | - Een kolom die **minstens 10 van de 13 rijen** gevuld heeft (net |
| 543 | boven 70 %) pulst rood, als een vloeiende sinus-alpha (ongeveer |
| 544 | 0,55 Hz, alpha 0,16–0,44) **achter** de blokjes. |
| 545 | - Geteld worden alleen rustende blokjes: `still`, `settling` en |
| 546 | `locked`. **Vliegende, vallende en handmatig gelanceerde** (in de |
| 547 | lucht) blokjes tellen niet mee: die zijn tijdelijk en zouden de |
| 548 | waarschuwing laten flikkeren. |
| 549 | - Geldt voor het veld van de speler én voor tegenstander-/bot-mini's |
| 550 | (zelfde puls-klok). Rendering is goedkoop: tien quads op het |
| 551 | hoofdveld, één `fillRect` per waarschuwingskolom op de mini-canvas. |
| 552 | |
| 553 | ## t1125 — mini's links/rechts en boogjes tussen velden |
| 554 | |
| 555 | - **Breed scherm:** als er aan weerszijden van het geschaalde veld |
| 556 | genoeg marge is voor minstens één mini (eventueel een kleinere) |
| 557 | én de tegels minstens 18 px blijven, staan de tegenstanders |
| 558 | **naast** het veld. Alleen écht smalle of staande vensters |
| 559 | (korter dan 700 px breed, of staand onder 850 px) houden de rij |
| 560 | boven het veld (t1131). Geen harde 960 px-drempel: een kort |
| 561 | liggend venster zoals 1024×532 met 3 bots is dus sides. |
| 562 | - **Plaatsing (t1127, t1133):** mini's worden aan de **buitenrand** |
| 563 | van het scherm verankerd en vullen naar binnen, richting het veld. |
| 564 | Volgorde: 1e links buiten, 2e rechts buiten, 3e links één stap |
| 565 | naar binnen, 4e rechts één stap naar binnen, enzovoort. De |
| 566 | onderste rij sluit aan op de onderkant van het veld. Eerst wordt |
| 567 | een rij horizontaal volgelegd; pas als er aan die kant geen |
| 568 | kolom meer bij past, komt er een extra rij naar boven (weer |
| 569 | beginnend aan de buitenrand). Mini's worden kleiner als gestapelde |
| 570 | rijen anders in de HUD zouden lopen. Het veld gebruikt de volle |
| 571 | hoogte onder de HUD plus de boog-padding (`miniH = 0`). |
| 572 | - **Smal scherm / telefoon:** de bestaande layout blijft: mini's in |
| 573 | een wrappende rij boven het veld. |
| 574 | - **Boogjes** zijn puur visueel. De vluchttijd blijft 1,2 s, gelijk |
| 575 | aan de bestaande aflevering (`deliver_at` / Offline `_deliver`). |
| 576 | We vertragen de gameplay-aflevering níét: een late poll stapt |
| 577 | mid-arc in via de server-`age` (seconden sinds `created`). Als de |
| 578 | vlucht al voorbij is (`age ≥ duration`), tekenen we geen inhaalboog; |
| 579 | de incoming is dan al op schema afgeleverd. |
| 580 | - Vorm: een parabool in schermcoördinaten, |
| 581 | `x = lerp`, `y = lerp − 4·h·t·(1−t)` (y groeit naar beneden). |
| 582 | Booghoogte `h` is 0,28 × afstand, geklemd tussen 48 en 220 px, |
| 583 | met ease-in-out-cubic. Hits van vijand→speler schalen van mini-tegel |
| 584 | naar volle tegel; speler→vijand andersom; vijand→vijand blijven |
| 585 | klein. Missers hergebruiken de bestaande fade-en-wegvlieg-animatie; |
| 586 | vijand-missers starten kleiner (mini-schaal). |
| 587 | - Vijand→vijand (bot-bot of remote-remote) worden in `#flights-back` |
| 588 | getekend (z-index 5, onder `#flights` z-index 6). Een CSS |
| 589 | `clip-path` spaart het rechthoek van het spelersveld uit, zodat |
| 590 | die blokjes achter het veld langs gaan, niet ervoor. Ze blijven |
| 591 | zichtbaar in de zijmarges. |
| 592 | - Online ziet elke client alle recente schoten via `shot_flights` |
| 593 | op de poll (`from_id`, `target_id`, `miss`, `age`, |
| 594 | `flight_duration`). Eigen `shot_results` blijven bestaan; de |
| 595 | client de-dupliceert op id. Extra velden zijn backward compatible. |
| 596 | - Performance: alleen CSS-transforms, één tick per frame, beelden |
| 597 | verdwijnen na 1,2 s. Geen pooling nodig voor tientallen bots. |
| 598 | |
| 599 | ## t1126 — boogje eindigt in de kolom waar het blok verschijnt |
| 600 | |
| 601 | - De landingskolom (`land_col`) wordt gekozen **bij het begin van de |
| 602 | vlucht**, niet pas bij aflevering, en dezelfde waarde geldt voor |
| 603 | het eindpunt van de boog én voor `ingestGarbage`. |
| 604 | - Offline: bij het afvuren kiest het doel-veld een open kolom |
| 605 | (`pickGarbageColumn`); die zit op het flight-resultaat en op de |
| 606 | pending delivery. |
| 607 | - Online: de server kiest `land_col` (0–9) bij `recordShots`, slaat |
| 608 | het op bij het schot, en stuurt het mee in `shot_results`, |
| 609 | `shot_flights` en `incoming`. Een late poll of mid-arc (`age`) |
| 610 | ziet dus dezelfde kolom. De client onthoudt `land_col` ook zelf |
| 611 | (`_pendingLandCol`) als vangnet. |
| 612 | - Als de gekozen kolom bij aflevering niet meer open is (vol of |
| 613 | vergrendeld in de 1,2 s vliegtijd), valt `ingestGarbage` terug op |
| 614 | een andere open kolom. Dat is zeldzaam; dan kan de boog van de |
| 615 | echte kolom afwijken. |
| 616 | - Speler→vijand en vijand→vijand richten óók op `land_col`: het |
| 617 | eindpunt is de bovenkant van die kolom op de mini van het doel |
| 618 | (makkelijk, zelfde veld). |
| 619 | |
| 620 | ## t1128 — vijand↔speler-boogjes gaan om het veld heen |
| 621 | |
| 622 | - Boogjes tussen een vijand en het veld van de speler (beide |
| 623 | richtingen) mogen **niet over het binnenveld** bewegen. Het pad |
| 624 | gaat eerst omhoog aan de buitenkant, dan over de bovenrand, en |
| 625 | buigt pas daar de doelkolom in. Het eindpunt blijft de bovenkant |
| 626 | van `land_col`. |
| 627 | - Als begin- en eindpunt al boven de bovenrand liggen (smalle |
| 628 | layout, mini's boven het veld) is een gewone parabool genoeg: |
| 629 | die blijft vanzelf boven het veld. |
| 630 | - Vijand→vijand blijft een kleine parabool **achter** het veld |
| 631 | (`#flights-back` + clip-path), onveranderd. |
| 632 | |
| 633 | ## t1129 — padding boven het veld in de brede weergave |
| 634 | |
| 635 | - Alleen in de **brede** (sides) layout krijgt het veld extra ruimte |
| 636 | bovenin (`ARC_TOP_PAD` = 100 px tussen HUD en veld, tegels iets |
| 637 | kleiner indien nodig) zodat de omweg-boogjes over de bovenrand |
| 638 | passen. Smal en mobiel blijven onveranderd (mini's boven het veld, |
| 639 | geen extra pad). |
| 640 | |
| 641 | ## t1130 — raak-schoten zijn visueel grijs |
| 642 | |
| 643 | - Wat de ontvanger binnenkrijgt is altijd een grijs vuilblok |
| 644 | (`ingestGarbage`). Daarom worden **alle raak-schoten** — vijand→ |
| 645 | speler, speler→vijand en vijand→vijand — als grijze blokjes |
| 646 | getekend (`images/block-gray.png`), niet in de kleur van de |
| 647 | schutter. Zo komt het boogje overeen met wat er landt. |
| 648 | - Missers houden de kleur van de schutter: daar wordt niets |
| 649 | ontvangen, het blokje vliegt weg en vervaagt zoals voorheen. |
| 650 | |
| 651 | ## t1127 / t1131 / t1133 — mini's van de rand naar binnen, horizontaal eerst |
| 652 | |
| 653 | - Tim wilde eerst horizontaal plaatsen en pas verticaal stapelen als |
| 654 | de marge vol is (t1127), en de mini's „uitgelijnd van ons veld |
| 655 | weg” (t1131 / t1133): verankerd aan de **buitenrand** van het |
| 656 | scherm, elke volgende op die kant één stap verder naar het veld |
| 657 | toe. Dat is het omgekeerde van „eerst tegen het veld, dan naar |
| 658 | buiten”. |
| 659 | - Bij 8 tegenstanders past één rij op 1400×900 en 1920×1080; op een |
| 660 | smaller breed scherm (bijv. 1280×900) wrapt de vierde per kant |
| 661 | naar een rij daarboven, opnieuw aan de buitenrand. |
| 662 | - De drempel voor sides is versoepeld (t1131): zodra er een mini |
| 663 | naast het veld past — ook een kleinere — kiezen we sides, ook in |
| 664 | een kort liggend venster (1024×532, 3 bots). Boogjes vertrekken |
| 665 | vanaf de **bovenkant** van de mini, gaan omhoog en in een ruime |
| 666 | boog over de bovenrand naar de landingskolom, niet over de mini's |
| 667 | of over het binnenveld. |
| 668 | |
| 669 | ## t1134 — soepele boogjes, en écht uit het veld vliegen |
| 670 | |
| 671 | - De oude polyline met hoekpunten (omhoog, horizontaal, omlaag) is |
| 672 | vervangen door een **C¹-ketting van kubische Béziers**: omhoog |
| 673 | uit de lanceerkolom (of langs de buitenkant), een vloeiende |
| 674 | kwart-draai, een rechte kruising boven het veld, en een vloeiende |
| 675 | duik de landingskolom in. Raaklijnen en snelheid sluiten aan de |
| 676 | gewrichten naadloos aan — geen zichtbare hoeken, geen ruk in het |
| 677 | tempo. `easeInOutCubic` (snelheid 0 aan begin en eind) is voor |
| 678 | raak-schoten verdwenen; `smoothParam` houdt aan de uiteinden een |
| 679 | niet-nul snelheid. |
| 680 | - Speler↔vijand gaat nog steeds om het veld heen en mag alleen de |
| 681 | **lanceer- en landingskolom** gebruiken, niet het binnenveld. |
| 682 | Vijand→vijand blijft een kleine soepele boog achter het veld. |
| 683 | - Een uitgaand schot start op de **echte exit-pose** van de raket |
| 684 | (zelfde positie en formaat, `fieldToViewport` met het |
| 685 | +0,5-tegel-midden, `y ≥ 13`). De boog gaat vanaf daar omhoog |
| 686 | verder, zonder pop-in boven het veld. (De vroege overname bij |
| 687 | `y ≳ 11,6` is in t1137 teruggedraaid.) |
| 688 | |
| 689 | ## t1135 — soepel het veld invliegen, naadloze overdracht |
| 690 | |
| 691 | - De boog duikt **de landingskolom in** en eindigt op de |
| 692 | spawn-pose van `ingestGarbage`: `y = 13` (een halve tegel boven |
| 693 | de canvasrand), volle tegelgrootte, raaklijn recht naar beneden. |
| 694 | De eindsnelheid is afgestemd op `fallSpeed` van de planeet, zodat |
| 695 | het vallende grijze blok dezelfde positie, grootte en snelheid |
| 696 | overneemt — geen pop-in aan de bovenkant. Offline levert |
| 697 | `battle.tick` het blok eerst af en verwijdert daarna de vlucht |
| 698 | (één frame overlap op dezelfde pose). |
| 699 | - Aankomst bij een vijand-mini gaat het blokje iets **de mini in** |
| 700 | (`y = 12` in de landingskolom, op mini-formaat). Er is geen live |
| 701 | vallende sprite op de mini; het volgende snapshot toont het cel. |
| 702 | |
| 703 | ## t1136 — multiplayer ziet er hetzelfde uit als Offline Strijd |
| 704 | |
| 705 | - Online en offline delen dezelfde presentatie: `MiniLayout` |
| 706 | (buitenrand, horizontaal eerst, onder uitgelijnd, `ARC_TOP_PAD`), |
| 707 | `Online.spawnFlights` / `tickFlights` (C¹-bogen om het veld, |
| 708 | `land_col`, grijze raak-schoten, uitvliegen vanuit de cel, |
| 709 | invliegen naar de spawn-pose, vijand→vijand achter het veld) en |
| 710 | dezelfde startregel voor de lokale raket (pas bij het echte |
| 711 | schot, `y ≥ 13`). |
| 712 | - De server bewaart nu ook de **lanceercel** (`from_col`, `from_y`) |
| 713 | en stuurt die mee op `shot_results` en `shot_flights`, zodat een |
| 714 | andere client het blokje uit de juiste cel van de mini ziet |
| 715 | vertrekken (niet vanaf een vast punt boven de mini). Zonder |
| 716 | lokale `startX` (typisch voor een remote poll) gebruikt |
| 717 | `spawnFlights` die `col`/`y`. |
| 718 | - Geverifieerd met Playwright: lokale PHP-server, test-auth, |
| 719 | twee Playwright-clients in een echte lobby (lokale PHP-server met test-auth), daarna `shot_flights` via |
| 720 | `Online._handleTransitions` (het echte poll-pad) op 1920×1080 |
| 721 | en 1024×532, plus dezelfde bogen in Offline Strijd (early/mid/ |
| 722 | late en een korte webm). |
| 723 | |
| 724 | ## t1137 — pas een boogje als het blok echt het veld verlaat |
| 725 | |
| 726 | - Tim zag raketten die net niet hoog genoeg gingen een boogje |
| 727 | maken, het veld uit en weer in, omdat de visuele overname al bij |
| 728 | `y ≳ 11,6` (met `vy > 0`) begon. Een raket die daar piekt en |
| 729 | terugvalt is nog van het veld en mag geen boog krijgen. |
| 730 | - Een vlucht start **alleen** bij het echte schot, hetzelfde moment |
| 731 | als `cullOffTop`: `y ≥ 13` (hoogte van het veld). Dat geldt voor |
| 732 | het spelersveld, vijand-mini's, offline en online. |
| 733 | `Online.hasLeftTheField` en `previewExit` weigeren alles daaronder. |
| 734 | De overdracht blijft naadloos: start op de exit-pose, volle |
| 735 | grootte, raaklijn omhoog, daarna de soepele boog naar het doel. |
| 736 | - Een raket die onder de rand piekt produceert geen `outgoingShot` |
| 737 | en geen vlucht; een raket die `y ≥ 13` kruist precies één schot |
| 738 | en één vlucht, beginnend op die exit-pose. |
| 739 | |
| 740 | ## t1138 — één grote, vloeiende ballistische boog |
| 741 | |
| 742 | - Tim vond de bogen na t1134–t1137 al beter, maar wilde ze nóg |
| 743 | vloeiender: geen ketting van stukjes (kwart-draai, rechte |
| 744 | kruising op de top, duik) maar één grote, ronde, doorlopende |
| 745 | curve, als een ballistische parabool. |
| 746 | - Speler↔vijand is nu **één enkele Bézier van graad 7** (één |
| 747 | polynoom, dus C^∞ op (0, 1)): start op de exit-pose (`y = 13`, |
| 748 | raaklijn recht omhoog), een ruime ronde kroon **boven** het veld |
| 749 | (mag hoger — we gebruiken de top-padding ruim, apex zo'n 150 px |
| 750 | boven de veldrand), en een duik de `land_col` in, recht naar |
| 751 | beneden, met een eindsnelheid afgestemd op `fallSpeed`. Het |
| 752 | binnenveld wordt nooit gekruist: horizontaal verkeer zit op de |
| 753 | top, verticaal alleen in de lanceer-/landingskolom of buiten het |
| 754 | veld. Geen rechte cruise, geen zichtbare knikken; de kromming |
| 755 | verandert geleidelijk. De parameter loopt over de **booglengte** |
| 756 | (arc-length) met een zachte Hermite-easing, zodat de snelheid |
| 757 | langs het pad glad is en de aankomst bij `fallSpeed` past. |
| 758 | - Vijand→vijand krijgt dezelfde soepele parabool, getekend achter |
| 759 | het veld (`#flights-back`, clip-path). De startregel van t1137 |
| 760 | (`y ≥ 13`) en de grijze raak-schoten blijven ongewijzigd. |
| 761 | - Unit-tests toetsen krommingscontinuïteit, maximale |
| 762 | krommingsverandering, geen lange rechte middenstukken, verticale |
| 763 | uiteinden, corridors, en de fallSpeed-overdracht. Playwright |
| 764 | legt early/mid/late vast op 1024×532 en 1920×1080, plus een |
| 765 | webm van beide formaten. |
| 766 | |
| 767 | |
| 768 | ## t1139 — Planeetontwerper |
| 769 | |
| 770 | - De ontwerper is alleen beschikbaar op het hoofdmenu, en alleen als |
| 771 | je bent ingelogd. Tot de live OAuth-callback en het CI-geheim |
| 772 | `auth_client_secret` zijn ingericht, is dat op productie onzichtbaar. |
| 773 | Lokaal kun je inloggen met `auth.php?test=1` (of `test=2`). |
| 774 | - Levenslange punten staan in het server-profiel (`profiles`). Alleen |
| 775 | ingelogde spellen tellen mee. Bots leveren geen punten op. |
| 776 | - **Spelen** (solo): de score aan het einde van het spel. |
| 777 | - **Offline Strijd**: de score van **elke ronde**, gewonnen of |
| 778 | verloren, omdat de score per ronde opnieuw begint. |
| 779 | - **Online**: de server kent de score via de poll; punten worden |
| 780 | toegekend bij uitschakeling of als de lobby klaar is, één keer per |
| 781 | `online:{lobbyId}:{userId}`. De client kan hier geen punten |
| 782 | insturen. |
| 783 | - Anti-cheat voor solo/offline: `play_begin` geeft een eenmalig token |
| 784 | (geldig 6 uur). `play_finish` klempt de score op 0–10000, weigert |
| 785 | een positieve score als het spel korter dan 3 seconden duurde, en |
| 786 | laat maximaal 4 punten per seconde door. Herhaalde finishes van |
| 787 | hetzelfde token zijn een no-op. Overduidelijk valsspelen wordt |
| 788 | geklemd, niet keihard verboden, zodat een trage verbinding geen |
| 789 | eerlijke score weggooit. |
| 790 | - Het blokjesregister (`server/lib/blocks.json`) is append-only: de |
| 791 | volgorde ligt nu vast. Eerst Terra's vijf (gratis), daarna 43 nieuwe |
| 792 | icoontjes (eerste, Fehu, op 500 punten; daarna telkens 14,5 % meer, |
| 793 | afgerond en strikt stijgend — de laatste icoon zit rond de 147 000 |
| 794 | punten), daarna de 55 kleuren van de officiële niet-Terra-planeten |
| 795 | als lange staart (de laatste zit in de honderden miljoenen). Punten |
| 796 | zijn een **eis**, geen uitgave. Officiële planeten blijven hun eigen |
| 797 | blokjes gebruiken zonder ontgrendeling; ontgrendelen is alleen voor |
| 798 | de ontwerper. |
| 799 | - Een speler mag tot 30 eigen planeten hebben. Id's zijn `c_` plus |
| 800 | 16 hex-tekens. Namen (planeet en volk) zijn 1–32 tekens, zonder |
| 801 | tags. De vijf blokjes moeten verschillend en ontgrendeld zijn. |
| 802 | - Nieuwe blokjes-plaatjes staan in `build/images/block-*.png`, 64×64, |
| 803 | in dezelfde stijl als Terra (gekleurde silhouet, donkere omtrek, |
| 804 | highlight, slagschaduw). Gegenereerd door |
| 805 | `scripts/gen_unlock_blocks.py`. |
| 806 | |
| 807 | ## t1140 — Eigen planeten in elke modus |
| 808 | |
| 809 | - In Spelen, Offline Strijd en Online Spelen toont de planeetkiezer |
| 810 | naast de officiële catalogus ook **je eigen** ontworpen planeten |
| 811 | (badge "Eigen"). Planeten van anderen staan daar niet in. |
| 812 | - Voor Online stuurt de client alleen het planeet-id. De server |
| 813 | controleert eigendom, legt een **snapshot** (`planet_json`) vast bij |
| 814 | kiezen/aanmaken/joinen, en stuurt de volledige configuratie |
| 815 | (variabelen, kleuren, `miss_chance`) mee in de lobby. Tegenstanders |
| 816 | onthouden die snapshot om fysica, miss-kans en sprites te simuleren; |
| 817 | een latere wijziging of verwijdering verandert een lopend spel niet. |
| 818 | |
| 819 | |
| 820 | ## t1141 — taalkeuze (i18n) |
| 821 | |
| 822 | - De standaardtaal is **Engels**, ook als de browser op Nederlands staat. |
| 823 | Er is geen automatische detectie van de browsertaal. |
| 824 | - De keuze staat in `localStorage` (`meteors-locale`) en in een cookie |
| 825 | (voor de inlogpagina’s). Ben je ingelogd, dan wordt ze ook in het |
| 826 | serverprofiel bewaard (`set_locale`). Bij inloggen wint de |
| 827 | profieltaal; is die nog leeg, dan wordt de lokale keuze naar de |
| 828 | server geschreven. |
| 829 | - Vlaggen zijn lokale SVG’s in `build/images/flags/` (geen emoji). |
| 830 | Engels gebruikt de vlag van het Verenigd Koninkrijk, Chinees die van |
| 831 | de Volksrepubliek (vereenvoudigd Chinees), Koreaans die van |
| 832 | Zuid-Korea. |
| 833 | - Officiële planeetnamen (Terra, Aurel, …) blijven eigennaam; |
| 834 | bevolkingsnamen en blokjesnamen zijn vertaald. Zelfgekozen namen van |
| 835 | eigen planeten blijven ongewijzigd. |
| 836 | - Serverfouten blijven in het Nederlands in de API (bestaande tests); |
| 837 | de client vertaalt bekende meldingen naar de actieve taal. |
| 838 | - CJK-tekst gebruikt systeemfonts (Hiragino, PingFang, YaHei, Malgun |
| 839 | Gothic, Noto Sans CJK, …) als fallback. Knoppen mogen wrappen zodat |
| 840 | langere vertalingen (Duits, Nederlands) niet over de rand lopen. |
| 841 | |
| 842 | |
| 843 | ## t1143 — leeg speelscherm na inloggen |
| 844 | |
| 845 | - De live-screenshot (HUD “PUNTEN 0” en “Terra”, geen veld, wel sterren) |
| 846 | kwam doordat `new Scene` “WebGL is not supported” gooide *nadat* de |
| 847 | HUD al zichtbaar was met de standaard-HTML (“Terra”, score 0). De |
| 848 | Scene-constructor plaatst eerst een transparant canvas en initialises |
| 849 | daarna WebGL; bij een blocklist blijft dat canvas leeg en schijnt het |
| 850 | sterrenveld erdoorheen. In de page-console staat die fout, in het |
| 851 | Chrome-GPU-log “WebGL1 blocklisted”. |
| 852 | - Dat is geen fout in de planeetkeuze, `?online=1`, i18n of `play_begin`. |
| 853 | Dezelfde flow (inloggen, Back, Nederlands, eigen planeet “Testplaneet |
| 854 | Ada”, Spelen) toont het veld en de juiste HUD-naam zodra WebGL |
| 855 | beschikbaar is (o.a. met SwiftShader). Uitgelogd solo op live ook. |
| 856 | - `startPlay` toont de HUD nu pas ná een geslaagde scene, vangt een |
| 857 | WebGL-fout, ruimt wees-canvasses op en toont een melding op het menu. |
| 858 | - Solo-game-over roept `play_finish` aan; verdiende punten gaan bij een |
| 859 | ingelogde speler naar het levenslange totaal (anti-cheat: o.a. min. 3 s |
| 860 | bij score > 0, max. 4 punten/s). |
| 861 | |
| 862 | |
| 863 | ## t1144 — bots kijken 1 of 2 zetten vooruit |
| 864 | |
| 865 | - Alleen in **Offline Strijd**. Online is PvP: er zijn geen server-side |
| 866 | bots, en die zijn ook niet toegevoegd. |
| 867 | - Als een bot zijn kansrol haalt (`roll < skill`) en er ligt al een |
| 868 | match op het veld, doet hij niets (zoals in t1119) en vergeet hij |
| 869 | een eventueel onthouden plan. |
| 870 | - Anders zoekt hij eerst een **onmiddellijke** match: dezelfde kortste |
| 871 | verticale zet als in t1119 (daarna laagste kolom / fromY / toY). Die |
| 872 | gaat altijd voor, ongeacht de skill. |
| 873 | - Is er geen onmiddellijke match, dan kan hij tot **diepte 2** zoeken: |
| 874 | een eerste verschuiving die zelf geen match maakt, maar een tweede |
| 875 | mogelijk maakt. Hij voert alleen de eerste zet van het beste plan uit |
| 876 | en onthoudt de rest (`bot.plan`). |
| 877 | - Het **beste** plan is dat met de kleinste som van de twee afstanden, |
| 878 | dan de kortste eerste zet, daarna dezelfde kolom/fromY/toY-volgorde |
| 879 | als t1119 (eerst voor de eerste zet, dan voor de tweede). |
| 880 | - Op de volgende geslaagde rol volgt hij de onthouden tweede zet als |
| 881 | die nog legaal is en (als laatste stap) nog een match maakt — ook |
| 882 | als de skill dan te laag is om een *nieuw* plan te starten. Een |
| 883 | gevolgde zet vereist nog steeds een gewonnen rol die tick. Is het |
| 884 | plan ongeldig geworden, dan plant hij opnieuw (eerst onmiddellijk, |
| 885 | dan eventueel een nieuwe setup). |
| 886 | - De kans om een **nieuw** 2-stapsplan te zoeken hangt van de skill af: |
| 887 | **0 % bij skill ≤ 10 %** (rondes 1–6), daarna lineair naar **100 % |
| 888 | bij skill ≥ 40 %** (ronde 36 en verder). Zo blijven vroege rondes |
| 889 | makkelijk en worden late bots slimmer. |
| 890 | - De zoektocht blijft goedkoop op een veld van 10×13: alleen legale |
| 891 | verticale zetten binnen aaneengesloten segmenten (geen sprong over |
| 892 | een gat, geen vergrendelde kolom, geen enkel blokje alleen), |
| 893 | apply+undo op één rooster, korte zetten eerst, stop bij het eerste |
| 894 | 1+1-plan (dat is door de sorteervolgorde al de winnaar), en een |
| 895 | plafond van **4000** bord-evaluaties per tick. Als dat plafond wordt |
| 896 | bereikt kan een zeldzame langere setup worden gemist. |
| 897 | |
| 898 | |
| 899 | ## t1173 / t1174 — puntenscherm na een spel of ronde |
| 900 | |
| 901 | - Alleen voor **ingelogde** spelers. Uitgelogd blijft alles zoals het |
| 902 | was (game-over-overlay in solo, de oude vertraging tussen |
| 903 | Offline-rondes, podium in Online). |
| 904 | - **Gewonnen of verloren:** Spelen (solo) eindigt altijd doordat je |
| 905 | veld vol loopt, dus daar staat “You lost...”. Offline Strijd: een |
| 906 | gewonnen ronde (alle bots uit) → “You won!”, verlies → “You lost...”. |
| 907 | Online: plek 1 → “You won!”, anders “You lost...”. Teksten staan in |
| 908 | alle tien talen (`reward.won` / `reward.lost`). |
| 909 | - **Volgorde:** de titel staat 1 s gecentreerd en schuift dan in 0,6 s |
| 910 | naar boven. Pas als de server het nieuwe totaal heeft bevestigd |
| 911 | begint het tellen: het getal onderaan start op het totaal vóór de |
| 912 | ronde en elk aankomend blokje telt er 1 bij op, tot het nieuwe |
| 913 | totaal. Bij 0 verdiende punten staat het getal kort (1,5 s) in beeld |
| 914 | zonder blokjes. Aan het eind blijft het eindtotaal 1,5 s staan. |
| 915 | - **Tempo (t1174, i.p.v. een overslaanknop; aangepast in t1175, t1177 en t1178):** |
| 916 | `rate = 15 + 10·t` blokjes/s (`RATE0 = 15`, `ACCEL = 10` in |
| 917 | `src/reward.js`; t1174 had 5 + 1·t, t1175 5 + 3·t, t1177 10 + 5·t). |
| 918 | Na t seconden zijn er `15t + 10t²/2` vertrokken; blokje i vertrekt op |
| 919 | `t = (−15 + √(225 + 20i)) / 10`. Het laatste blokje vertrekt bij 253 |
| 920 | punten na ≈ 5,8 s, bij 800 na ≈ 11,2 s en bij 2000 na ≈ 18,6 s, plus |
| 921 | 0,7 s vlucht. |
| 922 | - **Prestaties (t1178):** aan het eind van 2000 punten gaan er ~200 |
| 923 | blokjes/s weg en zijn er ~140 tegelijk in de lucht. Gemeten in |
| 924 | headless Chrome: desktop 1280×800 ~59 fps; mobiel 390×844 @3× met |
| 925 | 4× CPU-vertraging ~59 fps (p95 16,7 ms), ook met een lopend speelveld |
| 926 | erachter. Eén 2D-canvas, geen DOM-element per blokje, dus geen extra |
| 927 | begrenzing nodig. Er is **geen** overslaan-knop en |
| 928 | geen sneltoets om meteen naar het eindtotaal te springen. Wel mag je |
| 929 | tijdens die laatste 1,5 s (eindtotaal staat al) tikken/klikken of |
| 930 | Spatie/Enter drukken om meteen door te gaan. |
| 931 | - **Bron van de getallen:** solo en Offline gebruiken het antwoord van |
| 932 | `play_finish`: nieuw totaal = `lifetime_points`, start = |
| 933 | `lifetime_points − awarded`. Online is er geen `play_finish`; de |
| 934 | server kent de punten zelf toe bij uitschakeling/einde. Het start- |
| 935 | getal is het profieltotaal bij de start van de wedstrijd, het |
| 936 | eindgetal het totaal uit de poll die de wedstrijd als afgelopen meldt |
| 937 | (de toekenning gebeurt in dezelfde transactie, vóór het antwoord). |
| 938 | Antwoordt de server niet binnen 8 s of met een fout, dan wordt niets |
| 939 | geteld en gaat het scherm na 1,5 s verder. |
| 940 | - **Blokjes:** willekeurig gekozen uit de vijf blokjes (plaatjes) van |
| 941 | de planeet waarmee je die ronde speelde, ook bij eigen planeten. Ze |
| 942 | starten op een willekeurige x net boven het scherm en volgen een |
| 943 | kwadratische boog met een willekeurig controlepunt naar het getal. |
| 944 | - **Daarna:** solo → menu; Offline gewonnen → volgende ronde; Offline |
| 945 | verloren → het bestaande resultaatscherm; Online → de lobby. Omdat |
| 946 | de server de lobby na 5 s podium al terugzet, wacht de client met |
| 947 | teruggaan tot het puntenscherm klaar is. Is de lobby dan nog niet |
| 948 | terug, dan zie je de rest van het podium. |
| 949 | - **Techniek:** een DOM-overlay met één 2D-canvas voor de vliegende |
| 950 | blokjes (geen extra WebGL-context), ~20 tegelijk in beeld, getekend |
| 951 | via `requestAnimationFrame` (frames worden afgekapt op 0,1 s, dus een |
| 952 | achtergrondtab springt niet). Werkt op desktop en mobiel. Bij |
| 953 | `prefers-reduced-motion` vliegen er geen blokjes en springt de titel |
| 954 | zonder animatie naar boven; het getal telt in hetzelfde tempo op. |