BlueGit

projects-timfalken-com meteors

Files

meteors / README.md

README.md

README.md 3.8 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. 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 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
src/rng.jsSeedable RNG (tests en later replays)
src/gameCore.jsSimulatie: vallen, wisselen, match-3, raketsprong, linken, push-up + her-sprong, landen + 3 s wachten, kolom-slot, game over, punten
src/main.jsMenu, HUD, frameworkv3-scene, muis/touch, schaal naar het scherm
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); de luchtweerstand bepaalt de constante valsnelheid daarna.

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. 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 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.
18
19Het 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.
20
21## Lokaal bouwen en draaien
22
23```bash
24# Eenmalig / bij een framework-update: bundel frameworkv3 en kopieer hem.
25# cd /pad/naar/frameworkv3 && ./glbuild.sh
26# cp js/framework.js /pad/naar/meteors/build/framework.js
27
28# Tests
29node --test test/*.test.js
30
31# Game-bundel (src/ → build/game.js)
32./src/build.sh
33# of: npm run build
34
35# Placeholder-plaatjes opnieuw maken (optioneel; Tim kan ze zelf vervangen)
36python3 scripts/make-placeholders.py
37
38# Statische server
39python3 -m http.server 8080 --directory build
40# spel: http://localhost:8080/
41```
42
43## Architectuur
44
45De spelkern is deterministisch en staat los van tekenen en invoer, zodat stage 2
46(multiplayer) dezelfde simulatie kan hergebruiken.
47
48| Pad | Rol |
49| --- | --- |
50| `src/planet.js` | Planeet: zwaartekracht, luchtweerstand, massa, kleuren/vormen, spronghoogte, Power |
51| `src/rng.js` | Seedable RNG (tests en later replays) |
52| `src/gameCore.js` | Simulatie: vallen, wisselen, match-3, raketsprong, linken, push-up + her-sprong, landen + 3 s wachten, kolom-slot, game over, punten |
53| `src/main.js` | Menu, HUD, frameworkv3-scene, muis/touch, schaal naar het scherm |
54| `src/build.sh` | Concateneert de bronnen naar `build/game.js` (zelfde patroon als de raytracer) |
55| `build/` | Speelbare output: `index.html`, `style.css`, `framework.js`, `game.js`, `images/` |
56| `test/` | Unit tests (`node --test`) voor de kern en de deploy-guard |
57| `ci/` | FTP-deploy, **zonder** `--delete`. Expandeert `$timftproot` zelf. Weigert een map die niet leeg is of niet van Meteors is. |
58
59Sprongfysica 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); de luchtweerstand bepaalt de constante valsnelheid daarna.
60
61## Deploy
62
63BlueGit 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.
64
65Secrets: `timftphost` / `timftpuser` / `timftppassword` / `timftproot` (groep), `projectftp` (dit project).