Physics-audit (t1111 / t1112)
Problemen die we vonden in de vlucht-, bots-, merge-, landings-, settle- en recolor-logica op master 1ede900, nagegaan aan de hand van t1111.webm en een gerandomiseerde soak. Daarna de herschrijving.
Wat Tim zag (video, 3e kolom)
- Gegoide roze blokjes liepen een eerder gegooid roze blokje in en
overlapten in dezelfde cel.
- Een gegooid geel blokje ging door twee roze blokjes heen en overlapte
een vallend groen blokje.
- Bij de landing snapte de stapel, met een gat (geel, gat, roze, groen,
roze).
- Een blokje leek van kleur of type te veranderen.
- Nog een worp ging door het onderste blokje heen.
- De cluster stortte in tot 2 cellen met overlaps, alsof blokjes
verdwenen.
- Een worp liet de cluster in een gatloze 5-stapel teleporten, die
vervolgens tot 3 rijen met overlaps inzakte.
- De stapel spreidde zich daarna naar beneden uit, met gaten en
overlaps over meerdere frames.
Gevonden oorzaken
1. Een gegooid blokje duwde een cluster-kolom omhoog maar sloot niet aan (t1111). checkManualPush / pushClusterColumn schoof de geraakte kolom 1 tegel op en zette pushedClusters zodat die worp de cluster niet nóg eens duwde. Het gegoide blokje zelf bleef MANUAL en vloog door de cluster heen. Elke volgende worp deed hetzelfde: door elkaar, overlaps, daarna een late pack die alles in één stapel duwde (“teleport naar een 5-stapel”).
2. Twee gegooide (MANUAL) blokjes hadden geen botsing. Een tweede worp in dezelfde kolom liep de eerste in en deelde een cel. Precies “roze haalt eerder roze in”.
3. Een vliegende cluster was geen star lichaam. Elk lid had een eigen y. integrateClusters telde dezelfde dy op, maar duwen, attach, merge en packClusterOverlaps werkten per blokje. Relatieve posities dreven uit elkaar (niet-gehele offsets, gaten én overlaps in dezelfde kolom).
4. packClusterOverlaps herstelde alleen overlaps, en pas achteraf, door hogere blokjes omhoog te zetten. Als vijf blokjes al in twee cellen zaten, werden ze in één keer een 5-stapel — de teleport uit de video. Bij gelijke y was de sorteervolgorde instabiel, wat als een kleur- of typewisseling oogde (identiteit van twee overlappende sprites).
5. Botsingsdetectie was niet fully swept en niet alle paren. Cluster-cluster keek alleen naar de eindstand van de substep, niet naar het pad. MANUAL–MANUAL ontbrak. MANUAL–cluster duwde zonder te mergen. Vallend–vliegend en MANUAL–vallend waren er (t1108) maar misten gevallen door de volgorde van de integrates.
6. stackTop negeerde gaten. Het nam de hoogste grounded oppervlakte in de hele kolom. Een hangend STILL-blokje boven een gat (bijvoorbeeld na het loslaten van een gelande cluster) liet vallende blokjes onder dat gat omhoog teleporten en daar landen. Dat is de “gatloze 5-stapel”-teleport bij landing, gevolgd door inzakkende overlaps als die blokjes daarna weer zonder steun vallen (“spreidt zich naar beneden uit”).
7. releaseUnsupported deed maar twee vaste passes. Een keten van stills op een net losgelaten gelande groep (A op B op C, C valt) liet de bovenste stills soms een tick te lang staan. Samen met (6) gaf dat hangende stills boven vallende buren, en dan de teleport.
8. Landing van een slordige cluster hield gaten en overlaps. tryLandCluster schoof het geheel zodat het diepste contact vlak zat, maar pakte niet eerst. Een gelande groep met rommelige y snapte, herschikte en kon onbedoelde matches triggeren (t1110 op SETTLING cargo) — “verandering van kleur” die eigenlijk een match naar grijs of een overlap-illusie was. Echte kleurwijziging is alleen: match → grijs, en grijs → recolor.
9. fromManual-snelheid middelen (t1108) kon de fase van een cluster omdraaien als vallend cargo aansloot. Dat blijft de bedoelde regel voor worp+vallen, niet voor een schot in een bestaande cluster (die houdt zijn vy, het schot neemt die over).
Wat er nu geldt
- Een vliegende cluster is één star lichaam: één
anchorY, éénvy,
gehele clusterOffset per lid. y = anchorY + offset altijd. Merges en attaches zijn rooster-uitgelijnd. Volgorde in een kolom blijft (lagere y blijft lager; gelijke y breekt op id).
- Schot in een cluster (t1111): de geraakte kolom schuift 1 cel
omhoog, het schot sluit onderaan aan, grid-aligned, als lid van de cluster. Elke volgende worp hetzelfde. De cluster houdt zijn snelheid. Andere kolommen blijven. Een schot dat van boven komt (dalend) gaat op het dak zitten, zoals vallend cargo.
- Twee gegooide blokjes die botsen: de eerste wordt een 1-blokjes-
cluster, daarna geldt t1111. Een enkele worp blijft MANUAL (en blijft binnen het veld) tot hij ergens tegenaan botst.
- Worp + vallend: blijft t1108 (massagemiddelde
vy, star lichaam).
Vallend op een gewone match-raket: blijft “pak op, zelfde vy”.
- Swept botsing per substep tussen alle paren: worp–cluster,
worp–worp, vallend–vliegend, vallend–worp, cluster–cluster. Daarna een vangnet (resolveAirborneCollisions) en herbouw van elk star lichaam.
stackTop(..., belowY)telt alleen grounded blokjes onder de
valler, nooit een hangend blokje erboven.
releaseUnsupportedherhaalt tot de keten stil is.- Landing verschuift
anchorY; offsets (en dus gaten die bewust in
de starre vorm zitten, zoals een hangend lid over een vloer-gat) blijven. Overlaps zijn er dan niet meer.
- Invariant-checker (
checkInvariants): geen overlap, geen dubbele
cel, vliegende leden grid-aligned. Draait aan het eind van elke tick in tests (strictInvariants, standaard aan via makeGame) en met ?debug (overlay, zonder te gooien). Kleur mag alleen wijzigen via match→grijs of grijs-recolor; de soak test beweert dat, en dat geen blokje verdwijnt zonder te scoren.
Zie ook de aannames onder t1111/t1112 in docs/ASSUMPTIONS.md.
Source
| 1 | # Physics-audit (t1111 / t1112) |
| 2 | |
| 3 | Problemen die we vonden in de vlucht-, bots-, merge-, landings-, settle- |
| 4 | en recolor-logica op master `1ede900`, nagegaan aan de hand van |
| 5 | `t1111.webm` en een gerandomiseerde soak. Daarna de herschrijving. |
| 6 | |
| 7 | ## Wat Tim zag (video, 3e kolom) |
| 8 | |
| 9 | - Gegoide roze blokjes liepen een eerder gegooid roze blokje in en |
| 10 | overlapten in dezelfde cel. |
| 11 | - Een gegooid geel blokje ging door twee roze blokjes heen en overlapte |
| 12 | een vallend groen blokje. |
| 13 | - Bij de landing snapte de stapel, met een gat (geel, gat, roze, groen, |
| 14 | roze). |
| 15 | - Een blokje leek van kleur of type te veranderen. |
| 16 | - Nog een worp ging door het onderste blokje heen. |
| 17 | - De cluster stortte in tot 2 cellen met overlaps, alsof blokjes |
| 18 | verdwenen. |
| 19 | - Een worp liet de cluster in een gatloze 5-stapel teleporten, die |
| 20 | vervolgens tot 3 rijen met overlaps inzakte. |
| 21 | - De stapel spreidde zich daarna naar beneden uit, met gaten en |
| 22 | overlaps over meerdere frames. |
| 23 | |
| 24 | ## Gevonden oorzaken |
| 25 | |
| 26 | 1. **Een gegooid blokje duwde een cluster-kolom omhoog maar sloot niet |
| 27 | aan (t1111).** `checkManualPush` / `pushClusterColumn` schoof de |
| 28 | geraakte kolom 1 tegel op en zette `pushedClusters` zodat die worp |
| 29 | de cluster niet nóg eens duwde. Het gegoide blokje zelf bleef |
| 30 | MANUAL en vloog door de cluster heen. Elke volgende worp deed |
| 31 | hetzelfde: door elkaar, overlaps, daarna een late pack die alles |
| 32 | in één stapel duwde (“teleport naar een 5-stapel”). |
| 33 | |
| 34 | 2. **Twee gegooide (MANUAL) blokjes hadden geen botsing.** Een tweede |
| 35 | worp in dezelfde kolom liep de eerste in en deelde een cel. Precies |
| 36 | “roze haalt eerder roze in”. |
| 37 | |
| 38 | 3. **Een vliegende cluster was geen star lichaam.** Elk lid had een |
| 39 | eigen `y`. `integrateClusters` telde dezelfde `dy` op, maar duwen, |
| 40 | attach, merge en `packClusterOverlaps` werkten per blokje. |
| 41 | Relatieve posities dreven uit elkaar (niet-gehele offsets, gaten |
| 42 | én overlaps in dezelfde kolom). |
| 43 | |
| 44 | 4. **`packClusterOverlaps` herstelde alleen overlaps, en pas achteraf, |
| 45 | door hogere blokjes omhoog te zetten.** Als vijf blokjes al in twee |
| 46 | cellen zaten, werden ze in één keer een 5-stapel — de teleport uit |
| 47 | de video. Bij gelijke `y` was de sorteervolgorde instabiel, wat als |
| 48 | een kleur- of typewisseling oogde (identiteit van twee overlappende |
| 49 | sprites). |
| 50 | |
| 51 | 5. **Botsingsdetectie was niet fully swept en niet alle paren.** |
| 52 | Cluster-cluster keek alleen naar de eindstand van de substep, niet |
| 53 | naar het pad. MANUAL–MANUAL ontbrak. MANUAL–cluster duwde zonder |
| 54 | te mergen. Vallend–vliegend en MANUAL–vallend waren er (t1108) |
| 55 | maar misten gevallen door de volgorde van de integrates. |
| 56 | |
| 57 | 6. **`stackTop` negeerde gaten.** Het nam de hoogste grounded |
| 58 | oppervlakte in de hele kolom. Een hangend STILL-blokje boven een |
| 59 | gat (bijvoorbeeld na het loslaten van een gelande cluster) liet |
| 60 | vallende blokjes *onder* dat gat omhoog teleporten en daar landen. |
| 61 | Dat is de “gatloze 5-stapel”-teleport bij landing, gevolgd door |
| 62 | inzakkende overlaps als die blokjes daarna weer zonder steun |
| 63 | vallen (“spreidt zich naar beneden uit”). |
| 64 | |
| 65 | 7. **`releaseUnsupported` deed maar twee vaste passes.** Een keten |
| 66 | van stills op een net losgelaten gelande groep (A op B op C, C |
| 67 | valt) liet de bovenste stills soms een tick te lang staan. Samen |
| 68 | met (6) gaf dat hangende stills boven vallende buren, en dan de |
| 69 | teleport. |
| 70 | |
| 71 | 8. **Landing van een slordige cluster hield gaten en overlaps.** |
| 72 | `tryLandCluster` schoof het geheel zodat het diepste contact vlak |
| 73 | zat, maar pakte niet eerst. Een gelande groep met rommelige `y` |
| 74 | snapte, herschikte en kon onbedoelde matches triggeren (t1110 |
| 75 | op SETTLING cargo) — “verandering van kleur” die eigenlijk een |
| 76 | match naar grijs of een overlap-illusie was. Echte kleurwijziging |
| 77 | is alleen: match → grijs, en grijs → recolor. |
| 78 | |
| 79 | 9. **`fromManual`-snelheid middelen (t1108) kon de fase van een |
| 80 | cluster omdraaien** als vallend cargo aansloot. Dat blijft de |
| 81 | bedoelde regel voor worp+vallen, niet voor een schot in een |
| 82 | bestaande cluster (die houdt zijn `vy`, het schot neemt die over). |
| 83 | |
| 84 | ## Wat er nu geldt |
| 85 | |
| 86 | - Een vliegende cluster is één star lichaam: één `anchorY`, één `vy`, |
| 87 | gehele `clusterOffset` per lid. `y = anchorY + offset` altijd. |
| 88 | Merges en attaches zijn rooster-uitgelijnd. Volgorde in een kolom |
| 89 | blijft (lagere `y` blijft lager; gelijke `y` breekt op `id`). |
| 90 | - **Schot in een cluster (t1111):** de geraakte kolom schuift 1 cel |
| 91 | omhoog, het schot sluit onderaan aan, grid-aligned, als lid van de |
| 92 | cluster. Elke volgende worp hetzelfde. De cluster houdt zijn |
| 93 | snelheid. Andere kolommen blijven. Een schot dat van boven komt |
| 94 | (dalend) gaat op het dak zitten, zoals vallend cargo. |
| 95 | - Twee gegooide blokjes die botsen: de eerste wordt een 1-blokjes- |
| 96 | cluster, daarna geldt t1111. Een enkele worp blijft MANUAL (en |
| 97 | blijft binnen het veld) tot hij ergens tegenaan botst. |
| 98 | - Worp + vallend: blijft t1108 (massagemiddelde `vy`, star lichaam). |
| 99 | Vallend op een gewone match-raket: blijft “pak op, zelfde `vy`”. |
| 100 | - Swept botsing per substep tussen alle paren: worp–cluster, |
| 101 | worp–worp, vallend–vliegend, vallend–worp, cluster–cluster. |
| 102 | Daarna een vangnet (`resolveAirborneCollisions`) en herbouw van |
| 103 | elk star lichaam. |
| 104 | - `stackTop(..., belowY)` telt alleen grounded blokjes onder de |
| 105 | valler, nooit een hangend blokje erboven. |
| 106 | - `releaseUnsupported` herhaalt tot de keten stil is. |
| 107 | - Landing verschuift `anchorY`; offsets (en dus gaten die bewust in |
| 108 | de starre vorm zitten, zoals een hangend lid over een vloer-gat) |
| 109 | blijven. Overlaps zijn er dan niet meer. |
| 110 | - Invariant-checker (`checkInvariants`): geen overlap, geen dubbele |
| 111 | cel, vliegende leden grid-aligned. Draait aan het eind van elke |
| 112 | `tick` in tests (`strictInvariants`, standaard aan via `makeGame`) |
| 113 | en met `?debug` (overlay, zonder te gooien). Kleur mag alleen |
| 114 | wijzigen via match→grijs of grijs-recolor; de soak test beweert |
| 115 | dat, en dat geen blokje verdwijnt zonder te scoren. |
| 116 | |
| 117 | Zie ook de aannames onder t1111/t1112 in `docs/ASSUMPTIONS.md`. |