BlueGit

projects-timfalken-com meteors

t1184-t1188: docs (NL) and build

timfa Grok Bot · pushed by timfa

Authored 2026-11-14 · 3 days ago

Hash
5fa2c2f5b10d6b94f2f54f8e077386c6556d5df1
Parent
c70c5000
3 files changed +170 −0
README.md +10 −0
@@ -196,6 +196,16 @@ op een stapel weer een kleur krijgt. Wie al zijn kolommen vol heeft, is toeschou
196 196 en geen doelwit meer. De laatste die overblijft wint; 1e/2e/3e staan 5 seconden
197 197 op het podium en daarna ga je terug naar de lobby.
198 198
199 ### Vallende blokken en vertrekkende raketten
200
201 - Vliegt een raketstapel omhoog, is het hoogste blok voorbij 75% van de
202 veldhoogte en gaat hij zeker het scherm uit, dan valt er geen nieuw blok
203 en geen ontvangen (grijs) blok in de kolommen van die stapel: ze kiezen
204 een andere kolom.
205 - Het tempo loopt op: na elk nieuw blok wordt de spawn-interval 0,3%
206 korter (start 1 s, minimum 0,1 s, na ca. 767 blokken / 5 minuten). Elk
207 spel en elke ronde begint weer op 1 s, ook voor bots.
208
199 209 ### Raketvlam
200 210
201 211 De vlam onder een raketblok wisselt 25 keer per seconde naar een willekeurig
@@ -196,6 +196,16 @@ op een stapel weer een kleur krijgt. Wie al zijn kolommen vol heeft, is toeschou
196en geen doelwit meer. De laatste die overblijft wint; 1e/2e/3e staan 5 seconden
196en geen doelwit meer. De laatste die overblijft wint; 1e/2e/3e staan 5 seconden
197op het podium en daarna ga je terug naar de lobby.
197op het podium en daarna ga je terug naar de lobby.
198
198
199### Vallende blokken en vertrekkende raketten
200
201- Vliegt een raketstapel omhoog, is het hoogste blok voorbij 75% van de
202 veldhoogte en gaat hij zeker het scherm uit, dan valt er geen nieuw blok
203 en geen ontvangen (grijs) blok in de kolommen van die stapel: ze kiezen
204 een andere kolom.
205- Het tempo loopt op: na elk nieuw blok wordt de spawn-interval 0,3%
206 korter (start 1 s, minimum 0,1 s, na ca. 767 blokken / 5 minuten). Elk
207 spel en elke ronde begint weer op 1 s, ook voor bots.
208
199### Raketvlam
209### Raketvlam
200
210
201De vlam onder een raketblok wisselt 25 keer per seconde naar een willekeurig
211De vlam onder een raketblok wisselt 25 keer per seconde naar een willekeurig
build/game.js +109 −0
@@ -5730,17 +5730,96 @@ GameCore.prototype.step = function (seconds, dt)
5730 5730 }
5731 5731 };
5732 5732
5733 /** Share of the field height a rising stack must pass (t1184). */
5734 GameCore.DEPART_SHARE = 0.75;
5735
5736 /**
5737 * Columns with a rising rocket stack that will certainly leave the
5738 * screen (t1184). A flying cluster counts when it is still going up,
5739 * its highest block is past DEPART_SHARE of the field height, its apex
5740 * (y + vy^2 / (2 * decel)) is at or above the top, and nothing grounded
5741 * hangs above it in its columns. Every column that stack occupies is
5742 * departing: newly spawned blocks and received garbage pick another
5743 * column (t1185/t1186). Returns { col: true }.
5744 */
5745 GameCore.prototype.departingColumns = function ()
5746 {
5747 var out = Object.create(null);
5748 var H = this.height;
5749 var ids = Object.keys(this.clusters);
5750 for (var n = 0; n < ids.length; n++)
5751 {
5752 var cluster = this.clusters[ids[n]];
5753 if (!cluster || cluster.phase !== 'up' || !(cluster.vy > 1e-9))
5754 { continue; }
5755 var members = this.clusterMembers(cluster.id);
5756 if (!members.length)
5757 { continue; }
5758 var top = -Infinity;
5759 var lowest = Object.create(null);
5760 for (var i = 0; i < members.length; i++)
5761 {
5762 var m = members[i];
5763 if (m.state !== STATE_FLYING)
5764 { continue; }
5765 if (m.y > top)
5766 { top = m.y; }
5767 if (lowest[m.col] == null || m.y < lowest[m.col])
5768 { lowest[m.col] = m.y; }
5769 }
5770 if (top < this.DEPART_LINE())
5771 { continue; }
5772 var decel = cluster.decel || 0;
5773 var rise = decel > 1e-12 ? (cluster.vy * cluster.vy) / (2 * decel) : Infinity;
5774 if (top + rise < H - 1e-9)
5775 { continue; }
5776 var blocked = false;
5777 for (var col in lowest)
5778 {
5779 var c = col | 0;
5780 for (var j = 0; j < this.blocks.length; j++)
5781 {
5782 var b = this.blocks[j];
5783 if (b.col === c && b.clusterId !== cluster.id && this.isGrounded(b) && b.y > lowest[col])
5784 {
5785 blocked = true;
5786 break;
5787 }
5788 }
5789 if (blocked)
5790 { break; }
5791 }
5792 if (blocked)
5793 { continue; }
5794 // t1185/t1186: every column the departing stack occupies is off
5795 // limits; new and received blocks pick another column.
5796 for (var col2 in lowest)
5797 { out[col2 | 0] = true; }
5798 }
5799 return out;
5800 };
5801
5802 /** Height (tiles from the ground) a rising stack must pass: 75% of the field. */
5803 GameCore.prototype.DEPART_LINE = function ()
5804 {
5805 return this.height * GameCore.DEPART_SHARE;
5806 };
5807
5733 5808 GameCore.prototype.trySpawn = function ()
5734 5809 {
5735 5810 if (this.state !== 'playing')
5736 5811 { return null; }
5737 5812 var eligible = [];
5813 var departing = this.departingColumns();
5738 5814 for (var col = 0; col < this.width; col++)
5739 5815 {
5740 5816 if (this.isColumnLocked(col))
5741 5817 { continue; }
5742 5818 if (this.groundedCount(col) >= this.height)
5743 5819 { continue; }
5820 // t1184: never drop a new block onto a stack that is leaving.
5821 if (departing[col])
5822 { continue; }
5744 5823 var alreadyFalling = false;
5745 5824 var list = this.blocksInColumn(col);
5746 5825 for (var i = 0; i < list.length; i++)
@@ -5760,9 +5839,28 @@ GameCore.prototype.trySpawn = function ()
5760 5839 var color = this.randomColor();
5761 5840 var block = this.createBlock(col, this.height, color, STATE_FALLING);
5762 5841 block.vy = -this.planet.fallSpeed;
5842 this.speedUpSpawning();
5763 5843 return block;
5764 5844 };
5765 5845
5846 /** Each spawned block shrinks the spawn interval by 0.3% (t1187 / t1188). */
5847 GameCore.SPAWN_SPEEDUP = 0.997;
5848 /** The spawn interval never goes below this (seconds, t1187). */
5849 GameCore.SPAWN_INTERVAL_MIN = 0.1;
5850
5851 /**
5852 * After every real spawn: spawnInterval *= SPAWN_SPEEDUP, floored at
5853 * SPAWN_INTERVAL_MIN. Starts at PlanetMod.SPAWN_INTERVAL (1 s) for every
5854 * new core, i.e. every game and every round, for players and bots alike.
5855 * Reaches the floor after ~767 spawns (~5 min of continuous play).
5856 */
5857 GameCore.prototype.speedUpSpawning = function ()
5858 {
5859 var next = this.spawnInterval * GameCore.SPAWN_SPEEDUP;
5860 this.spawnInterval = Math.max(GameCore.SPAWN_INTERVAL_MIN, next);
5861 return this.spawnInterval;
5862 };
5863
5766 5864 GameCore.prototype.integrateFalling = function (dt)
5767 5865 {
5768 5866 var falling = [];
@@ -7180,6 +7278,17 @@ GameCore.prototype.pickGarbageColumn = function (preferred)
7180 7278 var eligible = this.eligibleGarbageColumns();
7181 7279 if (!eligible.length)
7182 7280 { return null; }
7281 // t1184: skip columns whose rocket stack is certainly leaving; only
7282 // if every open column is departing, fall back so no garbage is lost.
7283 var departing = this.departingColumns();
7284 var staying = [];
7285 for (var k = 0; k < eligible.length; k++)
7286 {
7287 if (!departing[eligible[k]])
7288 { staying.push(eligible[k]); }
7289 }
7290 if (staying.length)
7291 { eligible = staying; }
7183 7292 if (preferred != null && isFinite(preferred))
7184 7293 {
7185 7294 var want = preferred | 0;
@@ -5730,17 +5730,96 @@ GameCore.prototype.step = function (seconds, dt)
5730 }
5730 }
5731};
5731};
5732
5732
5733/** Share of the field height a rising stack must pass (t1184). */
5734GameCore.DEPART_SHARE = 0.75;
5735
5736/**
5737 * Columns with a rising rocket stack that will certainly leave the
5738 * screen (t1184). A flying cluster counts when it is still going up,
5739 * its highest block is past DEPART_SHARE of the field height, its apex
5740 * (y + vy^2 / (2 * decel)) is at or above the top, and nothing grounded
5741 * hangs above it in its columns. Every column that stack occupies is
5742 * departing: newly spawned blocks and received garbage pick another
5743 * column (t1185/t1186). Returns { col: true }.
5744 */
5745GameCore.prototype.departingColumns = function ()
5746{
5747 var out = Object.create(null);
5748 var H = this.height;
5749 var ids = Object.keys(this.clusters);
5750 for (var n = 0; n < ids.length; n++)
5751 {
5752 var cluster = this.clusters[ids[n]];
5753 if (!cluster || cluster.phase !== 'up' || !(cluster.vy > 1e-9))
5754 { continue; }
5755 var members = this.clusterMembers(cluster.id);
5756 if (!members.length)
5757 { continue; }
5758 var top = -Infinity;
5759 var lowest = Object.create(null);
5760 for (var i = 0; i < members.length; i++)
5761 {
5762 var m = members[i];
5763 if (m.state !== STATE_FLYING)
5764 { continue; }
5765 if (m.y > top)
5766 { top = m.y; }
5767 if (lowest[m.col] == null || m.y < lowest[m.col])
5768 { lowest[m.col] = m.y; }
5769 }
5770 if (top < this.DEPART_LINE())
5771 { continue; }
5772 var decel = cluster.decel || 0;
5773 var rise = decel > 1e-12 ? (cluster.vy * cluster.vy) / (2 * decel) : Infinity;
5774 if (top + rise < H - 1e-9)
5775 { continue; }
5776 var blocked = false;
5777 for (var col in lowest)
5778 {
5779 var c = col | 0;
5780 for (var j = 0; j < this.blocks.length; j++)
5781 {
5782 var b = this.blocks[j];
5783 if (b.col === c && b.clusterId !== cluster.id && this.isGrounded(b) && b.y > lowest[col])
5784 {
5785 blocked = true;
5786 break;
5787 }
5788 }
5789 if (blocked)
5790 { break; }
5791 }
5792 if (blocked)
5793 { continue; }
5794 // t1185/t1186: every column the departing stack occupies is off
5795 // limits; new and received blocks pick another column.
5796 for (var col2 in lowest)
5797 { out[col2 | 0] = true; }
5798 }
5799 return out;
5800};
5801
5802/** Height (tiles from the ground) a rising stack must pass: 75% of the field. */
5803GameCore.prototype.DEPART_LINE = function ()
5804{
5805 return this.height * GameCore.DEPART_SHARE;
5806};
5807
5733GameCore.prototype.trySpawn = function ()
5808GameCore.prototype.trySpawn = function ()
5734{
5809{
5735 if (this.state !== 'playing')
5810 if (this.state !== 'playing')
5736 { return null; }
5811 { return null; }
5737 var eligible = [];
5812 var eligible = [];
5813 var departing = this.departingColumns();
5738 for (var col = 0; col < this.width; col++)
5814 for (var col = 0; col < this.width; col++)
5739 {
5815 {
5740 if (this.isColumnLocked(col))
5816 if (this.isColumnLocked(col))
5741 { continue; }
5817 { continue; }
5742 if (this.groundedCount(col) >= this.height)
5818 if (this.groundedCount(col) >= this.height)
5743 { continue; }
5819 { continue; }
5820 // t1184: never drop a new block onto a stack that is leaving.
5821 if (departing[col])
5822 { continue; }
5744 var alreadyFalling = false;
5823 var alreadyFalling = false;
5745 var list = this.blocksInColumn(col);
5824 var list = this.blocksInColumn(col);
5746 for (var i = 0; i < list.length; i++)
5825 for (var i = 0; i < list.length; i++)
@@ -5760,9 +5839,28 @@ GameCore.prototype.trySpawn = function ()
5760 var color = this.randomColor();
5839 var color = this.randomColor();
5761 var block = this.createBlock(col, this.height, color, STATE_FALLING);
5840 var block = this.createBlock(col, this.height, color, STATE_FALLING);
5762 block.vy = -this.planet.fallSpeed;
5841 block.vy = -this.planet.fallSpeed;
5842 this.speedUpSpawning();
5763 return block;
5843 return block;
5764};
5844};
5765
5845
5846/** Each spawned block shrinks the spawn interval by 0.3% (t1187 / t1188). */
5847GameCore.SPAWN_SPEEDUP = 0.997;
5848/** The spawn interval never goes below this (seconds, t1187). */
5849GameCore.SPAWN_INTERVAL_MIN = 0.1;
5850
5851/**
5852 * After every real spawn: spawnInterval *= SPAWN_SPEEDUP, floored at
5853 * SPAWN_INTERVAL_MIN. Starts at PlanetMod.SPAWN_INTERVAL (1 s) for every
5854 * new core, i.e. every game and every round, for players and bots alike.
5855 * Reaches the floor after ~767 spawns (~5 min of continuous play).
5856 */
5857GameCore.prototype.speedUpSpawning = function ()
5858{
5859 var next = this.spawnInterval * GameCore.SPAWN_SPEEDUP;
5860 this.spawnInterval = Math.max(GameCore.SPAWN_INTERVAL_MIN, next);
5861 return this.spawnInterval;
5862};
5863
5766GameCore.prototype.integrateFalling = function (dt)
5864GameCore.prototype.integrateFalling = function (dt)
5767{
5865{
5768 var falling = [];
5866 var falling = [];
@@ -7180,6 +7278,17 @@ GameCore.prototype.pickGarbageColumn = function (preferred)
7180 var eligible = this.eligibleGarbageColumns();
7278 var eligible = this.eligibleGarbageColumns();
7181 if (!eligible.length)
7279 if (!eligible.length)
7182 { return null; }
7280 { return null; }
7281 // t1184: skip columns whose rocket stack is certainly leaving; only
7282 // if every open column is departing, fall back so no garbage is lost.
7283 var departing = this.departingColumns();
7284 var staying = [];
7285 for (var k = 0; k < eligible.length; k++)
7286 {
7287 if (!departing[eligible[k]])
7288 { staying.push(eligible[k]); }
7289 }
7290 if (staying.length)
7291 { eligible = staying; }
7183 if (preferred != null && isFinite(preferred))
7292 if (preferred != null && isFinite(preferred))
7184 {
7293 {
7185 var want = preferred | 0;
7294 var want = preferred | 0;
docs/ASSUMPTIONS.md +51 −0
@@ -1025,3 +1025,54 @@ Tests: `test/mini-predict.test.js`, plus de mini-meting in
1025 1025
1026 1026 Tests: `test/flame-fx.test.js`; browser: `test/t1183-flame-playwright.py URL TAG`.
1027 1027
1028 ## t1184 / t1185 / t1186 — niet laten vallen op een vertrekkende raket
1029
1030 Tims woorden: "blokjes niet laten vallen op rijen waarvan nu blokken omhoog
1031 vliegen waarvan de hoogste voorbij 75% vanaf de grond is die zeker het
1032 scherm gaan verlaten".
1033
1034 - **"Rijen" = kolommen.** Blokken vallen per kolom (10 breed, 13 hoog) en
1035 een raket (vliegend cluster) stijgt in de kolommen waarin hij zit.
1036 - **Vertrekkende stapel** (`GameCore.departingColumns`): een vliegend
1037 cluster dat nog stijgt (`phase 'up'`), waarvan het hoogste blok op of
1038 boven `0,75 × 13 = 9,75` staat (`GameCore.DEPART_SHARE`), waarvan de
1039 top (y + vy²/(2·decel)) de bovenrand haalt ("zeker het scherm uit"), en
1040 waar in zijn kolommen geen vast blok boven hangt. Alle kolommen waarin
1041 dat cluster blokken heeft tellen als vertrekkend.
1042 - **Nieuwe blokken** (`trySpawn`) slaan die kolommen over. Zijn alle open
1043 kolommen vertrekkend, dan valt er die tik niets (de volgende spawn-tik
1044 probeert opnieuw).
1045 - **Ontvangen blokken** (garbage van een tegenstander of bot,
1046 `ingestGarbage` / `pickGarbageColumn`): de gewenste kolom (`land_col` van
1047 de server) wint alleen als die niet vertrekkend is; anders een
1048 willekeurige andere open kolom. Zijn alle open kolommen vertrekkend, dan
1049 valt het blok toch (in de gewenste kolom), zodat er nooit garbage
1050 verdwijnt.
1051 - Ze vallen dus niet door de raket heen en ook niet erop: ze kiezen een
1052 andere kolom. Blokken die al vielen voordat de stapel de 75% passeerde
1053 houden de bestaande regels (ze kunnen als lading meeliften).
1054 - **Online consistent:** elk veld wordt door de eigen client gesimuleerd
1055 met dezelfde gedeelde `GameCore` (solo, offline met bots en online). De
1056 server kiest alleen een voorkeurskolom (`land_col`, willekeurig 0–9) en
1057 hoeft niets te weten van raketten; de client wijkt uit zoals bij volle
1058 of geblokkeerde kolommen (t1126). De vluchtanimatie mikt nog op
1059 `land_col`; het blok verschijnt dan in de gekozen kolom.
1060
1061 Tests: `test/departing.test.js`; browser:
1062 `test/t1184-departing-playwright.py URL TAG` (desktop + mobiel).
1063
1064 ## t1187 / t1188 — spawn-tempo loopt op
1065
1066 - Na elk echt gespawnd blok (`trySpawn` die een blok maakt):
1067 `spawnInterval *= GameCore.SPAWN_SPEEDUP` (0,997 = 0,3% korter; eerst
1068 3% gevraagd, door Tim aangepast naar 0,3%).
1069 - Start `PlanetMod.SPAWN_INTERVAL` = 1 s; minimum
1070 `GameCore.SPAWN_INTERVAL_MIN` = 0,1 s (aanname, Tim kan dit aanpassen).
1071 - Het minimum wordt bereikt na ca. 767 blokken, ongeveer 300 s (5 min).
1072 - Geen spawn (alle kolommen dicht of vertrekkend) = geen versnelling.
1073 - Elk spel en elke ronde maakt een nieuwe `GameCore`, dus het tempo begint
1074 steeds weer op 1 s. Spelers en bots (offline) en online velden gebruiken
1075 dezelfde code.
1076
1077 Tests: `test/spawn-speedup.test.js`.
1078
@@ -1025,3 +1025,54 @@ Tests: `test/mini-predict.test.js`, plus de mini-meting in
1025
1025
1026Tests: `test/flame-fx.test.js`; browser: `test/t1183-flame-playwright.py URL TAG`.
1026Tests: `test/flame-fx.test.js`; browser: `test/t1183-flame-playwright.py URL TAG`.
1027
1027
1028## t1184 / t1185 / t1186 — niet laten vallen op een vertrekkende raket
1029
1030Tims woorden: "blokjes niet laten vallen op rijen waarvan nu blokken omhoog
1031vliegen waarvan de hoogste voorbij 75% vanaf de grond is die zeker het
1032scherm gaan verlaten".
1033
1034- **"Rijen" = kolommen.** Blokken vallen per kolom (10 breed, 13 hoog) en
1035 een raket (vliegend cluster) stijgt in de kolommen waarin hij zit.
1036- **Vertrekkende stapel** (`GameCore.departingColumns`): een vliegend
1037 cluster dat nog stijgt (`phase 'up'`), waarvan het hoogste blok op of
1038 boven `0,75 × 13 = 9,75` staat (`GameCore.DEPART_SHARE`), waarvan de
1039 top (y + vy²/(2·decel)) de bovenrand haalt ("zeker het scherm uit"), en
1040 waar in zijn kolommen geen vast blok boven hangt. Alle kolommen waarin
1041 dat cluster blokken heeft tellen als vertrekkend.
1042- **Nieuwe blokken** (`trySpawn`) slaan die kolommen over. Zijn alle open
1043 kolommen vertrekkend, dan valt er die tik niets (de volgende spawn-tik
1044 probeert opnieuw).
1045- **Ontvangen blokken** (garbage van een tegenstander of bot,
1046 `ingestGarbage` / `pickGarbageColumn`): de gewenste kolom (`land_col` van
1047 de server) wint alleen als die niet vertrekkend is; anders een
1048 willekeurige andere open kolom. Zijn alle open kolommen vertrekkend, dan
1049 valt het blok toch (in de gewenste kolom), zodat er nooit garbage
1050 verdwijnt.
1051- Ze vallen dus niet door de raket heen en ook niet erop: ze kiezen een
1052 andere kolom. Blokken die al vielen voordat de stapel de 75% passeerde
1053 houden de bestaande regels (ze kunnen als lading meeliften).
1054- **Online consistent:** elk veld wordt door de eigen client gesimuleerd
1055 met dezelfde gedeelde `GameCore` (solo, offline met bots en online). De
1056 server kiest alleen een voorkeurskolom (`land_col`, willekeurig 0–9) en
1057 hoeft niets te weten van raketten; de client wijkt uit zoals bij volle
1058 of geblokkeerde kolommen (t1126). De vluchtanimatie mikt nog op
1059 `land_col`; het blok verschijnt dan in de gekozen kolom.
1060
1061Tests: `test/departing.test.js`; browser:
1062`test/t1184-departing-playwright.py URL TAG` (desktop + mobiel).
1063
1064## t1187 / t1188 — spawn-tempo loopt op
1065
1066- Na elk echt gespawnd blok (`trySpawn` die een blok maakt):
1067 `spawnInterval *= GameCore.SPAWN_SPEEDUP` (0,997 = 0,3% korter; eerst
1068 3% gevraagd, door Tim aangepast naar 0,3%).
1069- Start `PlanetMod.SPAWN_INTERVAL` = 1 s; minimum
1070 `GameCore.SPAWN_INTERVAL_MIN` = 0,1 s (aanname, Tim kan dit aanpassen).
1071- Het minimum wordt bereikt na ca. 767 blokken, ongeveer 300 s (5 min).
1072- Geen spawn (alle kolommen dicht of vertrekkend) = geen versnelling.
1073- Elk spel en elke ronde maakt een nieuwe `GameCore`, dus het tempo begint
1074 steeds weer op 1 s. Spelers en bots (offline) en online velden gebruiken
1075 dezelfde code.
1076
1077Tests: `test/spawn-speedup.test.js`.
1078