docs: Planeetontwerper, unlocks and custom planets (t1139, t1140)
@@ -56,6 +56,10 @@ De spelkern is deterministisch en staat los van tekenen en invoer, zodat stage 2
56
56
| Pad | Rol |
57
57
| --- | --- |
58
58
| `src/planet.js` | Planeet: zwaartekracht, luchtweerstand, massa, kleuren/vormen, spronghoogte, Power, apex-ease, bounce |
59
| `src/blocks.js` | Append-only blokjesregister, drempels, ontgrendeling |
60
| `src/designer.js` | Planeetontwerper (lijst, bewerken, blokjes-modal) |
61
| `server/lib/blocks.json` | Blokjesregister (JS en PHP delen dit bestand) |
62
| `server/lib/Blocks.php` | Server-kant van het register en de drempels |
59
63
| `src/rng.js` | Seedable RNG (tests en later replays) |
60
64
| `src/easing.js` | Qt-eases (easeOutBack / easeOutElastic) en Click-Tween-defaults voor de selectie-animatie |
61
65
| `src/gameCore.js` | Simulatie: vallen, wisselen, match-3, raketsprong, linken, push-up + her-sprong, landen als starre groep + 3 s wachten, kolom-slot, game over, punten; stage 2: `outgoingShots`, `ingestGarbage`, `missChance`, `fieldSnapshot` |
@@ -111,6 +115,30 @@ staan in `server/lib/planets.json`. De blokplaatjes zijn unieke
111
115
placeholders (`build/images/block-{planeet}-{kleur}.png`); Tim kan ze
112
116
zelf vervangen.
113
117
118
## Planeetontwerper
119
120
Ingelogde spelers zien op het hoofdmenu hun puntentotaal en de knop
121
**Planeetontwerper**. Punten verzamel je door ingelogd te spelen
122
(solo aan het einde, elke ronde van Offline Strijd, en Online bij
123
uitschakeling). Ze worden niet uitgegeven: bij vaste drempels (Terra
124
gratis, daarna 500 punten en elke volgende 14,5 % hoger) ontgrendel
125
je extra blokjes.
126
127
In de ontwerper maak, bewerk of verwijder je eigen planeten (naam,
128
bevolking, de drie sliders voor zwaartekracht / lucht / massa, en
129
een live Power-preview met dezelfde formule als in het spel). Vijf
130
blokjesvakjes openen een raster van het hele register: blokjes die
131
al in een ander vak zitten zijn grijs, vergrendelde blokjes zijn
132
grijs mét een slotje.
133
134
Eigen planeten kun je in **elke** modus kiezen (Spelen, Offline
135
Strijd, Online). Online valideert de server de configuratie en
136
deelt een snapshot met de andere spelers.
137
138
Lokaal inloggen: `auth.php?test=1`. Op de live site blijft de
139
ontwerper verborgen tot OAuth (`callback.php` + CI-geheim
140
`auth_client_secret`) is ingesteld.
141
114
142
## Deploy
115
143
116
144
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.
@@ -56,6 +56,10 @@ De spelkern is deterministisch en staat los van tekenen en invoer, zodat stage 256
| Pad | Rol |56
| Pad | Rol |57
| --- | --- |57
| --- | --- |58
| `src/planet.js` | Planeet: zwaartekracht, luchtweerstand, massa, kleuren/vormen, spronghoogte, Power, apex-ease, bounce |58
| `src/planet.js` | Planeet: zwaartekracht, luchtweerstand, massa, kleuren/vormen, spronghoogte, Power, apex-ease, bounce |59
| `src/blocks.js` | Append-only blokjesregister, drempels, ontgrendeling |60
| `src/designer.js` | Planeetontwerper (lijst, bewerken, blokjes-modal) |61
| `server/lib/blocks.json` | Blokjesregister (JS en PHP delen dit bestand) |62
| `server/lib/Blocks.php` | Server-kant van het register en de drempels |59
| `src/rng.js` | Seedable RNG (tests en later replays) |63
| `src/rng.js` | Seedable RNG (tests en later replays) |60
| `src/easing.js` | Qt-eases (easeOutBack / easeOutElastic) en Click-Tween-defaults voor de selectie-animatie |64
| `src/easing.js` | Qt-eases (easeOutBack / easeOutElastic) en Click-Tween-defaults voor de selectie-animatie |61
| `src/gameCore.js` | Simulatie: vallen, wisselen, match-3, raketsprong, linken, push-up + her-sprong, landen als starre groep + 3 s wachten, kolom-slot, game over, punten; stage 2: `outgoingShots`, `ingestGarbage`, `missChance`, `fieldSnapshot` |65
| `src/gameCore.js` | Simulatie: vallen, wisselen, match-3, raketsprong, linken, push-up + her-sprong, landen als starre groep + 3 s wachten, kolom-slot, game over, punten; stage 2: `outgoingShots`, `ingestGarbage`, `missChance`, `fieldSnapshot` |@@ -111,6 +115,30 @@ staan in `server/lib/planets.json`. De blokplaatjes zijn unieke111
placeholders (`build/images/block-{planeet}-{kleur}.png`); Tim kan ze115
placeholders (`build/images/block-{planeet}-{kleur}.png`); Tim kan ze112
zelf vervangen.116
zelf vervangen.113
117
118
## Planeetontwerper119
120
Ingelogde spelers zien op het hoofdmenu hun puntentotaal en de knop121
**Planeetontwerper**. Punten verzamel je door ingelogd te spelen122
(solo aan het einde, elke ronde van Offline Strijd, en Online bij123
uitschakeling). Ze worden niet uitgegeven: bij vaste drempels (Terra124
gratis, daarna 500 punten en elke volgende 14,5 % hoger) ontgrendel125
je extra blokjes.126
127
In de ontwerper maak, bewerk of verwijder je eigen planeten (naam,128
bevolking, de drie sliders voor zwaartekracht / lucht / massa, en129
een live Power-preview met dezelfde formule als in het spel). Vijf130
blokjesvakjes openen een raster van het hele register: blokjes die131
al in een ander vak zitten zijn grijs, vergrendelde blokjes zijn132
grijs mét een slotje.133
134
Eigen planeten kun je in **elke** modus kiezen (Spelen, Offline135
Strijd, Online). Online valideert de server de configuratie en136
deelt een snapshot met de andere spelers.137
138
Lokaal inloggen: `auth.php?test=1`. Op de live site blijft de139
ontwerper verborgen tot OAuth (`callback.php` + CI-geheim140
`auth_client_secret`) is ingesteld.141
114
## Deploy142
## Deploy115
143
116
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.144
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.@@ -763,3 +763,55 @@ Aanname:
763
763
uiteinden, corridors, en de fallSpeed-overdracht. Playwright
764
764
legt early/mid/late vast op 1024×532 en 1920×1080, plus een
765
765
webm van beide formaten.
766
767
768
## t1139 — Planeetontwerper
769
770
- De ontwerper is alleen beschikbaar op het hoofdmenu, en alleen als
771
je bent ingelogd. Tot de live OAuth-callback en het CI-geheim
772
`auth_client_secret` zijn ingericht, is dat op productie onzichtbaar.
773
Lokaal kun je inloggen met `auth.php?test=1` (of `test=2`).
774
- Levenslange punten staan in het server-profiel (`profiles`). Alleen
775
ingelogde spellen tellen mee. Bots leveren geen punten op.
776
- **Spelen** (solo): de score aan het einde van het spel.
777
- **Offline Strijd**: de score van **elke ronde**, gewonnen of
778
verloren, omdat de score per ronde opnieuw begint.
779
- **Online**: de server kent de score via de poll; punten worden
780
toegekend bij uitschakeling of als de lobby klaar is, één keer per
781
`online:{lobbyId}:{userId}`. De client kan hier geen punten
782
insturen.
783
- Anti-cheat voor solo/offline: `play_begin` geeft een eenmalig token
784
(geldig 6 uur). `play_finish` klempt de score op 0–10000, weigert
785
een positieve score als het spel korter dan 3 seconden duurde, en
786
laat maximaal 4 punten per seconde door. Herhaalde finishes van
787
hetzelfde token zijn een no-op. Overduidelijk valsspelen wordt
788
geklemd, niet keihard verboden, zodat een trage verbinding geen
789
eerlijke score weggooit.
790
- Het blokjesregister (`server/lib/blocks.json`) is append-only: de
791
volgorde ligt nu vast. Eerst Terra's vijf (gratis), daarna 43 nieuwe
792
icoontjes (eerste, Fehu, op 500 punten; daarna telkens 14,5 % meer,
793
afgerond en strikt stijgend — de laatste icoon zit rond de 147 000
794
punten), daarna de 55 kleuren van de officiële niet-Terra-planeten
795
als lange staart (de laatste zit in de honderden miljoenen). Punten
796
zijn een **eis**, geen uitgave. Officiële planeten blijven hun eigen
797
blokjes gebruiken zonder ontgrendeling; ontgrendelen is alleen voor
798
de ontwerper.
799
- Een speler mag tot 30 eigen planeten hebben. Id's zijn `c_` plus
800
16 hex-tekens. Namen (planeet en volk) zijn 1–32 tekens, zonder
801
tags. De vijf blokjes moeten verschillend en ontgrendeld zijn.
802
- Nieuwe blokjes-plaatjes staan in `build/images/block-*.png`, 64×64,
803
in dezelfde stijl als Terra (gekleurde silhouet, donkere omtrek,
804
highlight, slagschaduw). Gegenereerd door
805
`scripts/gen_unlock_blocks.py`.
806
807
## t1140 — Eigen planeten in elke modus
808
809
- In Spelen, Offline Strijd en Online Spelen toont de planeetkiezer
810
naast de officiële catalogus ook **je eigen** ontworpen planeten
811
(badge "Eigen"). Planeten van anderen staan daar niet in.
812
- Voor Online stuurt de client alleen het planeet-id. De server
813
controleert eigendom, legt een **snapshot** (`planet_json`) vast bij
814
kiezen/aanmaken/joinen, en stuurt de volledige configuratie
815
(variabelen, kleuren, `miss_chance`) mee in de lobby. Tegenstanders
816
onthouden die snapshot om fysica, miss-kans en sprites te simuleren;
817
een latere wijziging of verwijdering verandert een lopend spel niet.
@@ -763,3 +763,55 @@ Aanname:763
uiteinden, corridors, en de fallSpeed-overdracht. Playwright763
uiteinden, corridors, en de fallSpeed-overdracht. Playwright764
legt early/mid/late vast op 1024×532 en 1920×1080, plus een764
legt early/mid/late vast op 1024×532 en 1920×1080, plus een765
webm van beide formaten.765
webm van beide formaten.766
767
768
## t1139 — Planeetontwerper769
770
- De ontwerper is alleen beschikbaar op het hoofdmenu, en alleen als771
je bent ingelogd. Tot de live OAuth-callback en het CI-geheim772
`auth_client_secret` zijn ingericht, is dat op productie onzichtbaar.773
Lokaal kun je inloggen met `auth.php?test=1` (of `test=2`).774
- Levenslange punten staan in het server-profiel (`profiles`). Alleen775
ingelogde spellen tellen mee. Bots leveren geen punten op.776
- **Spelen** (solo): de score aan het einde van het spel.777
- **Offline Strijd**: de score van **elke ronde**, gewonnen of778
verloren, omdat de score per ronde opnieuw begint.779
- **Online**: de server kent de score via de poll; punten worden780
toegekend bij uitschakeling of als de lobby klaar is, één keer per781
`online:{lobbyId}:{userId}`. De client kan hier geen punten782
insturen.783
- Anti-cheat voor solo/offline: `play_begin` geeft een eenmalig token784
(geldig 6 uur). `play_finish` klempt de score op 0–10000, weigert785
een positieve score als het spel korter dan 3 seconden duurde, en786
laat maximaal 4 punten per seconde door. Herhaalde finishes van787
hetzelfde token zijn een no-op. Overduidelijk valsspelen wordt788
geklemd, niet keihard verboden, zodat een trage verbinding geen789
eerlijke score weggooit.790
- Het blokjesregister (`server/lib/blocks.json`) is append-only: de791
volgorde ligt nu vast. Eerst Terra's vijf (gratis), daarna 43 nieuwe792
icoontjes (eerste, Fehu, op 500 punten; daarna telkens 14,5 % meer,793
afgerond en strikt stijgend — de laatste icoon zit rond de 147 000794
punten), daarna de 55 kleuren van de officiële niet-Terra-planeten795
als lange staart (de laatste zit in de honderden miljoenen). Punten796
zijn een **eis**, geen uitgave. Officiële planeten blijven hun eigen797
blokjes gebruiken zonder ontgrendeling; ontgrendelen is alleen voor798
de ontwerper.799
- Een speler mag tot 30 eigen planeten hebben. Id's zijn `c_` plus800
16 hex-tekens. Namen (planeet en volk) zijn 1–32 tekens, zonder801
tags. De vijf blokjes moeten verschillend en ontgrendeld zijn.802
- Nieuwe blokjes-plaatjes staan in `build/images/block-*.png`, 64×64,803
in dezelfde stijl als Terra (gekleurde silhouet, donkere omtrek,804
highlight, slagschaduw). Gegenereerd door805
`scripts/gen_unlock_blocks.py`.806
807
## t1140 — Eigen planeten in elke modus808
809
- In Spelen, Offline Strijd en Online Spelen toont de planeetkiezer810
naast de officiële catalogus ook **je eigen** ontworpen planeten811
(badge "Eigen"). Planeten van anderen staan daar niet in.812
- Voor Online stuurt de client alleen het planeet-id. De server813
controleert eigendom, legt een **snapshot** (`planet_json`) vast bij814
kiezen/aanmaken/joinen, en stuurt de volledige configuratie815
(variabelen, kleuren, `miss_chance`) mee in de lobby. Tegenstanders816
onthouden die snapshot om fysica, miss-kans en sprites te simuleren;817
een latere wijziging of verwijdering verandert een lopend spel niet.