# raytracer Wolfenstein-achtige raycaster op [frameworkv3](https://git.timfalken.com/timfa/frameworkv3) (WebGL), met **paperdoll-NPC’s**, **vloer/plafond-casting** en een **level-editor**. ## Lokaal bouwen en draaien ```bash # Framework-bundel (eenmalig / bij framework-update) cd /pad/naar/frameworkv3 && ./glbuild.sh cp js/framework.js /pad/naar/raytracer/build/framework.js # Game- + editor-bundel ./src/build.sh # Statische server python3 -m http.server 8080 --directory build # spel: http://localhost:8080/ # editor: http://localhost:8080/editor.html # level: http://localhost:8080/?level=level-1 ``` Besturing: WASD / pijltjes, klik voor pointer-lock, `<` `>` voor raycast-resolutie. HUD: vorige/volgende level. ## Levels (`build/levels.json`) Schema **format_version: 1**: - `textures[]` – id + url (nu `stone` / `wood`, dezelfde set als muren) - `levels[]` – per level: `id`, `name`, `width`/`height`, `cellSize`, `spawn{tileX,tileY,yawRad}`, `walls[]`, `floors[]`, `ceilings[]` (textuur-id of `null` = zwart), `npcs[]`, `lights[]` (nog leeg; gereserveerd) Validatie en legacy-migratie: `src/levelFormat.js`. ## Vloer / plafond Klassieke floor/ceiling casting (Lode-stijl) op de CPU → `ImageData` → één NEAREST WebGL-quad **onder** de muren. Motief: frameworkv3 is WebGL1-sprites zonder gedeelde depth buffer; een grid-data-texture-shader zou draw-order/z-buffer van paperdolls breken. Scanlines met 2×2 NEAREST-blocks houden het performant. Tiles zonder floor/ceiling blijven zwart/clear. ## Level-editor `build/editor.html`: meerdere levels toevoegen/hernoemen/verwijderen/dupliceren, grootte, muur/vloer/plafond schilderen (klik/sleep + texture-previews), spawn + NPC’s, download/upload JSON, localStorage, **Speel dit level**. Lampen volgen in een latere stap (`lights[]` staat al in het formaat). ## Paperdolls - Assets in `build/paperdolls/` (body + sword). Zie `build/paperdolls/ATTRIBUTION.md`. - Depth-atlassen als `.u16` (LE gray+alpha) naast de `.ppda`. - Live compositor + per-pixel z-buffer t.o.v. muren. ## Tests ```bash node --test test/*.test.js ``` ## Structuur - `src/` – game, `levelFormat.js`, `floorCast.js`, `editorApp.js`, `src/ppda/` - `build/` – speelbare output + `levels.json` + `editor.html` - `archive/legacy-js/` – oude canvas2d-versie