# raytracer

Wolfenstein-achtige raycaster op [frameworkv3](https://git.timfalken.com/timfa/frameworkv3) (WebGL), met **paperdoll-NPC’s** (`.ppda` + atlassen, live body+equipment-compositor).

## 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-bundel
./src/build.sh

# Statische server (moet paperdolls/ kunnen serveren)
python3 -m http.server 8080 --directory build
# open http://localhost:8080
```

Besturing: WASD / pijltjes, klik voor pointer-lock, `<` `>` voor raycast-resolutie.

## Paperdolls

- Assets in `build/paperdolls/` (body + sword). Zie `build/paperdolls/ATTRIBUTION.md`.
- Depth-atlassen liggen als `.u16` (little-endian gray+alpha u16) naast de `.ppda` — browsers decoderen 16-bit PNG niet betrouwbaar.
- Live compositor (JS-poort van `compositor.rs`): per pixel dichtstbijzijnde diepte; bij gelijke diepte (±1) wint de eerdere laag (body vóór gear).
- NPC-billboards: yaw uit hoek speler↔NPC, frame via fps, per-pixel z-buffer t.o.v. muren en andere sprites; één overlay-texture per frame (CPU-projectie).

## Tests

```bash
node --test test/*.test.js
```

## Structuur

- `src/` – game + `src/ppda/` (loader, depth, view/frame, compositor, atlas-runtime)
- `build/` – speelbare output
- `archive/legacy-js/` – oude canvas2d-versie
