BlueGit

projects-timfalken-com meteors

docs: Planeetontwerper, unlocks and custom planets (t1139, t1140)

timfa Grok Bot · pushed by timfa

Authored 2026-11-13 · 4 days ago

Hash
0c164d970bc1e5841a81b0cbb242a650c6cd31a3
Parent
2483c97c
2 files changed +80 −0
README.md +28 −0
@@ -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 2
56| 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 unieke
111placeholders (`build/images/block-{planeet}-{kleur}.png`); Tim kan ze
115placeholders (`build/images/block-{planeet}-{kleur}.png`); Tim kan ze
112zelf vervangen.
116zelf vervangen.
113
117
118## Planeetontwerper
119
120Ingelogde 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
123uitschakeling). Ze worden niet uitgegeven: bij vaste drempels (Terra
124gratis, daarna 500 punten en elke volgende 14,5 % hoger) ontgrendel
125je extra blokjes.
126
127In de ontwerper maak, bewerk of verwijder je eigen planeten (naam,
128bevolking, de drie sliders voor zwaartekracht / lucht / massa, en
129een live Power-preview met dezelfde formule als in het spel). Vijf
130blokjesvakjes openen een raster van het hele register: blokjes die
131al in een ander vak zitten zijn grijs, vergrendelde blokjes zijn
132grijs mét een slotje.
133
134Eigen planeten kun je in **elke** modus kiezen (Spelen, Offline
135Strijd, Online). Online valideert de server de configuratie en
136deelt een snapshot met de andere spelers.
137
138Lokaal inloggen: `auth.php?test=1`. Op de live site blijft de
139ontwerper verborgen tot OAuth (`callback.php` + CI-geheim
140`auth_client_secret`) is ingesteld.
141
114## Deploy
142## Deploy
115
143
116BlueGit 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.
144BlueGit 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.
docs/ASSUMPTIONS.md +52 −0
@@ -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. Playwright
763 uiteinden, corridors, en de fallSpeed-overdracht. Playwright
764 legt early/mid/late vast op 1024×532 en 1920×1080, plus een
764 legt early/mid/late vast op 1024×532 en 1920×1080, plus een
765 webm van beide formaten.
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.