BlueGit

projects-timfalken-com meteors

docs: 1:1 drag, spontaneous rockets and inverted Power

Record the cause of the drag bug (accumulated deltas with a 0.25-tile
threshold, plus a fragile canvas-pixel mapping), the new 1:1 target-row
rule, spontaneous rockets on flying clusters, and the display-only
Power invert (1 − miss / 0.60).

timfa Grok Bot · pushed by timfa

Authored 2026-11-13 · 4 days ago

Hash
5c6b9de214f13bb9573c49c69af57492814bcf37
Parent
86b98e53
2 files changed +61 −15
README.md +11 −6
@@ -80,12 +80,17 @@ is een planeet met een volk, vijf eigen kleuren/vormen, en drie natuurwetten:
80 80 - luchtweerstand — hoe snel blokjes weer vallen (`d`)
81 81 - massa — hoe snel de sprong omhoog gaat (`F`, newton)
82 82
83 Power is het gemiddelde van die drie, als percentage. Hoe hoger de Power,
84 hoe kleiner de kans dat een afgeschoten blokje een andere speler mist.
85 In een online wedstrijd telt **jouw** planeet voor de blokjes die jij
86 verstuurt. De twaalf werelden en hun getallen staan in
87 `server/lib/planets.json`. De blokplaatjes zijn unieke placeholders
88 (`build/images/block-{planeet}-{kleur}.png`); Tim kan ze zelf vervangen.
83 Die drie waarden bepalen een interne moeilijkheids-Power (0–1). De
84 miss-kans van een afgeschoten blokje is `0,60 − 0,55 × Power` (60 % op
85 het makkelijkste veld, 5 % op het moeilijkste). De **getoonde** Power in
86 de kiezer, de HUD en de lobby is het omgekeerde daarvan:
87 `1 − miss / 0,60` als percentage. 0 % miss is 100 % Power; 60 % miss is
88 0 % Power. Aurel toont 0 %, Terra 44 %, Cinder 92 % (de bodem is 5 %
89 miss, dus niet 100 %). In een online wedstrijd telt **jouw** planeet
90 voor de blokjes die jij verstuurt. De twaalf werelden en hun getallen
91 staan in `server/lib/planets.json`. De blokplaatjes zijn unieke
92 placeholders (`build/images/block-{planeet}-{kleur}.png`); Tim kan ze
93 zelf vervangen.
89 94
90 95 ## Deploy
91 96
@@ -80,12 +80,17 @@ is een planeet met een volk, vijf eigen kleuren/vormen, en drie natuurwetten:
80- luchtweerstand — hoe snel blokjes weer vallen (`d`)
80- luchtweerstand — hoe snel blokjes weer vallen (`d`)
81- massa — hoe snel de sprong omhoog gaat (`F`, newton)
81- massa — hoe snel de sprong omhoog gaat (`F`, newton)
82
82
83Power is het gemiddelde van die drie, als percentage. Hoe hoger de Power,
83Die drie waarden bepalen een interne moeilijkheids-Power (0–1). De
84hoe kleiner de kans dat een afgeschoten blokje een andere speler mist.
84miss-kans van een afgeschoten blokje is `0,60 − 0,55 × Power` (60 % op
85In een online wedstrijd telt **jouw** planeet voor de blokjes die jij
85het makkelijkste veld, 5 % op het moeilijkste). De **getoonde** Power in
86verstuurt. De twaalf werelden en hun getallen staan in
86de kiezer, de HUD en de lobby is het omgekeerde daarvan:
87`server/lib/planets.json`. De blokplaatjes zijn unieke placeholders
87`1 − miss / 0,60` als percentage. 0 % miss is 100 % Power; 60 % miss is
88(`build/images/block-{planeet}-{kleur}.png`); Tim kan ze zelf vervangen.
880 % Power. Aurel toont 0 %, Terra 44 %, Cinder 92 % (de bodem is 5 %
89miss, dus niet 100 %). In een online wedstrijd telt **jouw** planeet
90voor de blokjes die jij verstuurt. De twaalf werelden en hun getallen
91staan in `server/lib/planets.json`. De blokplaatjes zijn unieke
92placeholders (`build/images/block-{planeet}-{kleur}.png`); Tim kan ze
93zelf vervangen.
89
94
90## Deploy
95## Deploy
91
96
docs/ASSUMPTIONS.md +50 −9
@@ -253,22 +253,28 @@ Aanname:
253 253
254 254 - Een veld is een planeet, met een naam voor de planeet en voor het volk.
255 255 De catalogus staat in `server/lib/planets.json` (bron voor JS én PHP) en
256 telt **12** werelden, van makkelijk (Aurel: Power 0 %, 60 % miss) tot
257 moeilijk (Cinder: Power 100 %, 5 % miss). Terra blijft de standaard.
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.
258 259 - Zwaartekracht (`jumpsToClear` 1–4): één sprong haalt `1/jumpsToClear` van
259 260 de veldhoogte. Luchtweerstand (`fallTime` 1–5 s tot de bodem). Massa
260 261 (`riseTime` 0,5–3 s tot de apex). Lage massa en lage luchtweerstand en
261 262 hoge zwaartekracht zijn moeilijker. Bounce-duur en apex-ease schalen al
262 263 met `fallTime` (gebouwd in stage 1).
263 - Power is het gemiddelde van die drie assen, genormaliseerd 0–1, getoond
264 als percentage. Miss-kans = `0,60 − 0,55 × Power` (60 % bij Power 0,
265 5 % bij Power 1). In multiplayer gebruikt de **server** de Power van
266 **jouw** planeet voor de blokjes die jij afschiet (niet de lobby-waarde,
267 niet de planeet van het doel). De client kan dat niet vervalsen.
264 - De interne (gameplay-)Power is het gemiddelde van die drie assen,
265 genormaliseerd 0–1. Miss-kans = `0,60 − 0,55 × Power` (60 % bij 0,
266 5 % bij 1). Dat formule blijft de gameplay: schoten en de server
267 gebruiken hem onveranderd. De **getoonde** Power in kiezer, HUD en
268 lobby is `1 − miss / 0,60` als percentage (0 % miss → 100 % Power,
269 60 % miss → 0 % Power). Dat is alleen weergave (t1105). In
270 multiplayer gebruikt de **server** de gameplay-Power van **jouw**
271 planeet voor de blokjes die jij afschiet (niet de lobby-waarde, niet
272 de planeet van het doel). De client kan dat niet vervalsen.
268 273 - De vier getallen op de kiezers en in de HUD: `g` als
269 274 zwaartekrachtsconstante (m/s²), `d` als luchtdichtheid, `F` in newton,
270 Power als percentage. Alleen de getallen, zonder uitleg. Verticale match
271 van 3 = 120 % sprong, +5 % per extra blokje (al gebouwd, nergens uitgelegd).
275 getoonde Power als percentage. Alleen de getallen, zonder uitleg.
276 Verticale match van 3 = 120 % sprong, +5 % per extra blokje (al
277 gebouwd, nergens uitgelegd).
272 278 - Elk veld heeft een eigen set van 5 kleuren, elk met een uniek vormpje
273 279 en een uniek placeholder-PNG (`build/images/block-{planeet}-{kleur}.png`).
274 280 Tim kan die bestanden zelf vervangen; de namen blijven gelijk. Te
@@ -277,3 +283,38 @@ Aanname:
277 283 lobby (iedereen kiest zelf; zichtbaar voor de anderen). De keuze wordt
278 284 onthouden in `localStorage` (`meteors-planet`). Na de start van een
279 285 wedstrijd kun je niet meer wisselen.
286
287 ## t1104 — 1:1-slepen en spontane raketten
288
289 - Oorzaak van de sleepbug: `moveDrag` werkte met een opgetelde
290 pointer-delta en een drempel van `SWAP_DISTANCE` (0,25 tegel). Een
291 klein stukje sleep deed daardoor al een hele tegel, en één grote
292 `pointermove` (typisch op touch) kon de rest van de kolom aflopen —
293 precies “meestal gelijk helemaal omlaag of omhoog”. De doelrij was
294 niet de rij onder de vinger, dus als de vinger stopte kon het blokje
295 al aan de top of de bodem zitten. Daarnaast liep de pointer-mapping
296 via `canvas.width` / `app.tile`, wat deltas zou vermenigvuldigen met
297 de devicePixelRatio als de backing-store en de CSS-maat ooit
298 uit elkaar lopen.
299 - Nu: de doelrij is `floor(pointerY)`, geklemd op de still-stapel van
300 de kolom. `swapToward` wisselt stap voor stap met elke buur, en stopt
301 precies daar. Als de pointer stilstaat, beweegt er niets meer.
302 Optrekken-boven-de-top om te lanceren blijft. Coordinaten komen uit
303 `getBoundingClientRect` en de veldgrootte (10×13), zonder
304 canvas-backing of `app.tile`.
305 - Spontane rijen (na vallen, settle/recolor, cargo-attach op een
306 vliegende cluster, cluster-merge) worden altijd raketten, net als
307 wanneer de speler ze maakt. In een al vliegende cluster geeft dat
308 een extra sprong vanaf de huidige positie (`checkChainRelaunch`,
309 dezelfde hoogte als bij een player-push). Mid-air hangend cargo na
310 recolor valt nog steeds vanuit stilstand (t1102), geen launch.
311
312 ## t1105 — getoonde Power omgekeerd
313
314 - Alleen de weergave. Gameplay `power()` en `missChance()` zijn
315 onveranderd (`miss = 0,60 − 0,55 × power`). Getoonde Power =
316 `1 − missChance / 0,60`, afgerond als percentage, in JS
317 (`Planet.displayValues` / `formatStats`) en PHP (`Planets::displayValues`),
318 dus op de planeetkiezer, in de HUD en in de lobby. 0 % miss is 100 %
319 Power; Aurel 0 %, Terra 44 %, Cinder 92 %.
320
@@ -253,22 +253,28 @@ Aanname:
253
253
254- Een veld is een planeet, met een naam voor de planeet en voor het volk.
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
255 De catalogus staat in `server/lib/planets.json` (bron voor JS én PHP) en
256 telt **12** werelden, van makkelijk (Aurel: Power 0 %, 60 % miss) tot
256 telt **12** werelden, van makkelijk (Aurel: gameplay-Power 0, 60 % miss,
257 moeilijk (Cinder: Power 100 %, 5 % miss). Terra blijft de standaard.
257 getoonde Power 0 %) tot moeilijk (Cinder: gameplay-Power 1, 5 % miss,
258 getoonde Power 92 %). Terra (44 % getoonde Power) blijft de standaard.
258- Zwaartekracht (`jumpsToClear` 1–4): één sprong haalt `1/jumpsToClear` van
259- Zwaartekracht (`jumpsToClear` 1–4): één sprong haalt `1/jumpsToClear` van
259 de veldhoogte. Luchtweerstand (`fallTime` 1–5 s tot de bodem). Massa
260 de veldhoogte. Luchtweerstand (`fallTime` 1–5 s tot de bodem). Massa
260 (`riseTime` 0,5–3 s tot de apex). Lage massa en lage luchtweerstand en
261 (`riseTime` 0,5–3 s tot de apex). Lage massa en lage luchtweerstand en
261 hoge zwaartekracht zijn moeilijker. Bounce-duur en apex-ease schalen al
262 hoge zwaartekracht zijn moeilijker. Bounce-duur en apex-ease schalen al
262 met `fallTime` (gebouwd in stage 1).
263 met `fallTime` (gebouwd in stage 1).
263- Power is het gemiddelde van die drie assen, genormaliseerd 0–1, getoond
264- De interne (gameplay-)Power is het gemiddelde van die drie assen,
264 als percentage. Miss-kans = `0,60 − 0,55 × Power` (60 % bij Power 0,
265 genormaliseerd 0–1. Miss-kans = `0,60 − 0,55 × Power` (60 % bij 0,
265 5 % bij Power 1). In multiplayer gebruikt de **server** de Power van
266 5 % bij 1). Dat formule blijft de gameplay: schoten en de server
266 **jouw** planeet voor de blokjes die jij afschiet (niet de lobby-waarde,
267 gebruiken hem onveranderd. De **getoonde** Power in kiezer, HUD en
267 niet de planeet van het doel). De client kan dat niet vervalsen.
268 lobby is `1 − miss / 0,60` als percentage (0 % miss → 100 % Power,
269 60 % miss → 0 % Power). Dat is alleen weergave (t1105). In
270 multiplayer gebruikt de **server** de gameplay-Power van **jouw**
271 planeet voor de blokjes die jij afschiet (niet de lobby-waarde, niet
272 de planeet van het doel). De client kan dat niet vervalsen.
268- De vier getallen op de kiezers en in de HUD: `g` als
273- De vier getallen op de kiezers en in de HUD: `g` als
269 zwaartekrachtsconstante (m/s²), `d` als luchtdichtheid, `F` in newton,
274 zwaartekrachtsconstante (m/s²), `d` als luchtdichtheid, `F` in newton,
270 Power als percentage. Alleen de getallen, zonder uitleg. Verticale match
275 getoonde Power als percentage. Alleen de getallen, zonder uitleg.
271 van 3 = 120 % sprong, +5 % per extra blokje (al gebouwd, nergens uitgelegd).
276 Verticale match van 3 = 120 % sprong, +5 % per extra blokje (al
277 gebouwd, nergens uitgelegd).
272- Elk veld heeft een eigen set van 5 kleuren, elk met een uniek vormpje
278- Elk veld heeft een eigen set van 5 kleuren, elk met een uniek vormpje
273 en een uniek placeholder-PNG (`build/images/block-{planeet}-{kleur}.png`).
279 en een uniek placeholder-PNG (`build/images/block-{planeet}-{kleur}.png`).
274 Tim kan die bestanden zelf vervangen; de namen blijven gelijk. Te
280 Tim kan die bestanden zelf vervangen; de namen blijven gelijk. Te
@@ -277,3 +283,38 @@ Aanname:
277 lobby (iedereen kiest zelf; zichtbaar voor de anderen). De keuze wordt
283 lobby (iedereen kiest zelf; zichtbaar voor de anderen). De keuze wordt
278 onthouden in `localStorage` (`meteors-planet`). Na de start van een
284 onthouden in `localStorage` (`meteors-planet`). Na de start van een
279 wedstrijd kun je niet meer wisselen.
285 wedstrijd kun je niet meer wisselen.
286
287## t1104 — 1:1-slepen en spontane raketten
288
289- Oorzaak van de sleepbug: `moveDrag` werkte met een opgetelde
290 pointer-delta en een drempel van `SWAP_DISTANCE` (0,25 tegel). Een
291 klein stukje sleep deed daardoor al een hele tegel, en één grote
292 `pointermove` (typisch op touch) kon de rest van de kolom aflopen —
293 precies “meestal gelijk helemaal omlaag of omhoog”. De doelrij was
294 niet de rij onder de vinger, dus als de vinger stopte kon het blokje
295 al aan de top of de bodem zitten. Daarnaast liep de pointer-mapping
296 via `canvas.width` / `app.tile`, wat deltas zou vermenigvuldigen met
297 de devicePixelRatio als de backing-store en de CSS-maat ooit
298 uit elkaar lopen.
299- Nu: de doelrij is `floor(pointerY)`, geklemd op de still-stapel van
300 de kolom. `swapToward` wisselt stap voor stap met elke buur, en stopt
301 precies daar. Als de pointer stilstaat, beweegt er niets meer.
302 Optrekken-boven-de-top om te lanceren blijft. Coordinaten komen uit
303 `getBoundingClientRect` en de veldgrootte (10×13), zonder
304 canvas-backing of `app.tile`.
305- Spontane rijen (na vallen, settle/recolor, cargo-attach op een
306 vliegende cluster, cluster-merge) worden altijd raketten, net als
307 wanneer de speler ze maakt. In een al vliegende cluster geeft dat
308 een extra sprong vanaf de huidige positie (`checkChainRelaunch`,
309 dezelfde hoogte als bij een player-push). Mid-air hangend cargo na
310 recolor valt nog steeds vanuit stilstand (t1102), geen launch.
311
312## t1105 — getoonde Power omgekeerd
313
314- Alleen de weergave. Gameplay `power()` en `missChance()` zijn
315 onveranderd (`miss = 0,60 − 0,55 × power`). Getoonde Power =
316 `1 − missChance / 0,60`, afgerond als percentage, in JS
317 (`Planet.displayValues` / `formatStats`) en PHP (`Planets::displayValues`),
318 dus op de planeetkiezer, in de HUD en in de lobby. 0 % miss is 100 %
319 Power; Aurel 0 %, Terra 44 %, Cinder 92 %.
320