# Meteors Puzzelspel voor het web, zwaar geïnspireerd door *Meteos* (Nintendo DS). Gebouwd op [frameworkv3](https://git.timfalken.com/timfa/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 ```bash # 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. | Pad | Rol | | --- | --- | | `src/planet.js` | Planeet: zwaartekracht, luchtweerstand, massa, kleuren/vormen, spronghoogte, Power | | `src/rng.js` | Seedable RNG (tests en later replays) | | `src/gameCore.js` | Simulatie: vallen, wisselen, match-3, raketsprong, linken, push-up + her-sprong, landen + 3 s wachten, kolom-slot, game over, punten | | `src/main.js` | Menu, HUD, frameworkv3-scene, muis/touch, schaal naar het scherm | | `src/build.sh` | Concateneert 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).