docs: stage-3 planet catalog, Power miss and placeholder images
@@ -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 261
| `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 269
70
70
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
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 veld77
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 jij86
verstuurt. De twaalf werelden en hun getallen staan in87
`server/lib/planets.json`. De blokplaatjes zijn unieke placeholders88
(`build/images/block-{planeet}-{kleur}.png`); Tim kan ze zelf vervangen.89
72
## Deploy90
## Deploy73
91
74
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.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
Je eigen veld is het hoofdspel; miniaturen van de tegenstanders staan erboven.104
Je eigen veld is het hoofdspel; miniaturen van de tegenstanders staan erboven.87
Blokjes die van je veld afschieten kiezen een willekeurige andere (nog niet105
Blokjes die van je veld afschieten kiezen een willekeurige andere (nog niet88
uitgeschakelde) speler en vliegen daar in een korte tween naartoe (draaien en106
uitgeschakelde) speler en vliegen daar in een korte tween naartoe (draaien en89
krimpen). Met 30 % kans (`missChance`, een parameter; in stage 3 wordt dit107
krimpen). De kans dat ze missen komt uit de **Power van jouw planeet** (60 % op het90
`Planet.missChance` via Power) missen ze en verdwijnen ze in de verte. Een raak108
makkelijkste veld, 5 % op het moeilijkste); dat gooit de server. Een raak91
schot komt bij de ander aan als een vallend donkergrijs blokje dat na 3 seconden109
schot komt bij de ander aan als een vallend donkergrijs blokje dat na 3 seconden92
op een stapel weer een kleur krijgt. Wie al zijn kolommen vol heeft, is toeschouwer110
op een stapel weer een kleur krijgt. Wie al zijn kolommen vol heeft, is toeschouwer93
en geen doelwit meer. De laatste die overblijft wint; 1e/2e/3e staan 5 seconden111
en geen doelwit meer. De laatste die overblijft wint; 1e/2e/3e staan 5 seconden@@ -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 loslaten117
terug (ook als het ondertussen gelanceerd wordt). Muis en touch gebruiken117
terug (ook als het ondertussen gelanceerd wordt). Muis en touch gebruiken118
dezelfde tween.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 een122
De miss-kans van 30% was de stage-2-parameter; stage 3 vervangt die door123
parameter (`missChance`, standaard 0,30); de planeetformule123
parameter (`missChance`, standaard 0,30); de planeetformule124
`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) en256
telt **12** werelden, van makkelijk (Aurel: Power 0 %, 60 % miss) tot257
moeilijk (Cinder: Power 100 %, 5 % miss). Terra blijft de standaard.258
- Zwaartekracht (`jumpsToClear` 1–4): één sprong haalt `1/jumpsToClear` van259
de veldhoogte. Luchtweerstand (`fallTime` 1–5 s tot de bodem). Massa260
(`riseTime` 0,5–3 s tot de apex). Lage massa en lage luchtweerstand en261
hoge zwaartekracht zijn moeilijker. Bounce-duur en apex-ease schalen al262
met `fallTime` (gebouwd in stage 1).263
- Power is het gemiddelde van die drie assen, genormaliseerd 0–1, getoond264
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 van266
**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` als269
zwaartekrachtsconstante (m/s²), `d` als luchtdichtheid, `F` in newton,270
Power als percentage. Alleen de getallen, zonder uitleg. Verticale match271
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 vormpje273
en een uniek placeholder-PNG (`build/images/block-{planeet}-{kleur}.png`).274
Tim kan die bestanden zelf vervangen; de namen blijven gelijk. Te275
(her)genereren met `python3 scripts/gen_planet_blocks.py`.276
- Planeetkeuze komt vóór solo-spel (`Spelen` opent de kiezer) en in de277
lobby (iedereen kiest zelf; zichtbaar voor de anderen). De keuze wordt278
onthouden in `localStorage` (`meteors-planet`). Na de start van een279
wedstrijd kun je niet meer wisselen.