BlueGit

projects-timfalken-com meteors

docs: stage-3 planet catalog, Power miss and placeholder images

timfa Grok Bot · pushed by timfa

Authored 2026-11-13 · 4 days ago

Hash
388a4f1234118a58780954bec4aa11810734f9ea
Parent
5940e2eb
2 files changed +51 −4
README.md +20 −2
@@ -61,6 +61,7 @@ De spelkern is deterministisch en staat los van tekenen en invoer, zodat stage 2
61 61 | `src/main.js` | Menu, HUD, frameworkv3-scene, muis/touch, schaal naar het scherm, landing-bounce, selectie-tween, online-lobby |
62 62 | `src/online.js` | API-client, polling, opponent-miniaturen, vlucht-tweens van afgeschoten blokjes |
63 63 | `server/` | PHP API: OAuth, lobby, shots, SQLite in `data/` (niet gedeployed) |
64 | `server/lib/planets.json` | Catalogus van 12 planeten (JS en PHP delen dit bestand) |
64 65 | `docs/ASSUMPTIONS.md` | Ingevulde aannames waar de specificatie ruimte liet |
65 66 | `src/build.sh` | Concateneert de bronnen naar `build/game.js` en kopieert de PHP-API naar `build/` |
66 67 | `build/` | Speelbare output: `index.html`, `style.css`, `framework.js`, `game.js`, `images/`, PHP-API |
@@ -69,6 +70,23 @@ De spelkern is deterministisch en staat los van tekenen en invoer, zodat stage 2
69 70
70 71 Sprongfysica is parametrisch. Een horizontale match van 3 springt `13 / jumpsToClear` tegels hoog; een verticale match van 3 krijgt 120 % daarvan, en elk extra blokje +5 % (wordt nergens in het spel uitgelegd). De massa bepaalt hoe lang de sprong omhoog duurt (onafhankelijk van de hoogte). Op de apex versnelt de cluster geleidelijk tot de valsnelheid (`apexEaseTime = 0,15 × fallTime`); daarna is de daal snelheid constant. De luchtweerstand (`fallTime`) bepaalt die valsnelheid én hoe snel de visuele landing-bounce is (`bounceDuration = 0,12 × fallTime`). Een vastgehouden blokje krijgt dezelfde schaal-tween als Tim's KWin Click Tween (150 ms easeOutBack naar 80 %, 720 ms easeOutElastic terug). Zie `docs/ASSUMPTIONS.md`.
71 72
73
74 ## Planeten (stage 3)
75
76 Voor je gaat spelen — solo en in de lobby — kies je een **veld**. Elk veld
77 is een planeet met een volk, vijf eigen kleuren/vormen, en drie natuurwetten:
78
79 - zwaartekracht — hoe hoog de eerste sprong is (`g`, m/s²)
80 - luchtweerstand — hoe snel blokjes weer vallen (`d`)
81 - massa — hoe snel de sprong omhoog gaat (`F`, newton)
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.
89
72 90 ## Deploy
73 91
74 92 BlueGit CI (`blue-ci-cd.yml`) draait tests en een build op feature-branches en op `master`. Op `master` volgt daarna `ftp_upload`: `build/` gaat via FTP naar `projectftp` (secret: `$timftproot/meteors`; de job expandeert `$timftproot` zelf en normaliseert dubbele slashes). **Geen `--delete`**. De eerste deploy weigert te schrijven als de doelmap al vreemde bestanden bevat.
@@ -86,8 +104,8 @@ zijn en iedereen gereed is.
86 104 Je eigen veld is het hoofdspel; miniaturen van de tegenstanders staan erboven.
87 105 Blokjes die van je veld afschieten kiezen een willekeurige andere (nog niet
88 106 uitgeschakelde) speler en vliegen daar in een korte tween naartoe (draaien en
89 krimpen). Met 30 % kans (`missChance`, een parameter; in stage 3 wordt dit
90 `Planet.missChance` via Power) missen ze en verdwijnen ze in de verte. Een raak
107 krimpen). De kans dat ze missen komt uit de **Power van jouw planeet** (60 % op het
108 makkelijkste veld, 5 % op het moeilijkste); dat gooit de server. Een raak
91 109 schot komt bij de ander aan als een vallend donkergrijs blokje dat na 3 seconden
92 110 op een stapel weer een kleur krijgt. Wie al zijn kolommen vol heeft, is toeschouwer
93 111 en geen doelwit meer. De laatste die overblijft wint; 1e/2e/3e staan 5 seconden
@@ -61,6 +61,7 @@ De spelkern is deterministisch en staat los van tekenen en invoer, zodat stage 2
61| `src/main.js` | Menu, HUD, frameworkv3-scene, muis/touch, schaal naar het scherm, landing-bounce, selectie-tween, online-lobby |
61| `src/main.js` | Menu, HUD, frameworkv3-scene, muis/touch, schaal naar het scherm, landing-bounce, selectie-tween, online-lobby |
62| `src/online.js` | API-client, polling, opponent-miniaturen, vlucht-tweens van afgeschoten blokjes |
62| `src/online.js` | API-client, polling, opponent-miniaturen, vlucht-tweens van afgeschoten blokjes |
63| `server/` | PHP API: OAuth, lobby, shots, SQLite in `data/` (niet gedeployed) |
63| `server/` | PHP API: OAuth, lobby, shots, SQLite in `data/` (niet gedeployed) |
64| `server/lib/planets.json` | Catalogus van 12 planeten (JS en PHP delen dit bestand) |
64| `docs/ASSUMPTIONS.md` | Ingevulde aannames waar de specificatie ruimte liet |
65| `docs/ASSUMPTIONS.md` | Ingevulde aannames waar de specificatie ruimte liet |
65| `src/build.sh` | Concateneert de bronnen naar `build/game.js` en kopieert de PHP-API naar `build/` |
66| `src/build.sh` | Concateneert de bronnen naar `build/game.js` en kopieert de PHP-API naar `build/` |
66| `build/` | Speelbare output: `index.html`, `style.css`, `framework.js`, `game.js`, `images/`, PHP-API |
67| `build/` | Speelbare output: `index.html`, `style.css`, `framework.js`, `game.js`, `images/`, PHP-API |
@@ -69,6 +70,23 @@ De spelkern is deterministisch en staat los van tekenen en invoer, zodat stage 2
69
70
70Sprongfysica is parametrisch. Een horizontale match van 3 springt `13 / jumpsToClear` tegels hoog; een verticale match van 3 krijgt 120 % daarvan, en elk extra blokje +5 % (wordt nergens in het spel uitgelegd). De massa bepaalt hoe lang de sprong omhoog duurt (onafhankelijk van de hoogte). Op de apex versnelt de cluster geleidelijk tot de valsnelheid (`apexEaseTime = 0,15 × fallTime`); daarna is de daal snelheid constant. De luchtweerstand (`fallTime`) bepaalt die valsnelheid én hoe snel de visuele landing-bounce is (`bounceDuration = 0,12 × fallTime`). Een vastgehouden blokje krijgt dezelfde schaal-tween als Tim's KWin Click Tween (150 ms easeOutBack naar 80 %, 720 ms easeOutElastic terug). Zie `docs/ASSUMPTIONS.md`.
71Sprongfysica is parametrisch. Een horizontale match van 3 springt `13 / jumpsToClear` tegels hoog; een verticale match van 3 krijgt 120 % daarvan, en elk extra blokje +5 % (wordt nergens in het spel uitgelegd). De massa bepaalt hoe lang de sprong omhoog duurt (onafhankelijk van de hoogte). Op de apex versnelt de cluster geleidelijk tot de valsnelheid (`apexEaseTime = 0,15 × fallTime`); daarna is de daal snelheid constant. De luchtweerstand (`fallTime`) bepaalt die valsnelheid én hoe snel de visuele landing-bounce is (`bounceDuration = 0,12 × fallTime`). Een vastgehouden blokje krijgt dezelfde schaal-tween als Tim's KWin Click Tween (150 ms easeOutBack naar 80 %, 720 ms easeOutElastic terug). Zie `docs/ASSUMPTIONS.md`.
71
72
73
74## Planeten (stage 3)
75
76Voor je gaat spelen — solo en in de lobby — kies je een **veld**. Elk veld
77is een planeet met een volk, vijf eigen kleuren/vormen, en drie natuurwetten:
78
79- zwaartekracht — hoe hoog de eerste sprong is (`g`, m/s²)
80- luchtweerstand — hoe snel blokjes weer vallen (`d`)
81- massa — hoe snel de sprong omhoog gaat (`F`, newton)
82
83Power is het gemiddelde van die drie, als percentage. Hoe hoger de Power,
84hoe kleiner de kans dat een afgeschoten blokje een andere speler mist.
85In een online wedstrijd telt **jouw** planeet voor de blokjes die jij
86verstuurt. 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.
89
72## Deploy
90## Deploy
73
91
74BlueGit CI (`blue-ci-cd.yml`) draait tests en een build op feature-branches en op `master`. Op `master` volgt daarna `ftp_upload`: `build/` gaat via FTP naar `projectftp` (secret: `$timftproot/meteors`; de job expandeert `$timftproot` zelf en normaliseert dubbele slashes). **Geen `--delete`**. De eerste deploy weigert te schrijven als de doelmap al vreemde bestanden bevat.
92BlueGit CI (`blue-ci-cd.yml`) draait tests en een build op feature-branches en op `master`. Op `master` volgt daarna `ftp_upload`: `build/` gaat via FTP naar `projectftp` (secret: `$timftproot/meteors`; de job expandeert `$timftproot` zelf en normaliseert dubbele slashes). **Geen `--delete`**. De eerste deploy weigert te schrijven als de doelmap al vreemde bestanden bevat.
@@ -86,8 +104,8 @@ zijn en iedereen gereed is.
86Je eigen veld is het hoofdspel; miniaturen van de tegenstanders staan erboven.
104Je eigen veld is het hoofdspel; miniaturen van de tegenstanders staan erboven.
87Blokjes die van je veld afschieten kiezen een willekeurige andere (nog niet
105Blokjes die van je veld afschieten kiezen een willekeurige andere (nog niet
88uitgeschakelde) speler en vliegen daar in een korte tween naartoe (draaien en
106uitgeschakelde) speler en vliegen daar in een korte tween naartoe (draaien en
89krimpen). Met 30 % kans (`missChance`, een parameter; in stage 3 wordt dit
107krimpen). De kans dat ze missen komt uit de **Power van jouw planeet** (60 % op het
90`Planet.missChance` via Power) missen ze en verdwijnen ze in de verte. Een raak
108makkelijkste veld, 5 % op het moeilijkste); dat gooit de server. Een raak
91schot komt bij de ander aan als een vallend donkergrijs blokje dat na 3 seconden
109schot komt bij de ander aan als een vallend donkergrijs blokje dat na 3 seconden
92op een stapel weer een kleur krijgt. Wie al zijn kolommen vol heeft, is toeschouwer
110op een stapel weer een kleur krijgt. Wie al zijn kolommen vol heeft, is toeschouwer
93en geen doelwit meer. De laatste die overblijft wint; 1e/2e/3e staan 5 seconden
111en geen doelwit meer. De laatste die overblijft wint; 1e/2e/3e staan 5 seconden
docs/ASSUMPTIONS.md +31 −2
@@ -117,9 +117,9 @@ Het blok blijft op 80% zolang het geselecteerd is, en veert bij loslaten
117 117 terug (ook als het ondertussen gelanceerd wordt). Muis en touch gebruiken
118 118 dezelfde tween.
119 119
120 ## Fase 2 — multiplayer (volgt)
120 ## Fase 2 — multiplayer (samenvatting)
121 121
122 Zie latere secties zodra fase 2 landt. De miss-kans van 30% wordt een
122 De miss-kans van 30% was de stage-2-parameter; stage 3 vervangt die door
123 123 parameter (`missChance`, standaard 0,30); de planeetformule
124 124 `Planet.missChance` (60%–5% via Power) is voor fase 3.
125 125
@@ -248,3 +248,32 @@ Aanname:
248 248 FTP); Tim zet het op het meteors-project. Optioneel: `auth_client_id`
249 249 (standaard `projects.timfalken.com`). `favicon.ico` blijft ongemoeid.
250 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: Power 0 %, 60 % miss) tot
257 moeilijk (Cinder: Power 100 %, 5 % miss). Terra blijft de standaard.
258 - Zwaartekracht (`jumpsToClear` 1–4): één sprong haalt `1/jumpsToClear` van
259 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 hoge zwaartekracht zijn moeilijker. Bounce-duur en apex-ease schalen al
262 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.
268 - De vier getallen op de kiezers en in de HUD: `g` als
269 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).
272 - 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`).
274 Tim kan die bestanden zelf vervangen; de namen blijven gelijk. Te
275 (her)genereren met `python3 scripts/gen_planet_blocks.py`.
276 - Planeetkeuze komt vóór solo-spel (`Spelen` opent de kiezer) en in de
277 lobby (iedereen kiest zelf; zichtbaar voor de anderen). De keuze wordt
278 onthouden in `localStorage` (`meteors-planet`). Na de start van een
279 wedstrijd kun je niet meer wisselen.
@@ -117,9 +117,9 @@ Het blok blijft op 80% zolang het geselecteerd is, en veert bij loslaten
117terug (ook als het ondertussen gelanceerd wordt). Muis en touch gebruiken
117terug (ook als het ondertussen gelanceerd wordt). Muis en touch gebruiken
118dezelfde tween.
118dezelfde tween.
119
119
120## Fase 2 — multiplayer (volgt)
120## Fase 2 — multiplayer (samenvatting)
121
121
122Zie latere secties zodra fase 2 landt. De miss-kans van 30% wordt een
122De miss-kans van 30% was de stage-2-parameter; stage 3 vervangt die door
123parameter (`missChance`, standaard 0,30); de planeetformule
123parameter (`missChance`, standaard 0,30); de planeetformule
124`Planet.missChance` (60%–5% via Power) is voor fase 3.
124`Planet.missChance` (60%–5% via Power) is voor fase 3.
125
125
@@ -248,3 +248,32 @@ Aanname:
248 FTP); Tim zet het op het meteors-project. Optioneel: `auth_client_id`
248 FTP); Tim zet het op het meteors-project. Optioneel: `auth_client_id`
249 (standaard `projects.timfalken.com`). `favicon.ico` blijft ongemoeid.
249 (standaard `projects.timfalken.com`). `favicon.ico` blijft ongemoeid.
250 `router.php` is alleen voor lokale `php -S` en gaat niet mee naar live.
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: Power 0 %, 60 % miss) tot
257 moeilijk (Cinder: Power 100 %, 5 % miss). Terra blijft de standaard.
258- Zwaartekracht (`jumpsToClear` 1–4): één sprong haalt `1/jumpsToClear` van
259 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 hoge zwaartekracht zijn moeilijker. Bounce-duur en apex-ease schalen al
262 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.
268- De vier getallen op de kiezers en in de HUD: `g` als
269 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).
272- 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`).
274 Tim kan die bestanden zelf vervangen; de namen blijven gelijk. Te
275 (her)genereren met `python3 scripts/gen_planet_blocks.py`.
276- Planeetkeuze komt vóór solo-spel (`Spelen` opent de kiezer) en in de
277 lobby (iedereen kiest zelf; zichtbaar voor de anderen). De keuze wordt
278 onthouden in `localStorage` (`meteors-planet`). Na de start van een
279 wedstrijd kun je niet meer wisselen.