create-threenative 0.2.17 → 0.2.20
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agent-docs/kit-mcp.md +1 -1
- package/agent-docs/kit-router.md +1 -1
- package/agent-docs/references/assertion-reference.md +54 -110
- package/agent-docs/references/capability-reference.md +790 -24
- package/agent-docs/references/conventions.md +28 -0
- package/agent-docs/references/kit-racing.md +4 -2
- package/agent-docs/references/performance-basics.md +10 -5
- package/agent-docs/references/terrain-authoring.md +21 -7
- package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
- package/agent-files/.agents/skills/prd-creator/SKILL.md +24 -0
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +7 -4
- package/agent-files/.claude/hooks/discovery-gate.mjs +2 -2
- package/dist/index.d.ts +97 -6
- package/dist/index.js +1040 -529
- package/dist/quality.d.ts +5 -1
- package/dist/quality.js +75 -6
- package/dist/terrain-kit.js +1 -1
- package/dist/threenative.js +98 -17
- package/dist/web-engine-ccd-ik-solver.js +127 -0
- package/dist/web-engine-gltf-loader.js +52 -14
- package/dist/web-engine-post-effects.js +11 -10
- package/dist/web-engine-runtime.js +3638 -361
- package/package.json +8 -7
- package/template-assets/assets/floor-fern-0.glb +0 -0
- package/template-assets/assets/floor-litter-0.glb +0 -0
- package/template-assets/assets/floor-log-0.glb +0 -0
- package/template-assets/assets/floor-log-1.glb +0 -0
- package/template-assets/assets/floor-stump-0.glb +0 -0
- package/template-assets/assets/floor-twig-0.glb +0 -0
- package/template-assets/clearwater/README.md +1 -1
- package/template-assets/patches/manifest.json +18 -0
- package/template-assets/quality/eslint.config.js +1 -1
- package/templates/action-rpg/AGENTS.md +8 -4
- package/templates/action-rpg/CLAUDE.md +8 -4
- package/templates/action-rpg/package.json +7 -7
- package/templates/action-rpg/src/game.ts +1 -1
- package/templates/action-rpg/src/loot/drops.ts +3 -7
- package/templates/action-rpg/src/render/atmosphere.ts +6 -0
- package/templates/action-rpg/src/render/backlightControls.ts +10 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +4 -4
- package/templates/action-rpg/src/render/camera.ts +2 -2
- package/templates/action-rpg/src/render/clouds.ts +16 -1
- package/templates/action-rpg/src/render/materialLighting.ts +5 -5
- package/templates/action-rpg/src/render/materials.ts +3 -2
- package/templates/action-rpg/src/render/quality.ts +7 -32
- package/templates/action-rpg/src/render/touch-controls.ts +7 -6
- package/templates/action-rpg/src/scenes/Play.ts +5 -16
- package/templates/action-rpg/src/style.css +4 -0
- package/templates/action-rpg/vite.config.ts +2 -0
- package/templates/adventure/AGENTS.md +10 -5
- package/templates/adventure/CLAUDE.md +10 -5
- package/templates/adventure/kit.json +5 -1
- package/templates/adventure/native-playtests/survives.playtest.json +12 -0
- package/templates/adventure/native-playtests/woodland-floor.playtest.json +61 -0
- package/templates/adventure/package.json +7 -7
- package/templates/adventure/playtests/grass.playtest.json +61 -0
- package/templates/adventure/playtests/performance.playtest.json +1 -1
- package/templates/adventure/playtests/survives.playtest.json +2 -2
- package/templates/adventure/playtests/woodland-floor.playtest.json +61 -0
- package/templates/adventure/src/entities/LockOn.ts +42 -4
- package/templates/adventure/src/entities/Warden.ts +4 -1
- package/templates/adventure/src/game.ts +1 -1
- package/templates/adventure/src/level/Vale.ts +241 -16
- package/templates/adventure/src/render/camera.ts +2 -2
- package/templates/adventure/src/render/foliage.ts +64 -20
- package/templates/adventure/src/render/grass.ts +325 -0
- package/templates/adventure/src/render/materials.ts +3 -2
- package/templates/adventure/src/render/palette.ts +3 -0
- package/templates/adventure/src/render/touch-controls.ts +4 -1
- package/templates/adventure/src/scenes/Play.ts +96 -1
- package/templates/adventure/src/style.css +4 -0
- package/templates/adventure/tsconfig.json +1 -1
- package/templates/adventure/vite.config.ts +2 -0
- package/templates/collectathon/AGENTS.md +7 -2
- package/templates/collectathon/CLAUDE.md +7 -2
- package/templates/collectathon/package.json +7 -7
- package/templates/collectathon/src/game.ts +1 -1
- package/templates/collectathon/src/level/Course.ts +55 -14
- package/templates/collectathon/src/level/terrain.ts +29 -7
- package/templates/collectathon/src/main.ts +1 -0
- package/templates/collectathon/src/render/camera.ts +2 -2
- package/templates/collectathon/src/render/foliage.ts +359 -98
- package/templates/collectathon/src/render/ground.ts +4 -4
- package/templates/collectathon/src/render/hero.ts +1 -1
- package/templates/collectathon/src/render/materials.ts +0 -1
- package/templates/collectathon/src/render/sky.ts +80 -15
- package/templates/collectathon/src/render/water.ts +32 -10
- package/templates/collectathon/src/scenes/Play.ts +18 -5
- package/templates/collectathon/src/style.css +4 -0
- package/templates/collectathon/tsconfig.json +1 -1
- package/templates/collectathon/vite.config.ts +2 -0
- package/templates/kart/AGENTS.md +7 -2
- package/templates/kart/CLAUDE.md +7 -2
- package/templates/kart/package.json +6 -6
- package/templates/kart/src/entities/Kart.ts +2 -1
- package/templates/kart/src/game.ts +1 -1
- package/templates/kart/src/main.ts +1 -0
- package/templates/kart/src/render/course.ts +2 -1
- package/templates/kart/src/style.css +4 -0
- package/templates/kart/src/track/Course.ts +3 -1
- package/templates/kart/tsconfig.json +1 -1
- package/templates/kart/vite.config.ts +2 -0
- package/templates/minimal/AGENTS.md +8 -3
- package/templates/minimal/CLAUDE.md +8 -3
- package/templates/minimal/package.json +6 -6
- package/templates/minimal/playtests/stands-still.playtest.json +30 -0
- package/templates/minimal/src/game.ts +1 -1
- package/templates/minimal/src/render/atmosphere.ts +6 -0
- package/templates/minimal/src/render/backlightControls.ts +10 -0
- package/templates/minimal/src/render/backlightMaterial.ts +4 -4
- package/templates/minimal/src/render/camera.ts +14 -3
- package/templates/minimal/src/render/clouds.ts +16 -1
- package/templates/minimal/src/render/lighting.ts +4 -2
- package/templates/minimal/src/render/materialLighting.ts +5 -5
- package/templates/minimal/src/render/materials.ts +13 -2
- package/templates/minimal/src/render/quality.ts +7 -32
- package/templates/minimal/src/render/touch-controls.ts +7 -6
- package/templates/minimal/src/scenes/Play.ts +4 -1
- package/templates/minimal/vite.config.ts +7 -1
- package/templates/platformer/AGENTS.md +9 -4
- package/templates/platformer/CLAUDE.md +9 -4
- package/templates/platformer/index.html +1 -1
- package/templates/platformer/main.html +12 -0
- package/templates/platformer/package.json +7 -7
- package/templates/platformer/playtests/collect.playtest.json +4 -1
- package/templates/platformer/playtests/gamepad-idle.playtest.json +21 -0
- package/templates/platformer/playtests/gamepad.playtest.json +30 -0
- package/templates/platformer/src/entities/Fox.ts +21 -6
- package/templates/platformer/src/game.ts +1 -1
- package/templates/platformer/src/level/Stage.ts +2 -6
- package/templates/platformer/src/main.ts +1 -0
- package/templates/platformer/src/render/backlightControls.ts +10 -0
- package/templates/platformer/src/render/backlightMaterial.ts +4 -4
- package/templates/platformer/src/render/materialLighting.ts +5 -5
- package/templates/platformer/src/render/quality.ts +7 -32
- package/templates/platformer/src/scenes/Play.ts +4 -2
- package/templates/platformer/src/style.css +4 -0
- package/templates/platformer/src/worker-page.ts +29 -0
- package/templates/platformer/src/worker.ts +5 -0
- package/templates/platformer/tsconfig.json +1 -1
- package/templates/platformer/vite.config.ts +4 -0
- package/templates/puzzle/AGENTS.md +7 -2
- package/templates/puzzle/CLAUDE.md +7 -2
- package/templates/puzzle/package.json +7 -7
- package/templates/puzzle/src/entities/Warden.ts +3 -3
- package/templates/puzzle/src/game.ts +1 -1
- package/templates/puzzle/src/render/backlightControls.ts +10 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +4 -4
- package/templates/puzzle/src/render/camera.ts +2 -2
- package/templates/puzzle/src/render/materialLighting.ts +5 -5
- package/templates/puzzle/src/render/quality.ts +7 -32
- package/templates/puzzle/src/render/touch-controls.ts +7 -6
- package/templates/puzzle/src/scenes/Play.ts +1 -1
- package/templates/puzzle/src/style.css +4 -0
- package/templates/puzzle/tsconfig.json +1 -1
- package/templates/puzzle/vite.config.ts +2 -0
- package/templates/racing/AGENTS.md +9 -4
- package/templates/racing/CLAUDE.md +9 -4
- package/templates/racing/CREDITS.md +29 -0
- package/templates/racing/assets/engine-loop.wav +0 -0
- package/templates/racing/assets/grass/Grass004_color.jpg +0 -0
- package/templates/racing/assets/grass/Grass004_normal.jpg +0 -0
- package/templates/racing/assets/grass/Grass004_roughness.jpg +0 -0
- package/templates/racing/assets/nitro-burst.wav +0 -0
- package/templates/racing/assets/tyre-squeal.wav +0 -0
- package/templates/racing/package.json +7 -7
- package/templates/racing/playtests/drift-natural.playtest.json +68 -0
- package/templates/racing/playtests/drift.playtest.json +100 -0
- package/templates/racing/playtests/hud.playtest.json +117 -0
- package/templates/racing/playtests/launch-pose.playtest.json +34 -0
- package/templates/racing/playtests/nitro.playtest.json +158 -0
- package/templates/racing/playtests/outcome.playtest.json +4 -4
- package/templates/racing/playtests/performance.playtest.json +1 -1
- package/templates/racing/playtests/steady-camera.playtest.json +88 -0
- package/templates/racing/src/audio/engine.ts +138 -0
- package/templates/racing/src/entities/CarBody.ts +83 -10
- package/templates/racing/src/entities/Drift.ts +243 -0
- package/templates/racing/src/entities/LineDriver.ts +2 -2
- package/templates/racing/src/entities/Nitro.ts +72 -0
- package/templates/racing/src/entities/RacingCar.ts +86 -21
- package/templates/racing/src/entities/Rival.ts +35 -21
- package/templates/racing/src/game.ts +7 -1
- package/templates/racing/src/gauges.ts +74 -0
- package/templates/racing/src/render/atmosphere.ts +6 -0
- package/templates/racing/src/render/backlightControls.ts +10 -0
- package/templates/racing/src/render/backlightMaterial.ts +4 -4
- package/templates/racing/src/render/camera.ts +29 -4
- package/templates/racing/src/render/clouds.ts +16 -1
- package/templates/racing/src/render/effects.ts +244 -0
- package/templates/racing/src/render/materialLighting.ts +5 -5
- package/templates/racing/src/render/materials.ts +43 -8
- package/templates/racing/src/render/quality.ts +7 -32
- package/templates/racing/src/render/shapes.ts +37 -0
- package/templates/racing/src/render/skids.ts +84 -0
- package/templates/racing/src/render/touch-controls.ts +10 -10
- package/templates/racing/src/scenes/Race.ts +281 -26
- package/templates/racing/src/state.ts +35 -0
- package/templates/racing/src/style.css +7 -0
- package/templates/racing/src/track/Track.ts +132 -58
- package/templates/racing/src/track/TrackSector.ts +19 -1
- package/templates/racing/src/track/circuit.ts +21 -15
- package/templates/racing/src/ui/GameUi.tsx +0 -2
- package/templates/racing/src/ui/Hud.tsx +417 -50
- package/templates/racing/threenative.config.ts +15 -0
- package/templates/racing/tools/make-racing-audio.mjs +388 -0
- package/templates/racing/tsconfig.json +1 -1
- package/templates/racing/vite.config.ts +2 -0
- package/templates/rain/AGENTS.md +6 -2
- package/templates/rain/CLAUDE.md +6 -2
- package/templates/rain/package.json +6 -6
- package/templates/rain/src/game.ts +1 -1
- package/templates/rain/src/render/noise-volume.ts +2 -1
- package/templates/rain/src/state.ts +3 -1
- package/templates/rain/src/ui/GameUi.tsx +1 -1
- package/templates/rain/src/ui/automation.ts +10 -8
- package/templates/rain/src/ui/tempest.ts +3 -4
- package/templates/rain/vite.config.ts +6 -0
- package/templates/rts/AGENTS.md +6 -2
- package/templates/rts/CLAUDE.md +6 -2
- package/templates/rts/package.json +6 -6
- package/templates/rts/src/game.ts +1 -1
- package/templates/rts/src/render/backlightControls.ts +10 -0
- package/templates/rts/src/render/backlightMaterial.ts +4 -4
- package/templates/rts/src/render/materialLighting.ts +5 -5
- package/templates/rts/src/render/quality.ts +7 -31
- package/templates/rts/src/scenes/Play.ts +1 -1
- package/templates/rts/src/sim/terrain.ts +1 -0
- package/templates/rts/src/sim/types.ts +1 -0
- package/templates/rts/src/style.css +4 -0
- package/templates/rts/vite.config.ts +2 -0
- package/templates/runner/AGENTS.md +7 -2
- package/templates/runner/CLAUDE.md +7 -2
- package/templates/runner/package.json +7 -7
- package/templates/runner/src/game.ts +1 -1
- package/templates/runner/src/render/atmosphere.ts +6 -0
- package/templates/runner/src/render/backlightControls.ts +10 -0
- package/templates/runner/src/render/backlightMaterial.ts +4 -4
- package/templates/runner/src/render/clouds.ts +16 -1
- package/templates/runner/src/render/materialLighting.ts +5 -5
- package/templates/runner/src/render/materials.ts +3 -2
- package/templates/runner/src/render/quality.ts +7 -32
- package/templates/runner/src/render/touch-controls.ts +7 -6
- package/templates/runner/src/scenes/Run.ts +8 -10
- package/templates/runner/src/style.css +4 -0
- package/templates/runner/tsconfig.json +1 -1
- package/templates/runner/vite.config.ts +2 -0
- package/templates/sailing/AGENTS.md +7 -2
- package/templates/sailing/CLAUDE.md +7 -2
- package/templates/sailing/package.json +7 -7
- package/templates/sailing/src/game.ts +1 -1
- package/templates/sailing/src/render/backlightControls.ts +10 -0
- package/templates/sailing/src/render/backlightMaterial.ts +4 -4
- package/templates/sailing/src/render/environmentSetup.ts +1 -1
- package/templates/sailing/src/render/materialLighting.ts +5 -5
- package/templates/sailing/src/render/quality.ts +7 -32
- package/templates/sailing/src/render/touch-controls.ts +7 -6
- package/templates/sailing/src/style.css +5 -0
- package/templates/sailing/vite.config.ts +6 -0
- package/templates/shooter/AGENTS.md +6 -2
- package/templates/shooter/CLAUDE.md +6 -2
- package/templates/shooter/package.json +7 -7
- package/templates/shooter/src/game.ts +3 -2
- package/templates/shooter/src/render/atmosphere.ts +6 -0
- package/templates/shooter/src/render/backlightControls.ts +10 -0
- package/templates/shooter/src/render/backlightMaterial.ts +4 -4
- package/templates/shooter/src/render/clouds.ts +16 -1
- package/templates/shooter/src/render/materialLighting.ts +5 -5
- package/templates/shooter/src/render/quality.ts +7 -32
- package/templates/shooter/src/scenes/Play.ts +4 -1
- package/templates/shooter/src/style.css +4 -0
- package/templates/shooter/vite.config.ts +2 -0
- package/templates/snow/AGENTS.md +7 -2
- package/templates/snow/CLAUDE.md +7 -2
- package/templates/snow/package.json +7 -7
- package/templates/snow/src/entities/Explorer.ts +6 -12
- package/templates/snow/src/game.ts +1 -1
- package/templates/snow/src/render/backlightControls.ts +10 -0
- package/templates/snow/src/render/backlightMaterial.ts +4 -4
- package/templates/snow/src/render/bootPrint.ts +3 -1
- package/templates/snow/src/render/camera.ts +3 -2
- package/templates/snow/src/render/materialLighting.ts +5 -5
- package/templates/snow/src/render/quality.ts +7 -32
- package/templates/snow/src/render/scenery.ts +3 -3
- package/templates/snow/src/render/touch-controls.ts +7 -6
- package/templates/snow/src/render/weather.ts +3 -5
- package/templates/snow/src/style.css +5 -0
- package/templates/snow/src/terrain.ts +2 -1
- package/templates/snow/vite.config.ts +6 -0
- package/templates/starter/AGENTS.md +8 -3
- package/templates/starter/CLAUDE.md +8 -3
- package/templates/starter/native-playtests/render-chain.playtest.json +9 -9
- package/templates/starter/package.json +7 -7
- package/templates/starter/src/entities/Crate.ts +5 -2
- package/templates/starter/src/entities/Player.ts +10 -2
- package/templates/starter/src/game.ts +4 -3
- package/templates/starter/src/render/adaptiveQuality.ts +17 -0
- package/templates/starter/src/render/atmosphere.ts +6 -0
- package/templates/starter/src/render/backlightControls.ts +10 -0
- package/templates/starter/src/render/backlightMaterial.ts +4 -4
- package/templates/starter/src/render/camera.ts +2 -2
- package/templates/starter/src/render/clouds.ts +16 -1
- package/templates/starter/src/render/contactShadow.ts +1 -1
- package/templates/starter/src/render/materialLighting.ts +5 -5
- package/templates/starter/src/render/materials.ts +3 -2
- package/templates/starter/src/render/postprocessing.ts +11 -10
- package/templates/starter/src/render/quality.ts +14 -1
- package/templates/starter/src/render/touch-controls.ts +7 -6
- package/templates/starter/src/scenes/Play.ts +13 -17
- package/templates/starter/src/state.ts +2 -0
- package/templates/starter/src/style.css +4 -0
- package/templates/starter/src/ui/Menu.tsx +5 -1
- package/templates/starter/vite.config.ts +2 -0
- package/templates/tower-defense/AGENTS.md +7 -2
- package/templates/tower-defense/CLAUDE.md +7 -2
- package/templates/tower-defense/package.json +7 -7
- package/templates/tower-defense/src/game.ts +1 -1
- package/templates/tower-defense/src/render/backlightControls.ts +10 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +4 -4
- package/templates/tower-defense/src/render/materialLighting.ts +5 -5
- package/templates/tower-defense/src/render/quality.ts +7 -32
- package/templates/tower-defense/src/render/shapes.ts +1 -2
- package/templates/tower-defense/src/scenes/Battle.ts +4 -9
- package/templates/tower-defense/src/style.css +4 -0
- package/templates/tower-defense/tsconfig.json +1 -1
- package/templates/tower-defense/vite.config.ts +2 -0
- package/templates/action-rpg/src/render/environmentContribution.ts +0 -188
- package/templates/action-rpg/src/render/environmentRadiance.ts +0 -36
- package/templates/action-rpg/src/render/environmentSampleCache.ts +0 -43
- package/templates/action-rpg/src/render/environmentSampling.ts +0 -193
- package/templates/action-rpg/src/render/environmentSnapshot.ts +0 -53
- package/templates/minimal/src/render/environmentContribution.ts +0 -188
- package/templates/minimal/src/render/environmentRadiance.ts +0 -36
- package/templates/minimal/src/render/environmentSampleCache.ts +0 -43
- package/templates/minimal/src/render/environmentSampling.ts +0 -193
- package/templates/minimal/src/render/environmentSnapshot.ts +0 -53
- package/templates/platformer/src/render/environmentContribution.ts +0 -188
- package/templates/platformer/src/render/environmentRadiance.ts +0 -36
- package/templates/platformer/src/render/environmentSampleCache.ts +0 -43
- package/templates/platformer/src/render/environmentSampling.ts +0 -193
- package/templates/platformer/src/render/environmentSnapshot.ts +0 -53
- package/templates/puzzle/src/render/environmentContribution.ts +0 -188
- package/templates/puzzle/src/render/environmentRadiance.ts +0 -36
- package/templates/puzzle/src/render/environmentSampleCache.ts +0 -43
- package/templates/puzzle/src/render/environmentSampling.ts +0 -193
- package/templates/puzzle/src/render/environmentSnapshot.ts +0 -53
- package/templates/racing/src/render/environmentContribution.ts +0 -188
- package/templates/racing/src/render/environmentRadiance.ts +0 -36
- package/templates/racing/src/render/environmentSampleCache.ts +0 -43
- package/templates/racing/src/render/environmentSampling.ts +0 -193
- package/templates/racing/src/render/environmentSnapshot.ts +0 -53
- package/templates/racing/src/ui/Menu.tsx +0 -7
- package/templates/rts/src/render/environmentContribution.ts +0 -188
- package/templates/rts/src/render/environmentRadiance.ts +0 -36
- package/templates/rts/src/render/environmentSampleCache.ts +0 -43
- package/templates/rts/src/render/environmentSampling.ts +0 -193
- package/templates/rts/src/render/environmentSnapshot.ts +0 -53
- package/templates/runner/src/render/environmentContribution.ts +0 -188
- package/templates/runner/src/render/environmentRadiance.ts +0 -36
- package/templates/runner/src/render/environmentSampleCache.ts +0 -43
- package/templates/runner/src/render/environmentSampling.ts +0 -193
- package/templates/runner/src/render/environmentSnapshot.ts +0 -53
- package/templates/sailing/src/render/environmentContribution.ts +0 -188
- package/templates/sailing/src/render/environmentRadiance.ts +0 -36
- package/templates/sailing/src/render/environmentSampleCache.ts +0 -43
- package/templates/sailing/src/render/environmentSampling.ts +0 -193
- package/templates/sailing/src/render/environmentSnapshot.ts +0 -53
- package/templates/shooter/src/render/environmentContribution.ts +0 -188
- package/templates/shooter/src/render/environmentRadiance.ts +0 -36
- package/templates/shooter/src/render/environmentSampleCache.ts +0 -43
- package/templates/shooter/src/render/environmentSampling.ts +0 -193
- package/templates/shooter/src/render/environmentSnapshot.ts +0 -53
- package/templates/snow/src/render/environmentContribution.ts +0 -188
- package/templates/snow/src/render/environmentRadiance.ts +0 -36
- package/templates/snow/src/render/environmentSampleCache.ts +0 -43
- package/templates/snow/src/render/environmentSampling.ts +0 -193
- package/templates/snow/src/render/environmentSnapshot.ts +0 -53
- package/templates/starter/src/render/environmentContribution.ts +0 -188
- package/templates/starter/src/render/environmentRadiance.ts +0 -36
- package/templates/starter/src/render/environmentSampleCache.ts +0 -43
- package/templates/starter/src/render/environmentSampling.ts +0 -193
- package/templates/starter/src/render/environmentSnapshot.ts +0 -53
- package/templates/starter/src/render/rendererGate.ts +0 -36
- package/templates/tower-defense/src/render/environmentContribution.ts +0 -188
- package/templates/tower-defense/src/render/environmentRadiance.ts +0 -36
- package/templates/tower-defense/src/render/environmentSampleCache.ts +0 -43
- package/templates/tower-defense/src/render/environmentSampling.ts +0 -193
- package/templates/tower-defense/src/render/environmentSnapshot.ts +0 -53
|
@@ -11,7 +11,7 @@ Detail for each step: `threenative-capabilities` skill. Do the steps in order. A
|
|
|
11
11
|
|
|
12
12
|
1. **Kit** (new game only): `engine_search_capabilities {situation: "<the whole request>", scope: "request"}` returns the matching starter kit first. This folder is already a kit.
|
|
13
13
|
2. **Mechanics**: per mechanic, `engine_search_references {situation}`, then `engine_reference_detail` on each hit for pinned constants and feel. To see a mechanic move, `engine_watch_reference {query: "<game> <mechanic>"}` returns a contact sheet of real gameplay. Borrow mechanics only: no code, level layouts, character names or art. Cite `file:line`.
|
|
14
|
-
3. **Built-ins**: per mechanic, system or symptom, `engine_search_capabilities {situation, scope: "mechanic"}
|
|
14
|
+
3. **Built-ins**: per mechanic, system or symptom, `engine_search_capabilities {situation, scope: "mechanic"}`; rows answer; `engine_capability_detail` only for omitted symbols. Constraints are binding. `verdict: "none"` means the game writes it in `src/`.
|
|
15
15
|
4. **Plan** (new game, or a change to several systems): `prd-creator` with the kit, references and built-ins. With a user, wait for explicit approval, then implement. With no user (`claude -p`, a script), record the plan and assumptions, then continue.
|
|
16
16
|
5. **Assets**: `asset_search_sources`, the source's search tool, then `asset_download_file`; record source and licence in `CREDITS.md`. Nothing fits: `sculpt_plan`. A rigged GLB: `animation_inspect` (`threenative-assets` skill).
|
|
17
17
|
6. **Build**: gameplay in `src/`, look in `src/render/` (`threenative-context` and `threenative-ui` skills). For parallel work, give each subagent one area and its files, then integrate.
|
|
@@ -30,7 +30,7 @@ A change to an existing game repeats steps 2-3 for that change, then steps 5-8.
|
|
|
30
30
|
- `threenative-assets`: a texture, HDRI, sound or model. `asset_search_sources`, `asset_download_file`, `audio_search_assets`, `mesh_optimize`.
|
|
31
31
|
- `threenative-sculpt`: a bespoke mesh or character from a reference image. `sculpt_plan`, `sculpt_spec_gate`, `sculpt_compare`, `sculpt_pass_gate`.
|
|
32
32
|
- `threenative-animation`: a rigged GLB with a held prop, foot slide or loop seam. `animation_inspect`, `animation_attach`, `animation_verify`.
|
|
33
|
-
- `threenative-terrain`:
|
|
33
|
+
- `threenative-terrain`: any terrain, from words. `terrain_generate`.
|
|
34
34
|
- `threenative-devtools`: after `npx @threenative/playtest trace` names no cause. `performance_start_trace`, `performance_analyze_insight`.
|
|
35
35
|
<!-- /shared -->
|
|
36
36
|
|
|
@@ -38,12 +38,12 @@ A change to an existing game repeats steps 2-3 for that change, then steps 5-8.
|
|
|
38
38
|
|
|
39
39
|
<!-- shared: kit-files -->
|
|
40
40
|
Source in `src/`: `entities/`, `game.ts`, `interact.ts`, `level/`, `main.ts`, `render/`, `scenes/`, `state.ts`, `ui/`.
|
|
41
|
-
|
|
41
|
+
17 scenarios in `playtests/`; `playtests/survives.playtest.json` is the smoke proof.
|
|
42
42
|
Kit notes: `node_modules/create-threenative/agent-docs/references/kit-adventure.md`.
|
|
43
43
|
<!-- /shared -->
|
|
44
44
|
|
|
45
|
-
`ADVENTURE_FEEL` in `src/entities/Hero.ts` is Wren's one table of feel constants; `playtests/move.playtest.json` proves it. `src/interact.ts` is the one interact prompt picker. Every model is procedural.
|
|
46
|
-
`pnpm test` proves the web target. Desktop is claimed only where `native-playtests/survives.playtest.json` ran with `--target desktop`; Android and iOS have not run for this kit.
|
|
45
|
+
`ADVENTURE_FEEL` in `src/entities/Hero.ts` is Wren's one table of feel constants; `playtests/move.playtest.json` proves it. `src/interact.ts` is the one interact prompt picker. Every model is procedural except the baked forest-floor props, `assets/floor-*.glb` (PRD-889).
|
|
46
|
+
`pnpm test` proves the web target. Desktop is claimed only where `native-playtests/survives.playtest.json` and `native-playtests/woodland-floor.playtest.json` ran with `--target desktop`; Android and iOS have not run for this kit.
|
|
47
47
|
|
|
48
48
|
<!-- shared: kit-commands -->
|
|
49
49
|
## Commands
|
|
@@ -54,6 +54,7 @@ pnpm test # typecheck, lint, format, then every playtest
|
|
|
54
54
|
pnpm build --target desktop # also: web, android, ios
|
|
55
55
|
pnpm studio # open the game in Studio
|
|
56
56
|
npx threenative doctor # build, import, device or blank-frame failure
|
|
57
|
+
npx threenative doctor --fix # refresh agent files
|
|
57
58
|
```
|
|
58
59
|
<!-- /shared -->
|
|
59
60
|
|
|
@@ -63,6 +64,7 @@ npx threenative doctor # build, import, device or blank-frame failure
|
|
|
63
64
|
Each is on by default with a named override. Detail: `node_modules/create-threenative/agent-docs/references/conventions.md#<id>`.
|
|
64
65
|
|
|
65
66
|
- **Look** `#look`: filmic curve, metered auto exposure. Override: `tonemapMode: "aces"`; `autoExposureEnabled: false` + `exposure`. Marker: `TN_WORLD_ENVIRONMENT`.
|
|
67
|
+
- **Ambient occlusion** `#ao-indirect`: darkens indirect light only, not the sun. Override: `gtaoIndirectOnly: false`; `gtaoEnabled: false`. Marker: `TN_WORLD_ENVIRONMENT`.
|
|
66
68
|
- **Quality tier (`src/render/quality.ts`)** `#quality`: GPU class picks `high`, `medium` or `low`. Override: `setupPost(..., { tier: "low" })`. Marker: `TN_QUALITY_TIER`.
|
|
67
69
|
- **Resolution scale** `#resolution`: `"auto"`, 0.85 on mobile-low. Override: numeric `resolutionScale`. Marker: `TN_FRAME_BUDGET`.
|
|
68
70
|
- **Budget real time for the look** `#frame-budget`: frame meter and scene verdict on. Override: `frameBudget: false`. Marker: `TN_FRAME_BUDGET`, `TN_SCENE_WARNING`.
|
|
@@ -84,12 +86,15 @@ Each is on by default with a named override. Detail: `node_modules/create-threen
|
|
|
84
86
|
- **Frame spans** `#spans`: off. Override: `TN_FRAME_SPANS=1`. Marker: `TN_FRAME_SPANS`.
|
|
85
87
|
- **Multiplayer** `#net`: none; unsupported transport rejects. Override: `connect` from `@threenative/core/net` with four limits. Marker: `TN_NET_UNAVAILABLE`.
|
|
86
88
|
- **Desktop window** `#desktop-mode`: CLI, then `display.fullscreen`, then `window.maximized`. Override: `--windowed`; `--maximized`; `--fullscreen`.
|
|
89
|
+
- **CPU priority** `#cpu-priority`: game threads first. Override: `display.priority: "normal"`. Marker: `TN_PROCESS_PRIORITY`.
|
|
87
90
|
- **Terrain** `#terrain`: authored in the game. Override: optional `@threenative/terrain`; `references/terrain-authoring.md`.
|
|
88
91
|
- **Navigation** `#navigation`: none; browser-only WASM. Override: import `@threenative/physics/navigation` on purpose.
|
|
92
|
+
- **Controller** `#gamepad`: W3C standard mapping on every pad, radial dead zone `0.2`, and a button press or a decisive stick move claims which pad is read. Override: `gamepadDeadZone: 0` for raw axes. Marker: `TN_GAMEPAD`.
|
|
89
93
|
- **Move input** `#move-axis`: `input.vector("move").y` is +up. Override: one explicit `-move.y` conversion.
|
|
90
94
|
- **Scene change** `#scene-change`: `ctx.goto(name)` keeps state. Override: `game.goto(name)` resets state.
|
|
91
95
|
- **Randomness** `#seed`: unseeded. Override: `defineGame({ seed })`.
|
|
92
96
|
- **Engine** `#engine`: owned C++ engine. Override: `engine: "threejs"` only when the user asks. Marker: `TN_NATIVE_ENGINE_UNBOUND`.
|
|
97
|
+
- **Refused imports** `#engine-catalog`: refused `three` imports fail at their line. Override: `createEngineCatalogPlugin({ mode: "warn" })`. Marker: `TN_ENGINE_CATALOG`.
|
|
93
98
|
<!-- /shared -->
|
|
94
99
|
|
|
95
100
|
<!-- shared: kit-stuck -->
|
|
@@ -13,7 +13,7 @@ Detail for each step: `threenative-capabilities` skill. Do the steps in order. A
|
|
|
13
13
|
|
|
14
14
|
1. **Kit** (new game only): `engine_search_capabilities {situation: "<the whole request>", scope: "request"}` returns the matching starter kit first. This folder is already a kit.
|
|
15
15
|
2. **Mechanics**: per mechanic, `engine_search_references {situation}`, then `engine_reference_detail` on each hit for pinned constants and feel. To see a mechanic move, `engine_watch_reference {query: "<game> <mechanic>"}` returns a contact sheet of real gameplay. Borrow mechanics only: no code, level layouts, character names or art. Cite `file:line`.
|
|
16
|
-
3. **Built-ins**: per mechanic, system or symptom, `engine_search_capabilities {situation, scope: "mechanic"}
|
|
16
|
+
3. **Built-ins**: per mechanic, system or symptom, `engine_search_capabilities {situation, scope: "mechanic"}`; rows answer; `engine_capability_detail` only for omitted symbols. Constraints are binding. `verdict: "none"` means the game writes it in `src/`.
|
|
17
17
|
4. **Plan** (new game, or a change to several systems): `prd-creator` with the kit, references and built-ins. With a user, wait for explicit approval, then implement. With no user (`claude -p`, a script), record the plan and assumptions, then continue.
|
|
18
18
|
5. **Assets**: `asset_search_sources`, the source's search tool, then `asset_download_file`; record source and licence in `CREDITS.md`. Nothing fits: `sculpt_plan`. A rigged GLB: `animation_inspect` (`threenative-assets` skill).
|
|
19
19
|
6. **Build**: gameplay in `src/`, look in `src/render/` (`threenative-context` and `threenative-ui` skills). For parallel work, give each subagent one area and its files, then integrate.
|
|
@@ -32,7 +32,7 @@ A change to an existing game repeats steps 2-3 for that change, then steps 5-8.
|
|
|
32
32
|
- `threenative-assets`: a texture, HDRI, sound or model. `asset_search_sources`, `asset_download_file`, `audio_search_assets`, `mesh_optimize`.
|
|
33
33
|
- `threenative-sculpt`: a bespoke mesh or character from a reference image. `sculpt_plan`, `sculpt_spec_gate`, `sculpt_compare`, `sculpt_pass_gate`.
|
|
34
34
|
- `threenative-animation`: a rigged GLB with a held prop, foot slide or loop seam. `animation_inspect`, `animation_attach`, `animation_verify`.
|
|
35
|
-
- `threenative-terrain`:
|
|
35
|
+
- `threenative-terrain`: any terrain, from words. `terrain_generate`.
|
|
36
36
|
- `threenative-devtools`: after `npx @threenative/playtest trace` names no cause. `performance_start_trace`, `performance_analyze_insight`.
|
|
37
37
|
<!-- /shared -->
|
|
38
38
|
|
|
@@ -40,12 +40,12 @@ A change to an existing game repeats steps 2-3 for that change, then steps 5-8.
|
|
|
40
40
|
|
|
41
41
|
<!-- shared: kit-files -->
|
|
42
42
|
Source in `src/`: `entities/`, `game.ts`, `interact.ts`, `level/`, `main.ts`, `render/`, `scenes/`, `state.ts`, `ui/`.
|
|
43
|
-
|
|
43
|
+
17 scenarios in `playtests/`; `playtests/survives.playtest.json` is the smoke proof.
|
|
44
44
|
Kit notes: `node_modules/create-threenative/agent-docs/references/kit-adventure.md`.
|
|
45
45
|
<!-- /shared -->
|
|
46
46
|
|
|
47
|
-
`ADVENTURE_FEEL` in `src/entities/Hero.ts` is Wren's one table of feel constants; `playtests/move.playtest.json` proves it. `src/interact.ts` is the one interact prompt picker. Every model is procedural.
|
|
48
|
-
`pnpm test` proves the web target. Desktop is claimed only where `native-playtests/survives.playtest.json` ran with `--target desktop`; Android and iOS have not run for this kit.
|
|
47
|
+
`ADVENTURE_FEEL` in `src/entities/Hero.ts` is Wren's one table of feel constants; `playtests/move.playtest.json` proves it. `src/interact.ts` is the one interact prompt picker. Every model is procedural except the baked forest-floor props, `assets/floor-*.glb` (PRD-889).
|
|
48
|
+
`pnpm test` proves the web target. Desktop is claimed only where `native-playtests/survives.playtest.json` and `native-playtests/woodland-floor.playtest.json` ran with `--target desktop`; Android and iOS have not run for this kit.
|
|
49
49
|
|
|
50
50
|
<!-- shared: kit-commands -->
|
|
51
51
|
## Commands
|
|
@@ -56,6 +56,7 @@ pnpm test # typecheck, lint, format, then every playtest
|
|
|
56
56
|
pnpm build --target desktop # also: web, android, ios
|
|
57
57
|
pnpm studio # open the game in Studio
|
|
58
58
|
npx threenative doctor # build, import, device or blank-frame failure
|
|
59
|
+
npx threenative doctor --fix # refresh agent files
|
|
59
60
|
```
|
|
60
61
|
<!-- /shared -->
|
|
61
62
|
|
|
@@ -65,6 +66,7 @@ npx threenative doctor # build, import, device or blank-frame failure
|
|
|
65
66
|
Each is on by default with a named override. Detail: `node_modules/create-threenative/agent-docs/references/conventions.md#<id>`.
|
|
66
67
|
|
|
67
68
|
- **Look** `#look`: filmic curve, metered auto exposure. Override: `tonemapMode: "aces"`; `autoExposureEnabled: false` + `exposure`. Marker: `TN_WORLD_ENVIRONMENT`.
|
|
69
|
+
- **Ambient occlusion** `#ao-indirect`: darkens indirect light only, not the sun. Override: `gtaoIndirectOnly: false`; `gtaoEnabled: false`. Marker: `TN_WORLD_ENVIRONMENT`.
|
|
68
70
|
- **Quality tier (`src/render/quality.ts`)** `#quality`: GPU class picks `high`, `medium` or `low`. Override: `setupPost(..., { tier: "low" })`. Marker: `TN_QUALITY_TIER`.
|
|
69
71
|
- **Resolution scale** `#resolution`: `"auto"`, 0.85 on mobile-low. Override: numeric `resolutionScale`. Marker: `TN_FRAME_BUDGET`.
|
|
70
72
|
- **Budget real time for the look** `#frame-budget`: frame meter and scene verdict on. Override: `frameBudget: false`. Marker: `TN_FRAME_BUDGET`, `TN_SCENE_WARNING`.
|
|
@@ -86,12 +88,15 @@ Each is on by default with a named override. Detail: `node_modules/create-threen
|
|
|
86
88
|
- **Frame spans** `#spans`: off. Override: `TN_FRAME_SPANS=1`. Marker: `TN_FRAME_SPANS`.
|
|
87
89
|
- **Multiplayer** `#net`: none; unsupported transport rejects. Override: `connect` from `@threenative/core/net` with four limits. Marker: `TN_NET_UNAVAILABLE`.
|
|
88
90
|
- **Desktop window** `#desktop-mode`: CLI, then `display.fullscreen`, then `window.maximized`. Override: `--windowed`; `--maximized`; `--fullscreen`.
|
|
91
|
+
- **CPU priority** `#cpu-priority`: game threads first. Override: `display.priority: "normal"`. Marker: `TN_PROCESS_PRIORITY`.
|
|
89
92
|
- **Terrain** `#terrain`: authored in the game. Override: optional `@threenative/terrain`; `references/terrain-authoring.md`.
|
|
90
93
|
- **Navigation** `#navigation`: none; browser-only WASM. Override: import `@threenative/physics/navigation` on purpose.
|
|
94
|
+
- **Controller** `#gamepad`: W3C standard mapping on every pad, radial dead zone `0.2`, and a button press or a decisive stick move claims which pad is read. Override: `gamepadDeadZone: 0` for raw axes. Marker: `TN_GAMEPAD`.
|
|
91
95
|
- **Move input** `#move-axis`: `input.vector("move").y` is +up. Override: one explicit `-move.y` conversion.
|
|
92
96
|
- **Scene change** `#scene-change`: `ctx.goto(name)` keeps state. Override: `game.goto(name)` resets state.
|
|
93
97
|
- **Randomness** `#seed`: unseeded. Override: `defineGame({ seed })`.
|
|
94
98
|
- **Engine** `#engine`: owned C++ engine. Override: `engine: "threejs"` only when the user asks. Marker: `TN_NATIVE_ENGINE_UNBOUND`.
|
|
99
|
+
- **Refused imports** `#engine-catalog`: refused `three` imports fail at their line. Override: `createEngineCatalogPlugin({ mode: "warn" })`. Marker: `TN_ENGINE_CATALOG`.
|
|
95
100
|
<!-- /shared -->
|
|
96
101
|
|
|
97
102
|
<!-- shared: kit-stuck -->
|
|
@@ -4,5 +4,9 @@
|
|
|
4
4
|
"blurb": "Wren crosses a sunlit clearing and a three-room moss dungeon with lock-on sword combat, a shield, a block-and-switch puzzle, a small key and the Stone Warden mini-boss.",
|
|
5
5
|
"genre": "adventure",
|
|
6
6
|
"aliases": ["zelda", "ocarina", "action-adventure", "adventure"],
|
|
7
|
-
"kit": true
|
|
7
|
+
"kit": true,
|
|
8
|
+
"scaffold": {
|
|
9
|
+
"mainHandWritten": true,
|
|
10
|
+
"reason": "its entry also binds Tab so the browser cannot move focus off the canvas; the restamp cannot express that statement, so the file stays the kit's"
|
|
11
|
+
}
|
|
8
12
|
}
|
|
@@ -42,6 +42,18 @@
|
|
|
42
42
|
"gte": -0.3,
|
|
43
43
|
"lte": 0.3,
|
|
44
44
|
"allowTrivial": "The capsule's origin is Wren's waist, so feet near zero after 300 ticks prove she stands on the clearing floor on the native host too."
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"entity": "grass",
|
|
48
|
+
"component": "visibleChunks",
|
|
49
|
+
"gte": 1,
|
|
50
|
+
"allowTrivial": "Streamed grass chunks draw round Wren on the native host, from the same GrassField3D as the web."
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
"entity": "grass",
|
|
54
|
+
"component": "standNear",
|
|
55
|
+
"lte": 0.6,
|
|
56
|
+
"allowTrivial": "The grass next to Wren is pushed over on the native host too."
|
|
45
57
|
}
|
|
46
58
|
],
|
|
47
59
|
"movement": {
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
{
|
|
2
|
+
"assert": {
|
|
3
|
+
"components": [
|
|
4
|
+
{
|
|
5
|
+
"allowTrivial": "Baked logs, stumps, twigs, litter and ferns draw round Wren on the native host too: the owned engine's own scatter, not a browser-only path.",
|
|
6
|
+
"component": "instances",
|
|
7
|
+
"entity": "floor",
|
|
8
|
+
"gte": 20
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
"allowTrivial": "At least three streamed floor tiles stand inside the draw distance on the native host.",
|
|
12
|
+
"component": "visibleTiles",
|
|
13
|
+
"entity": "floor",
|
|
14
|
+
"gte": 3
|
|
15
|
+
}
|
|
16
|
+
],
|
|
17
|
+
"diagnostics": {
|
|
18
|
+
"noConsoleErrors": true,
|
|
19
|
+
"noNetworkErrors": true,
|
|
20
|
+
"noRuntimeDiagnostics": true,
|
|
21
|
+
"runtimeReady": true
|
|
22
|
+
},
|
|
23
|
+
"movement": {
|
|
24
|
+
"entity": "player",
|
|
25
|
+
"minDistance": 1.0
|
|
26
|
+
}
|
|
27
|
+
},
|
|
28
|
+
"artifacts": {
|
|
29
|
+
"screenshots": "after"
|
|
30
|
+
},
|
|
31
|
+
"name": "adventure-native-woodland-floor",
|
|
32
|
+
"schemaVersion": 1,
|
|
33
|
+
"setup": {
|
|
34
|
+
"aim": {
|
|
35
|
+
"pitch": -0.1,
|
|
36
|
+
"yaw": 0.72
|
|
37
|
+
}
|
|
38
|
+
},
|
|
39
|
+
"steps": [
|
|
40
|
+
{
|
|
41
|
+
"holdTicks": 30,
|
|
42
|
+
"kind": "input",
|
|
43
|
+
"label": "walk out under the old trees",
|
|
44
|
+
"press": "KeyW",
|
|
45
|
+
"release": true
|
|
46
|
+
},
|
|
47
|
+
{
|
|
48
|
+
"kind": "wait",
|
|
49
|
+
"label": "stand on the forest floor",
|
|
50
|
+
"release": true,
|
|
51
|
+
"waitTicks": 80
|
|
52
|
+
}
|
|
53
|
+
],
|
|
54
|
+
"subject": "player",
|
|
55
|
+
"target": "desktop",
|
|
56
|
+
"viewport": {
|
|
57
|
+
"height": 720,
|
|
58
|
+
"width": 1280
|
|
59
|
+
},
|
|
60
|
+
"warmupFrames": 10
|
|
61
|
+
}
|
|
@@ -19,9 +19,9 @@
|
|
|
19
19
|
"format:check": "biome format src"
|
|
20
20
|
},
|
|
21
21
|
"dependencies": {
|
|
22
|
-
"@threenative/core": "0.3.
|
|
23
|
-
"@threenative/physics": "0.3.
|
|
24
|
-
"@threenative/ui": "0.3.
|
|
22
|
+
"@threenative/core": ">=0.3.15",
|
|
23
|
+
"@threenative/physics": ">=0.3.15",
|
|
24
|
+
"@threenative/ui": ">=0.3.15",
|
|
25
25
|
"react": "19.2.0",
|
|
26
26
|
"react-dom": "19.2.0",
|
|
27
27
|
"three": "0.187.0"
|
|
@@ -30,11 +30,11 @@
|
|
|
30
30
|
"@tailwindcss/vite": "4.3.3",
|
|
31
31
|
"@vitejs/plugin-react": "6.0.5",
|
|
32
32
|
"@types/three": "0.187.0",
|
|
33
|
-
"@threenative/assets": "0.3.
|
|
34
|
-
"@threenative/playtest": "0.3.
|
|
33
|
+
"@threenative/assets": ">=0.3.16",
|
|
34
|
+
"@threenative/playtest": ">=0.3.15",
|
|
35
35
|
"@types/react": "19.2.0",
|
|
36
36
|
"@types/react-dom": "19.2.0",
|
|
37
|
-
"create-threenative": "0.2.
|
|
37
|
+
"create-threenative": "0.2.20",
|
|
38
38
|
"esbuild": "0.27.0",
|
|
39
39
|
"playwright": "1.62.1",
|
|
40
40
|
"tailwindcss": "4.3.3",
|
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
"eslint": "10.13.0"
|
|
46
46
|
},
|
|
47
47
|
"optionalDependencies": {
|
|
48
|
-
"@threenative/runtime-native": "0.3.
|
|
48
|
+
"@threenative/runtime-native": ">=0.3.15"
|
|
49
49
|
},
|
|
50
50
|
"overrides": {
|
|
51
51
|
"sharp": ">=0.35.4",
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "adventure-grass",
|
|
3
|
+
"target": "web",
|
|
4
|
+
"schemaVersion": 1,
|
|
5
|
+
"viewport": {
|
|
6
|
+
"width": 1280,
|
|
7
|
+
"height": 720
|
|
8
|
+
},
|
|
9
|
+
"warmupFrames": 10,
|
|
10
|
+
"subject": "player",
|
|
11
|
+
"artifacts": {
|
|
12
|
+
"screenshots": "after"
|
|
13
|
+
},
|
|
14
|
+
"steps": [
|
|
15
|
+
{
|
|
16
|
+
"kind": "input",
|
|
17
|
+
"label": "walk off the path into the grass",
|
|
18
|
+
"press": "KeyA",
|
|
19
|
+
"holdTicks": 45,
|
|
20
|
+
"release": true
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
"kind": "wait",
|
|
24
|
+
"label": "stand in the grass",
|
|
25
|
+
"waitTicks": 90,
|
|
26
|
+
"release": true
|
|
27
|
+
}
|
|
28
|
+
],
|
|
29
|
+
"assert": {
|
|
30
|
+
"diagnostics": {
|
|
31
|
+
"noConsoleErrors": true,
|
|
32
|
+
"noNetworkErrors": true,
|
|
33
|
+
"noRuntimeDiagnostics": true,
|
|
34
|
+
"runtimeReady": true
|
|
35
|
+
},
|
|
36
|
+
"components": [
|
|
37
|
+
{
|
|
38
|
+
"entity": "grass",
|
|
39
|
+
"component": "visibleChunks",
|
|
40
|
+
"gte": 1,
|
|
41
|
+
"allowTrivial": "Streamed grass chunks draw round the camera at the spawn."
|
|
42
|
+
},
|
|
43
|
+
{
|
|
44
|
+
"entity": "grass",
|
|
45
|
+
"component": "standNear",
|
|
46
|
+
"lte": 0.6,
|
|
47
|
+
"allowTrivial": "A blade half a metre from Wren is pushed over: its standing height is at most 0.6 of rest."
|
|
48
|
+
},
|
|
49
|
+
{
|
|
50
|
+
"entity": "grass",
|
|
51
|
+
"component": "standFar",
|
|
52
|
+
"gte": 0.9,
|
|
53
|
+
"allowTrivial": "A blade 3 m from Wren stands at its resting lean, out of her reach."
|
|
54
|
+
}
|
|
55
|
+
],
|
|
56
|
+
"movement": {
|
|
57
|
+
"entity": "player",
|
|
58
|
+
"minDistance": 1.5
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
@@ -157,8 +157,8 @@
|
|
|
157
157
|
{
|
|
158
158
|
"id": "state",
|
|
159
159
|
"path": "assetLoads",
|
|
160
|
-
"equals":
|
|
161
|
-
"allowTrivial": "Every model and the sky are built in code; the loader is asked
|
|
160
|
+
"equals": 11,
|
|
161
|
+
"allowTrivial": "Every model and the sky are built in code; the loader is asked for the five shared tiling photos in src/render/surface.ts and the six baked forest-floor props in assets/floor-*.glb (PRD-889)."
|
|
162
162
|
},
|
|
163
163
|
{
|
|
164
164
|
"id": "state",
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "adventure-woodland-floor",
|
|
3
|
+
"target": "web",
|
|
4
|
+
"schemaVersion": 1,
|
|
5
|
+
"viewport": {
|
|
6
|
+
"width": 1280,
|
|
7
|
+
"height": 720
|
|
8
|
+
},
|
|
9
|
+
"warmupFrames": 10,
|
|
10
|
+
"subject": "player",
|
|
11
|
+
"artifacts": {
|
|
12
|
+
"screenshots": "after"
|
|
13
|
+
},
|
|
14
|
+
"steps": [
|
|
15
|
+
{
|
|
16
|
+
"holdTicks": 30,
|
|
17
|
+
"kind": "input",
|
|
18
|
+
"label": "walk out under the old trees",
|
|
19
|
+
"press": "KeyW",
|
|
20
|
+
"release": true
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
"kind": "wait",
|
|
24
|
+
"label": "stand on the forest floor",
|
|
25
|
+
"release": true,
|
|
26
|
+
"waitTicks": 80
|
|
27
|
+
}
|
|
28
|
+
],
|
|
29
|
+
"assert": {
|
|
30
|
+
"diagnostics": {
|
|
31
|
+
"noConsoleErrors": true,
|
|
32
|
+
"noNetworkErrors": true,
|
|
33
|
+
"noRuntimeDiagnostics": true,
|
|
34
|
+
"runtimeReady": true
|
|
35
|
+
},
|
|
36
|
+
"components": [
|
|
37
|
+
{
|
|
38
|
+
"entity": "floor",
|
|
39
|
+
"component": "instances",
|
|
40
|
+
"gte": 20,
|
|
41
|
+
"allowTrivial": "Baked logs, stumps, twigs, litter and ferns draw round Wren: the floor is not empty."
|
|
42
|
+
},
|
|
43
|
+
{
|
|
44
|
+
"entity": "floor",
|
|
45
|
+
"component": "visibleTiles",
|
|
46
|
+
"gte": 3,
|
|
47
|
+
"allowTrivial": "At least three streamed floor tiles stand inside the draw distance."
|
|
48
|
+
}
|
|
49
|
+
],
|
|
50
|
+
"movement": {
|
|
51
|
+
"entity": "player",
|
|
52
|
+
"minDistance": 1.0
|
|
53
|
+
}
|
|
54
|
+
},
|
|
55
|
+
"setup": {
|
|
56
|
+
"aim": {
|
|
57
|
+
"pitch": -0.1,
|
|
58
|
+
"yaw": 0.72
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { Group, PerspectiveCamera, Vector3 } from "three";
|
|
2
|
-
import { Box3, MathUtils, Vector3 as V3 } from "three";
|
|
2
|
+
import { Box3, MathUtils, Mesh, Vector3 as V3 } from "three";
|
|
3
3
|
import { createReticle } from "../render/creatures.js";
|
|
4
4
|
|
|
5
5
|
/** Anything Wren can lock onto and cut: Mosslings, the Warden, the practice dummies. */
|
|
@@ -60,6 +60,12 @@ export class LockOn {
|
|
|
60
60
|
readonly #view = new V3();
|
|
61
61
|
readonly #to = new V3();
|
|
62
62
|
readonly #marker = new Box3();
|
|
63
|
+
/** The reticle's own box, measured once: it only moves, turns and scales. */
|
|
64
|
+
readonly #reticleBox = new Box3().setFromObject(this.reticle);
|
|
65
|
+
readonly #partBox = new Box3();
|
|
66
|
+
/** The target's meshes, collected once per target. */
|
|
67
|
+
#meshSource: ITarget | undefined;
|
|
68
|
+
#meshes: Mesh[] = [];
|
|
63
69
|
|
|
64
70
|
update(
|
|
65
71
|
dt: number,
|
|
@@ -94,14 +100,32 @@ export class LockOn {
|
|
|
94
100
|
this.#sticky = this.target !== undefined;
|
|
95
101
|
this.justAcquired = this.target !== undefined;
|
|
96
102
|
}
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* Bounds and reticle for this frame, after everything that moves has moved.
|
|
107
|
+
*
|
|
108
|
+
* Called separately from `update` because the lock must be picked before the hero reads its
|
|
109
|
+
* target, while the creatures it frames move later in the frame; placing it here is what keeps
|
|
110
|
+
* the arrow on the body rather than a frame behind it.
|
|
111
|
+
*/
|
|
112
|
+
place(camera: PerspectiveCamera, dt: number): void {
|
|
97
113
|
const target = this.target;
|
|
98
114
|
this.reticle.visible = target !== undefined;
|
|
99
115
|
this.markerLift = 0;
|
|
100
116
|
this.markerTop = 0;
|
|
101
117
|
if (target !== undefined) {
|
|
102
118
|
// The target's live bounds, not a fixed offset: a rearing Warden or a hopping Mossling keeps
|
|
103
|
-
// the arrow over its real top.
|
|
104
|
-
|
|
119
|
+
// the arrow over its real top. The meshes are collected once per target and each frame only
|
|
120
|
+
// transforms its own box, which is what `setFromObject` did without the per-frame walk.
|
|
121
|
+
target.mesh.updateWorldMatrix(true, true);
|
|
122
|
+
const box = this.bounds.makeEmpty();
|
|
123
|
+
for (const mesh of this.#meshesOf(target)) {
|
|
124
|
+
if (mesh.geometry.boundingBox === null) mesh.geometry.computeBoundingBox();
|
|
125
|
+
const part = mesh.geometry.boundingBox;
|
|
126
|
+
if (part === null) continue;
|
|
127
|
+
box.union(this.#partBox.copy(part).applyMatrix4(mesh.matrixWorld));
|
|
128
|
+
}
|
|
105
129
|
const tall = MathUtils.clamp((box.max.y - box.min.y) / 1.8, 0.75, 1.25);
|
|
106
130
|
this.#spin += dt * 1.6;
|
|
107
131
|
const lift = LIFT + 0.05 * tall + Math.sin(this.#spin * 2.5) * 0.06;
|
|
@@ -118,12 +142,26 @@ export class LockOn {
|
|
|
118
142
|
Math.tan(MathUtils.degToRad(camera.fov / 2));
|
|
119
143
|
this.reticle.scale.setScalar(Math.max(tall, (MIN_SCREEN_SHARE * span) / ARROW_HEIGHT));
|
|
120
144
|
// Measured, not assumed: the gap from the target's top to the marker's own lowest point.
|
|
121
|
-
|
|
145
|
+
this.reticle.updateWorldMatrix(true, false);
|
|
146
|
+
const marker = this.#marker.copy(this.#reticleBox).applyMatrix4(this.reticle.matrixWorld);
|
|
122
147
|
this.markerLift = marker.min.y - box.max.y;
|
|
123
148
|
this.markerTop = marker.max.y;
|
|
124
149
|
}
|
|
125
150
|
}
|
|
126
151
|
|
|
152
|
+
/** The meshes a target's bounds cover: `setFromObject` walked them every frame, and a creature's
|
|
153
|
+
* mesh set never changes while it is locked. */
|
|
154
|
+
#meshesOf(target: ITarget): readonly Mesh[] {
|
|
155
|
+
if (this.#meshSource !== target) {
|
|
156
|
+
this.#meshes = [];
|
|
157
|
+
target.mesh.traverse((object) => {
|
|
158
|
+
if (object instanceof Mesh) this.#meshes.push(object);
|
|
159
|
+
});
|
|
160
|
+
this.#meshSource = target;
|
|
161
|
+
}
|
|
162
|
+
return this.#meshes;
|
|
163
|
+
}
|
|
164
|
+
|
|
127
165
|
/**
|
|
128
166
|
* The toggle's next target: with none locked, the same pick a hold makes; with one locked, the
|
|
129
167
|
* next farther hostile in range, and `undefined` (drop) after the farthest.
|
|
@@ -7,6 +7,9 @@ import type { ITarget } from "./LockOn.js";
|
|
|
7
7
|
const CAPSULE = { halfHeight: 0.55, radius: 0.75 } as const;
|
|
8
8
|
const FOOT_OFFSET = CAPSULE.halfHeight + CAPSULE.radius;
|
|
9
9
|
|
|
10
|
+
/** The vector from the Warden to the hero: `update` runs every frame, so it uses one instance. */
|
|
11
|
+
const toHero = new Vector3();
|
|
12
|
+
|
|
10
13
|
/** The Warden's numbers, in metres and seconds. Kit design values. */
|
|
11
14
|
export const WARDEN_FEEL = {
|
|
12
15
|
health: 3,
|
|
@@ -101,7 +104,7 @@ export class Warden implements ITarget {
|
|
|
101
104
|
const feel = WARDEN_FEEL;
|
|
102
105
|
this.#timer += dt;
|
|
103
106
|
this.#flash = Math.max(0, this.#flash - dt);
|
|
104
|
-
const to =
|
|
107
|
+
const to = toHero.subVectors(hero.mesh.position, this.mesh.position).setY(0);
|
|
105
108
|
let speed = 0;
|
|
106
109
|
switch (this.state) {
|
|
107
110
|
case "dormant":
|
|
@@ -41,7 +41,7 @@ const game = defineGame<GameState, IPhysicsContext>({
|
|
|
41
41
|
// of each 20 fps frame re-simulating, which made the next frame slower still.
|
|
42
42
|
maxSteps: 2,
|
|
43
43
|
display: config.display,
|
|
44
|
-
|
|
44
|
+
renderer: config.renderer,
|
|
45
45
|
scenes: { play: Play },
|
|
46
46
|
seed: 1986,
|
|
47
47
|
start: "play",
|