BlueGit

projects-timfalken-com meteors

Files

meteors / README.md

README.md

README.md 4.9 KiB Download Raw

Meteors

Puzzelspel voor het web, zwaar geïnspireerd door Meteos (Nintendo DS). Gebouwd op frameworkv3 (WebGL). Speelbaar met muis op desktop en met touch op mobiel, ook in portretstand.

Live (na de eerste deploy): https://projects.timfalken.com/meteors/

Spelen

1. Open build/index.html (lokaal of live) en druk op Spelen. 2. Elke seconde valt er een blokje van één van vijf kleuren in een willekeurige kolom. 3. In een stilliggende kolom sleep je blokjes verticaal; ze wisselen om met de blokjes waar je langs gaat. 4. Drie of meer blokjes van dezelfde kleur op een rij (horizontaal of verticaal) worden donkergrijs, krijgen een vlam en springen omhoog. Alles wat erop stond, vliegt mee. 5. Blokjes die boven de bovenrand van het veld (10×13) verdwijnen, leveren punten op. 6. Trek een blokje naar de top van zijn kolom en dan nóg verder omhoog: het springt tot net onder de bovenrand. Is het blokje al het bovenste van de kolom, dan is een trek voorbij zijn eigen positie genoeg (muis en touch). Komt het tegen een vliegend cluster aan, dan duwt het die kolom één tegel omhoog. Vormt dat een nieuwe drie-op-een-rij, dan springt het hele cluster opnieuw. 7. Een vallend (gespawnd) blokje landt op een vliegende cluster in dezelfde kolom en vliegt als vracht mee. 8. Een gelande grijze cluster blijft als starre groep liggen — een deel kan boven een gat blijven hangen — tot de blokjes na 3 seconden een kleur terugkrijgen. Daarna vallen ongesteunde blokjes afzonderlijk naar beneden. 9. Een kolom die van onder tot boven vol ligt, gaat op slot (donkergrijs, geen interactie, geen nieuwe val). Zitten alle tien kolommen vast, dan is het spel voorbij en ga je terug naar het menu.

Het standaardveld is de planeet Terra (volk: Terrans), met middelmatige zwaartekracht, luchtweerstand en massa. Die drie waarden, plus de Power, staan in de HUD; later (stage 3) kies je zelf een planeet.

Lokaal bouwen en draaien

# Eenmalig / bij een framework-update: bundel frameworkv3 en kopieer hem.
# cd /pad/naar/frameworkv3 && ./glbuild.sh
# cp js/framework.js /pad/naar/meteors/build/framework.js

# Tests
node --test test/*.test.js

# Game-bundel (src/ → build/game.js)
./src/build.sh
# of: npm run build

# Placeholder-plaatjes opnieuw maken (optioneel; Tim kan ze zelf vervangen)
python3 scripts/make-placeholders.py

# Statische server
python3 -m http.server 8080 --directory build
# spel: http://localhost:8080/

Architectuur

De spelkern is deterministisch en staat los van tekenen en invoer, zodat stage 2 (multiplayer) dezelfde simulatie kan hergebruiken.

PadRol
src/planet.jsPlaneet: zwaartekracht, luchtweerstand, massa, kleuren/vormen, spronghoogte, Power, apex-ease, bounce
src/rng.jsSeedable RNG (tests en later replays)
src/easing.jsQt-eases (easeOutBack / easeOutElastic) en Click-Tween-defaults voor de selectie-animatie
src/gameCore.jsSimulatie: vallen, wisselen, match-3, raketsprong, linken, push-up + her-sprong, landen als starre groep + 3 s wachten, kolom-slot, game over, punten
src/main.jsMenu, HUD, frameworkv3-scene, muis/touch, schaal naar het scherm, landing-bounce, selectie-tween
docs/ASSUMPTIONS.mdIngevulde aannames waar de specificatie ruimte liet
src/build.shConcateneert de bronnen naar build/game.js (zelfde patroon als de raytracer)
build/Speelbare output: index.html, style.css, framework.js, game.js, images/
test/Unit tests (node --test) voor de kern en de deploy-guard
ci/FTP-deploy, zonder --delete. Expandeert $timftproot zelf. Weigert een map die niet leeg is of niet van Meteors is.

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.

Deploy

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.

Secrets: timftphost / timftpuser / timftppassword / timftproot (groep), projectftp (dit project).

Source
1# Meteors
2
3Puzzelspel voor het web, zwaar geïnspireerd door *Meteos* (Nintendo DS). Gebouwd op
4[frameworkv3](https://git.timfalken.com/timfa/frameworkv3) (WebGL). Speelbaar met
5muis op desktop en met touch op mobiel, ook in portretstand.
6
7Live (na de eerste deploy): https://projects.timfalken.com/meteors/
8
9## Spelen
10
111. Open `build/index.html` (lokaal of live) en druk op **Spelen**.
122. Elke seconde valt er een blokje van één van vijf kleuren in een willekeurige kolom.
133. In een stilliggende kolom sleep je blokjes verticaal; ze wisselen om met de blokjes waar je langs gaat.
144. Drie of meer blokjes van dezelfde kleur op een rij (horizontaal of verticaal) worden donkergrijs, krijgen een vlam en springen omhoog. Alles wat erop stond, vliegt mee.
155. Blokjes die boven de bovenrand van het veld (10×13) verdwijnen, leveren punten op.
166. Trek een blokje naar de top van zijn kolom en dan nóg verder omhoog: het springt tot net onder de bovenrand. Is het blokje al het bovenste van de kolom, dan is een trek voorbij zijn eigen positie genoeg (muis en touch). Komt het tegen een vliegend cluster aan, dan duwt het die kolom één tegel omhoog. Vormt dat een nieuwe drie-op-een-rij, dan springt het hele cluster opnieuw.
177. Een vallend (gespawnd) blokje landt op een vliegende cluster in dezelfde kolom en vliegt als vracht mee.
188. Een gelande grijze cluster blijft als starre groep liggen — een deel kan boven een gat blijven hangen — tot de blokjes na 3 seconden een kleur terugkrijgen. Daarna vallen ongesteunde blokjes afzonderlijk naar beneden.
199. Een kolom die van onder tot boven vol ligt, gaat op slot (donkergrijs, geen interactie, geen nieuwe val). Zitten alle tien kolommen vast, dan is het spel voorbij en ga je terug naar het menu.
20
21Het standaardveld is de planeet **Terra** (volk: Terrans), met middelmatige zwaartekracht, luchtweerstand en massa. Die drie waarden, plus de Power, staan in de HUD; later (stage 3) kies je zelf een planeet.
22
23## Lokaal bouwen en draaien
24
25```bash
26# Eenmalig / bij een framework-update: bundel frameworkv3 en kopieer hem.
27# cd /pad/naar/frameworkv3 && ./glbuild.sh
28# cp js/framework.js /pad/naar/meteors/build/framework.js
29
30# Tests
31node --test test/*.test.js
32
33# Game-bundel (src/ → build/game.js)
34./src/build.sh
35# of: npm run build
36
37# Placeholder-plaatjes opnieuw maken (optioneel; Tim kan ze zelf vervangen)
38python3 scripts/make-placeholders.py
39
40# Statische server
41python3 -m http.server 8080 --directory build
42# spel: http://localhost:8080/
43```
44
45## Architectuur
46
47De spelkern is deterministisch en staat los van tekenen en invoer, zodat stage 2
48(multiplayer) dezelfde simulatie kan hergebruiken.
49
50| Pad | Rol |
51| --- | --- |
52| `src/planet.js` | Planeet: zwaartekracht, luchtweerstand, massa, kleuren/vormen, spronghoogte, Power, apex-ease, bounce |
53| `src/rng.js` | Seedable RNG (tests en later replays) |
54| `src/easing.js` | Qt-eases (easeOutBack / easeOutElastic) en Click-Tween-defaults voor de selectie-animatie |
55| `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 |
56| `src/main.js` | Menu, HUD, frameworkv3-scene, muis/touch, schaal naar het scherm, landing-bounce, selectie-tween |
57| `docs/ASSUMPTIONS.md` | Ingevulde aannames waar de specificatie ruimte liet |
58| `src/build.sh` | Concateneert de bronnen naar `build/game.js` (zelfde patroon als de raytracer) |
59| `build/` | Speelbare output: `index.html`, `style.css`, `framework.js`, `game.js`, `images/` |
60| `test/` | Unit tests (`node --test`) voor de kern en de deploy-guard |
61| `ci/` | FTP-deploy, **zonder** `--delete`. Expandeert `$timftproot` zelf. Weigert een map die niet leeg is of niet van Meteors is. |
62
63Sprongfysica 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`.
64
65## Deploy
66
67BlueGit 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.
68
69Secrets: `timftphost` / `timftpuser` / `timftppassword` / `timftproot` (groep), `projectftp` (dit project).