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,6 +11,7 @@ import {
|
|
|
11
11
|
EquirectangularReflectionMapping,
|
|
12
12
|
FogExp2,
|
|
13
13
|
LinearFilter,
|
|
14
|
+
MathUtils,
|
|
14
15
|
RGBAFormat,
|
|
15
16
|
SRGBColorSpace,
|
|
16
17
|
type Scene,
|
|
@@ -39,8 +40,8 @@ const LATTICE = (() => {
|
|
|
39
40
|
function noise(x: number, y: number): number {
|
|
40
41
|
const i = Math.floor(x);
|
|
41
42
|
const j = Math.floor(y);
|
|
42
|
-
const fx = (x - i
|
|
43
|
-
const fy = (y - j
|
|
43
|
+
const fx = MathUtils.smoothstep(x - i, 0, 1);
|
|
44
|
+
const fy = MathUtils.smoothstep(y - j, 0, 1);
|
|
44
45
|
const i0 = i & 255;
|
|
45
46
|
const i1 = (i + 1) & 255;
|
|
46
47
|
const j0 = (j & 255) << 8;
|
|
@@ -79,7 +80,7 @@ function density(x: number, y: number): number {
|
|
|
79
80
|
|
|
80
81
|
const smooth = (from: number, to: number, value: number): number => {
|
|
81
82
|
const t = Math.min(1, Math.max(0, (value - from) / (to - from)));
|
|
82
|
-
return t
|
|
83
|
+
return MathUtils.smoothstep(t, 0, 1);
|
|
83
84
|
};
|
|
84
85
|
|
|
85
86
|
/**
|
|
@@ -92,7 +93,7 @@ const smooth = (from: number, to: number, value: number): number => {
|
|
|
92
93
|
* flatten toward the horizon. Each is lit by where its density climbs: a texel whose deck is
|
|
93
94
|
* denser toward the sun, or above it on screen, is on the cloud's shaded side or its flat base.
|
|
94
95
|
*/
|
|
95
|
-
export function
|
|
96
|
+
export function skyPixels(saturation = 1, width = 2048): Uint8Array {
|
|
96
97
|
// three's PMREM sizes its cube from width / 4 and needs at least 16: keep width >= 64.
|
|
97
98
|
const height = width / 2;
|
|
98
99
|
const data = new Uint8Array(width * height * 4);
|
|
@@ -109,6 +110,14 @@ export function skyTexture(saturation = 1, width = 2048): DataTexture {
|
|
|
109
110
|
let baseR = 0;
|
|
110
111
|
let baseG = 0;
|
|
111
112
|
let baseB = 0;
|
|
113
|
+
// Each column's azimuth terms, once: the same numbers every row reads.
|
|
114
|
+
const cosAzimuth = new Float64Array(width);
|
|
115
|
+
const sinAzimuth = new Float64Array(width);
|
|
116
|
+
for (let column = 0; column < width; column += 1) {
|
|
117
|
+
const azimuth = (column / width - 0.5) * Math.PI * 2;
|
|
118
|
+
cosAzimuth[column] = Math.cos(azimuth);
|
|
119
|
+
sinAzimuth[column] = Math.sin(azimuth);
|
|
120
|
+
}
|
|
112
121
|
// Pass 1: the deck's density under every cloud-band texel, once (the shading reads neighbours).
|
|
113
122
|
const deck = new Float32Array(width * height);
|
|
114
123
|
const bands = new Float32Array(height);
|
|
@@ -120,8 +129,10 @@ export function skyTexture(saturation = 1, width = 2048): DataTexture {
|
|
|
120
129
|
// Flattened less than a true deck would be: cumulus heaps stand tall, they are not a sheet.
|
|
121
130
|
const reach = (1 / (Math.tan(elevation) + 0.1)) ** 0.7 * 0.75;
|
|
122
131
|
for (let column = 0; column < width; column += 1) {
|
|
123
|
-
|
|
124
|
-
|
|
132
|
+
deck[row * width + column] = density(
|
|
133
|
+
(cosAzimuth[column] as number) * reach,
|
|
134
|
+
(sinAzimuth[column] as number) * reach,
|
|
135
|
+
);
|
|
125
136
|
}
|
|
126
137
|
}
|
|
127
138
|
// The cumulus banks over the far hills, per column: where a bank stands (`cluster`), its heaped
|
|
@@ -142,6 +153,12 @@ export function skyTexture(saturation = 1, width = 2048): DataTexture {
|
|
|
142
153
|
const step = Math.max(1, Math.round(width / 512));
|
|
143
154
|
const sunAzimuth = Math.atan2(SUN_DIRECTION.z, SUN_DIRECTION.x);
|
|
144
155
|
const sunElevation = Math.asin(SUN_DIRECTION.y);
|
|
156
|
+
// Which way the sun lies from each column, once.
|
|
157
|
+
const sunward = new Int8Array(width);
|
|
158
|
+
for (let column = 0; column < width; column += 1) {
|
|
159
|
+
const azimuth = (column / width - 0.5) * Math.PI * 2;
|
|
160
|
+
sunward[column] = Math.sin(sunAzimuth - azimuth) > 0 ? 1 : -1;
|
|
161
|
+
}
|
|
145
162
|
for (let row = 0; row < height; row += 1) {
|
|
146
163
|
const elevation = (row / (height - 1) - 0.5) * Math.PI;
|
|
147
164
|
const up = Math.sin(elevation);
|
|
@@ -171,9 +188,10 @@ export function skyTexture(saturation = 1, width = 2048): DataTexture {
|
|
|
171
188
|
);
|
|
172
189
|
for (let column = 0; column < width; column += 1) {
|
|
173
190
|
// three's equirectangular u: azimuth from +X toward +Z, u = 0.5 on +X.
|
|
174
|
-
const
|
|
175
|
-
const
|
|
176
|
-
const
|
|
191
|
+
const cosA = cosAzimuth[column] as number;
|
|
192
|
+
const sinA = sinAzimuth[column] as number;
|
|
193
|
+
const tx = cosA * cosE;
|
|
194
|
+
const tz = sinA * cosE;
|
|
177
195
|
// The sun's halo: a warm glow round its direction, wider than the disc the lens never sees.
|
|
178
196
|
const sun = Math.max(0, tx * SUN_DIRECTION.x + up * SUN_DIRECTION.y + tz * SUN_DIRECTION.z);
|
|
179
197
|
const halo = 0.6 * sun ** 32 + 0.22 * sun ** 5;
|
|
@@ -183,7 +201,7 @@ export function skyTexture(saturation = 1, width = 2048): DataTexture {
|
|
|
183
201
|
const d = deck[row * width + column] ?? 0;
|
|
184
202
|
const cover = band > 0 ? smooth(0.43, 0.54, d) * band : 0;
|
|
185
203
|
if (cover > 0.002) {
|
|
186
|
-
const turn =
|
|
204
|
+
const turn = (sunward[column] as number) * step;
|
|
187
205
|
const towardColumn = (column + turn + width) % width;
|
|
188
206
|
// Denser a step toward the sun: the far side of a heap. Denser a step up the sky: its base.
|
|
189
207
|
const toward = (deck[towardRow * width + towardColumn] ?? 0) - d;
|
|
@@ -202,8 +220,7 @@ export function skyTexture(saturation = 1, width = 2048): DataTexture {
|
|
|
202
220
|
if (elevation > foot && elevation < top + 0.05) {
|
|
203
221
|
// Billowed outline: finer noise lifts and bites the heap's top edge.
|
|
204
222
|
// Elevation moves radially and azimuth round the circle: round puffs, and azimuth wraps.
|
|
205
|
-
const puff = (e: number) =>
|
|
206
|
-
fbm(Math.cos(azimuth) * (14 + e * 15), Math.sin(azimuth) * (14 + e * 15), 3);
|
|
223
|
+
const puff = (e: number) => fbm(cosA * (14 + e * 15), sinA * (14 + e * 15), 3);
|
|
207
224
|
const lump = puff(elevation);
|
|
208
225
|
const below = top + (lump - 0.5) * 0.11 - elevation;
|
|
209
226
|
const inside = smooth(0, 0.02, below) * smooth(foot, foot + 0.012, elevation);
|
|
@@ -225,12 +242,27 @@ export function skyTexture(saturation = 1, width = 2048): DataTexture {
|
|
|
225
242
|
}
|
|
226
243
|
const grey = r * 0.2126 + g * 0.7152 + b * 0.0722;
|
|
227
244
|
const i = (row * width + column) * 4;
|
|
228
|
-
data[i] =
|
|
229
|
-
data[i + 1] =
|
|
230
|
-
data[i + 2] =
|
|
245
|
+
data[i] = srgbByte(r + (grey - r) * (1 - saturation));
|
|
246
|
+
data[i + 1] = srgbByte(g + (grey - g) * (1 - saturation));
|
|
247
|
+
data[i + 2] = srgbByte(b + (grey - b) * (1 - saturation));
|
|
231
248
|
data[i + 3] = 255;
|
|
232
249
|
}
|
|
233
250
|
}
|
|
251
|
+
return data;
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
/**
|
|
255
|
+
* The sky as a texture. `data` is `skyPixels(saturation, width)`; the scene passes the copy it kept
|
|
256
|
+
* from the last run (`ctx.assets.memo`), because painting four million texels costs a run ~0.3 s.
|
|
257
|
+
*/
|
|
258
|
+
export function skyTexture(
|
|
259
|
+
saturation = 1,
|
|
260
|
+
width = 2048,
|
|
261
|
+
data: Uint8Array = skyPixels(saturation, width),
|
|
262
|
+
): DataTexture {
|
|
263
|
+
const height = width / 2;
|
|
264
|
+
if (data.length !== width * height * 4)
|
|
265
|
+
throw new Error(`sky pixels are ${data.length} bytes, expected ${width * height * 4}.`);
|
|
234
266
|
const sky = new DataTexture(data, width, height, RGBAFormat, UnsignedByteType);
|
|
235
267
|
sky.mapping = EquirectangularReflectionMapping;
|
|
236
268
|
sky.colorSpace = SRGBColorSpace;
|
|
@@ -247,6 +279,39 @@ function linearToSrgb(value: number): number {
|
|
|
247
279
|
return v < 0.0031308 ? v * 12.92 : 1.055 * v ** (1 / 2.4) - 0.055;
|
|
248
280
|
}
|
|
249
281
|
|
|
282
|
+
/**
|
|
283
|
+
* `Math.round(255 * linearToSrgb(value))` for millions of texels: the byte only steps up as the
|
|
284
|
+
* value grows, so the smallest value of each step, found once, gives the same byte with no power.
|
|
285
|
+
*/
|
|
286
|
+
const SRGB_STEPS = (() => {
|
|
287
|
+
const byte = (value: number) => Math.round(255 * linearToSrgb(value));
|
|
288
|
+
const steps = new Float64Array(256);
|
|
289
|
+
for (let level = 1; level < 256; level += 1) {
|
|
290
|
+
let low = 0;
|
|
291
|
+
let high = 1;
|
|
292
|
+
// Halve until the two ends are adjacent doubles: `high` is then the step's first value.
|
|
293
|
+
for (;;) {
|
|
294
|
+
const middle = low + (high - low) / 2;
|
|
295
|
+
if (middle === low || middle === high) break;
|
|
296
|
+
if (byte(middle) >= level) high = middle;
|
|
297
|
+
else low = middle;
|
|
298
|
+
}
|
|
299
|
+
steps[level] = high;
|
|
300
|
+
}
|
|
301
|
+
return steps;
|
|
302
|
+
})();
|
|
303
|
+
|
|
304
|
+
function srgbByte(value: number): number {
|
|
305
|
+
let low = 0;
|
|
306
|
+
let high = 255;
|
|
307
|
+
while (low < high) {
|
|
308
|
+
const middle = (low + high + 1) >> 1;
|
|
309
|
+
if (value >= (SRGB_STEPS[middle] as number)) low = middle;
|
|
310
|
+
else high = middle - 1;
|
|
311
|
+
}
|
|
312
|
+
return low;
|
|
313
|
+
}
|
|
314
|
+
|
|
250
315
|
/** `fill` is the environment light: by default the sky itself, in this game `skyTexture(0.3, 128)`. */
|
|
251
316
|
export function setupSky(scene: Scene, sky: DataTexture, fill: DataTexture = sky): void {
|
|
252
317
|
scene.background = sky;
|
|
@@ -85,12 +85,39 @@ function depthMap(floor: ISeaFloor): DataTexture {
|
|
|
85
85
|
}
|
|
86
86
|
|
|
87
87
|
/** Tiling ripples: periodic value noise, its slope in red/green and its height in alpha. */
|
|
88
|
+
const RIPPLE_SIZE = 256;
|
|
89
|
+
let primedRipples: Uint8Array | undefined;
|
|
90
|
+
/** Hand the ripple pixels back from a store (`ctx.assets.memo`), so `seaMaterial` skips painting them. */
|
|
91
|
+
export function primeRipplePixels(pixels: Uint8Array): void {
|
|
92
|
+
if (pixels.length !== RIPPLE_SIZE * RIPPLE_SIZE * 4)
|
|
93
|
+
throw new Error("ripple pixels do not match RIPPLE_SIZE.");
|
|
94
|
+
primedRipples = pixels;
|
|
95
|
+
}
|
|
88
96
|
function rippleMap(): DataTexture {
|
|
89
|
-
const n =
|
|
97
|
+
const n = RIPPLE_SIZE;
|
|
98
|
+
const map = new DataTexture(primedRipples ?? ripplePixels(), n, n);
|
|
99
|
+
map.wrapS = RepeatWrapping;
|
|
100
|
+
map.wrapT = RepeatWrapping;
|
|
101
|
+
map.magFilter = LinearFilter;
|
|
102
|
+
map.minFilter = LinearMipmapLinearFilter;
|
|
103
|
+
map.generateMipmaps = true;
|
|
104
|
+
map.needsUpdate = true;
|
|
105
|
+
return map;
|
|
106
|
+
}
|
|
107
|
+
/** The sea's ripple normal (RG) and height (A), the same every run: no input, no randomness. */
|
|
108
|
+
export function ripplePixels(): Uint8Array {
|
|
109
|
+
const n = RIPPLE_SIZE;
|
|
90
110
|
const hash = (x: number, z: number): number => {
|
|
91
111
|
const a = Math.sin(x * 127.1 + z * 311.7) * 43758.5453;
|
|
92
112
|
return a - Math.floor(a);
|
|
93
113
|
};
|
|
114
|
+
// Each octave's lattice is k x k whole points, hashed once: a texel reads 64 of them.
|
|
115
|
+
const lattices = new Map<number, Float64Array>();
|
|
116
|
+
for (const k of [8, 16, 32, 64]) {
|
|
117
|
+
const lattice = new Float64Array(k * k);
|
|
118
|
+
for (let x = 0; x < k; x += 1) for (let z = 0; z < k; z += 1) lattice[x * k + z] = hash(x, z);
|
|
119
|
+
lattices.set(k, lattice);
|
|
120
|
+
}
|
|
94
121
|
const noise = (u: number, v: number, k: number): number => {
|
|
95
122
|
const x = u * k;
|
|
96
123
|
const z = v * k;
|
|
@@ -100,7 +127,9 @@ function rippleMap(): DataTexture {
|
|
|
100
127
|
let b = z - j;
|
|
101
128
|
a = a * a * a * (a * (a * 6 - 15) + 10);
|
|
102
129
|
b = b * b * b * (b * (b * 6 - 15) + 10);
|
|
103
|
-
const
|
|
130
|
+
const lattice = lattices.get(k) as Float64Array;
|
|
131
|
+
const h = (hx: number, hz: number): number =>
|
|
132
|
+
lattice[(((hx % k) + k) % k) * k + (((hz % k) + k) % k)] as number;
|
|
104
133
|
return (
|
|
105
134
|
(h(i, j) * (1 - a) + h(i + 1, j) * a) * (1 - b) +
|
|
106
135
|
(h(i, j + 1) * (1 - a) + h(i + 1, j + 1) * a) * b
|
|
@@ -126,14 +155,7 @@ function rippleMap(): DataTexture {
|
|
|
126
155
|
data[at + 3] = height(u, v) * 255;
|
|
127
156
|
}
|
|
128
157
|
}
|
|
129
|
-
|
|
130
|
-
map.wrapS = RepeatWrapping;
|
|
131
|
-
map.wrapT = RepeatWrapping;
|
|
132
|
-
map.magFilter = LinearFilter;
|
|
133
|
-
map.minFilter = LinearMipmapLinearFilter;
|
|
134
|
-
map.generateMipmaps = true;
|
|
135
|
-
map.needsUpdate = true;
|
|
136
|
-
return map;
|
|
158
|
+
return data;
|
|
137
159
|
}
|
|
138
160
|
|
|
139
161
|
export function seaMaterial(floor: ISeaFloor, swell: ISwell): MeshStandardNodeMaterial {
|
|
@@ -25,9 +25,10 @@ import { setupLighting } from "../render/lighting.js";
|
|
|
25
25
|
import { createLoadingScreen } from "../render/loading.js";
|
|
26
26
|
import { postTier, setupPost } from "../render/postprocessing.js";
|
|
27
27
|
import { GRASS_SHARE } from "../render/quality.js";
|
|
28
|
-
import { setupSky, skyTexture } from "../render/sky.js";
|
|
28
|
+
import { setupSky, skyPixels, skyTexture } from "../render/sky.js";
|
|
29
29
|
import { loadSurfaces, updateSurfaceSampling } from "../render/surface.js";
|
|
30
30
|
import { TouchControls } from "../render/touch-controls.js";
|
|
31
|
+
import { primeRipplePixels, ripplePixels } from "../render/water.js";
|
|
31
32
|
import { type GameState, HUD_PILL } from "../state.js";
|
|
32
33
|
|
|
33
34
|
export type { GameCtx };
|
|
@@ -90,16 +91,28 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
90
91
|
this.#loading = createLoadingScreen(ctx);
|
|
91
92
|
// The HUD is page UI the cover cannot hide, so it waits for the same readiness.
|
|
92
93
|
void ctx.startup.whenReady().then(() => ctx.state.set({ loaded: true }));
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
94
|
+
// The sky is the same every run of this build: paint it once, then read the pixels back. A first
|
|
95
|
+
// visit paints it (~600 ms on a laptop) while the surface textures download, not after them.
|
|
96
|
+
const [surfaces, painted] = await Promise.all([
|
|
97
|
+
loadSurfaces(ctx.assets),
|
|
98
|
+
ctx.assets.memo("sky", () => ({
|
|
99
|
+
fill: skyPixels(0.3, 128),
|
|
100
|
+
ripples: ripplePixels(),
|
|
101
|
+
sky: skyPixels(),
|
|
102
|
+
})),
|
|
103
|
+
]);
|
|
104
|
+
primeRipplePixels(painted.ripples);
|
|
105
|
+
this.#sky = skyTexture(1, 2048, painted.sky);
|
|
106
|
+
this.#fill = skyTexture(0.3, 128, painted.fill);
|
|
96
107
|
setupSky(ctx.scene, this.#sky, this.#fill);
|
|
97
108
|
const tier = postTier({
|
|
98
109
|
gpuClass: ctx.renderer.gpuClass?.class,
|
|
99
110
|
mobile: isMobile(),
|
|
100
111
|
software: ctx.renderer.softwareAdapter !== undefined,
|
|
101
112
|
});
|
|
102
|
-
|
|
113
|
+
// The island is the same every run of this build: the first run draws it, a repeat reads it
|
|
114
|
+
// back from `ctx.assets.memo` (~105 ms of the load on a laptop).
|
|
115
|
+
const course = await buildCourse(makeRng(6402), surfaces, GRASS_SHARE[tier], ctx.assets.memo);
|
|
103
116
|
this.#course = course;
|
|
104
117
|
ctx.add(course.group);
|
|
105
118
|
ctx.entities.add("course", { debug: () => course.audit });
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
@source "../index.html";
|
|
4
4
|
@source "./";
|
|
5
|
+
/* `src/render/` is shader and material source: a word in its comments ("blur", "filter",
|
|
6
|
+
"table") became a real utility rule, which is what made a clean HUD look like a native-css
|
|
7
|
+
profile failure. Tailwind scans what it is told to scan. */
|
|
8
|
+
@source not "./render";
|
|
5
9
|
|
|
6
10
|
@theme {
|
|
7
11
|
--color-ink: #1d3a5c;
|
|
@@ -2,6 +2,7 @@ import tailwindcss from "@tailwindcss/vite";
|
|
|
2
2
|
import { watchAssets } from "@threenative/assets";
|
|
3
3
|
import react from "@vitejs/plugin-react";
|
|
4
4
|
import {
|
|
5
|
+
createEngineCatalogPlugin,
|
|
5
6
|
createEngineFreshnessPlugin,
|
|
6
7
|
createWebBrandPlugin,
|
|
7
8
|
webRuntimeDecoders,
|
|
@@ -36,6 +37,7 @@ export default defineConfig({
|
|
|
36
37
|
plugins: [
|
|
37
38
|
createEngineFreshnessPlugin(),
|
|
38
39
|
createWebBrandPlugin(),
|
|
40
|
+
createEngineCatalogPlugin(),
|
|
39
41
|
react(),
|
|
40
42
|
tailwindcss(),
|
|
41
43
|
assetsWatchPlugin(),
|
package/templates/kart/AGENTS.md
CHANGED
|
@@ -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
|
|
|
@@ -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`.
|
|
@@ -80,11 +82,14 @@ Each is on by default with a named override. Detail: `node_modules/create-threen
|
|
|
80
82
|
- **Frame spans** `#spans`: off. Override: `TN_FRAME_SPANS=1`. Marker: `TN_FRAME_SPANS`.
|
|
81
83
|
- **Multiplayer** `#net`: none; unsupported transport rejects. Override: `connect` from `@threenative/core/net` with four limits. Marker: `TN_NET_UNAVAILABLE`.
|
|
82
84
|
- **Desktop window** `#desktop-mode`: CLI, then `display.fullscreen`, then `window.maximized`. Override: `--windowed`; `--maximized`; `--fullscreen`.
|
|
85
|
+
- **CPU priority** `#cpu-priority`: game threads first. Override: `display.priority: "normal"`. Marker: `TN_PROCESS_PRIORITY`.
|
|
83
86
|
- **Terrain** `#terrain`: authored in the game. Override: optional `@threenative/terrain`; `references/terrain-authoring.md`.
|
|
84
87
|
- **Navigation** `#navigation`: none; browser-only WASM. Override: import `@threenative/physics/navigation` on purpose.
|
|
88
|
+
- **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`.
|
|
85
89
|
- **Scene change** `#scene-change`: `ctx.goto(name)` keeps state. Override: `game.goto(name)` resets state.
|
|
86
90
|
- **Randomness** `#seed`: unseeded. Override: `defineGame({ seed })`.
|
|
87
91
|
- **Engine** `#engine`: owned C++ engine. Override: `engine: "threejs"` only when the user asks. Marker: `TN_NATIVE_ENGINE_UNBOUND`.
|
|
92
|
+
- **Refused imports** `#engine-catalog`: refused `three` imports fail at their line. Override: `createEngineCatalogPlugin({ mode: "warn" })`. Marker: `TN_ENGINE_CATALOG`.
|
|
88
93
|
<!-- /shared -->
|
|
89
94
|
|
|
90
95
|
<!-- shared: kit-stuck -->
|
package/templates/kart/CLAUDE.md
CHANGED
|
@@ -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
|
|
|
@@ -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`.
|
|
@@ -82,11 +84,14 @@ Each is on by default with a named override. Detail: `node_modules/create-threen
|
|
|
82
84
|
- **Frame spans** `#spans`: off. Override: `TN_FRAME_SPANS=1`. Marker: `TN_FRAME_SPANS`.
|
|
83
85
|
- **Multiplayer** `#net`: none; unsupported transport rejects. Override: `connect` from `@threenative/core/net` with four limits. Marker: `TN_NET_UNAVAILABLE`.
|
|
84
86
|
- **Desktop window** `#desktop-mode`: CLI, then `display.fullscreen`, then `window.maximized`. Override: `--windowed`; `--maximized`; `--fullscreen`.
|
|
87
|
+
- **CPU priority** `#cpu-priority`: game threads first. Override: `display.priority: "normal"`. Marker: `TN_PROCESS_PRIORITY`.
|
|
85
88
|
- **Terrain** `#terrain`: authored in the game. Override: optional `@threenative/terrain`; `references/terrain-authoring.md`.
|
|
86
89
|
- **Navigation** `#navigation`: none; browser-only WASM. Override: import `@threenative/physics/navigation` on purpose.
|
|
90
|
+
- **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`.
|
|
87
91
|
- **Scene change** `#scene-change`: `ctx.goto(name)` keeps state. Override: `game.goto(name)` resets state.
|
|
88
92
|
- **Randomness** `#seed`: unseeded. Override: `defineGame({ seed })`.
|
|
89
93
|
- **Engine** `#engine`: owned C++ engine. Override: `engine: "threejs"` only when the user asks. Marker: `TN_NATIVE_ENGINE_UNBOUND`.
|
|
94
|
+
- **Refused imports** `#engine-catalog`: refused `three` imports fail at their line. Override: `createEngineCatalogPlugin({ mode: "warn" })`. Marker: `TN_ENGINE_CATALOG`.
|
|
90
95
|
<!-- /shared -->
|
|
91
96
|
|
|
92
97
|
<!-- shared: kit-stuck -->
|
|
@@ -19,8 +19,8 @@
|
|
|
19
19
|
"format:check": "biome format src"
|
|
20
20
|
},
|
|
21
21
|
"dependencies": {
|
|
22
|
-
"@threenative/core": "0.3.
|
|
23
|
-
"@threenative/ui": "0.3.
|
|
22
|
+
"@threenative/core": ">=0.3.15",
|
|
23
|
+
"@threenative/ui": ">=0.3.15",
|
|
24
24
|
"react": "19.2.0",
|
|
25
25
|
"react-dom": "19.2.0",
|
|
26
26
|
"three": "0.187.0"
|
|
@@ -29,11 +29,11 @@
|
|
|
29
29
|
"@tailwindcss/vite": "4.3.3",
|
|
30
30
|
"@vitejs/plugin-react": "6.0.5",
|
|
31
31
|
"@types/three": "0.187.0",
|
|
32
|
-
"@threenative/assets": "0.3.
|
|
33
|
-
"@threenative/playtest": "0.3.
|
|
32
|
+
"@threenative/assets": ">=0.3.16",
|
|
33
|
+
"@threenative/playtest": ">=0.3.15",
|
|
34
34
|
"@types/react": "19.2.0",
|
|
35
35
|
"@types/react-dom": "19.2.0",
|
|
36
|
-
"create-threenative": "0.2.
|
|
36
|
+
"create-threenative": "0.2.20",
|
|
37
37
|
"esbuild": "0.27.0",
|
|
38
38
|
"playwright": "1.62.1",
|
|
39
39
|
"tailwindcss": "4.3.3",
|
|
@@ -44,7 +44,7 @@
|
|
|
44
44
|
"eslint": "10.13.0"
|
|
45
45
|
},
|
|
46
46
|
"optionalDependencies": {
|
|
47
|
-
"@threenative/runtime-native": "0.3.
|
|
47
|
+
"@threenative/runtime-native": ">=0.3.15"
|
|
48
48
|
},
|
|
49
49
|
"overrides": {
|
|
50
50
|
"sharp": ">=0.35.4",
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { MathUtils } from "three";
|
|
1
2
|
import { type ICourse, SURFACE_DRAG, type Surface } from "../track/Course.js";
|
|
2
3
|
|
|
3
4
|
/**
|
|
@@ -327,7 +328,7 @@ export class Kart {
|
|
|
327
328
|
Math.max(0, 1 - resist) *
|
|
328
329
|
(1 + this.boost + this.miniTurbo + this.catchUp);
|
|
329
330
|
if (brake && this.throttle === 0 && this.speed < 0.5) target = -f.reverse;
|
|
330
|
-
this.speed
|
|
331
|
+
this.speed = MathUtils.damp(this.speed, target, 1 / f.lagTicks, ticks);
|
|
331
332
|
}
|
|
332
333
|
|
|
333
334
|
// Hop and drift. A press while grounded hops; with the stick held and enough speed the hop
|
|
@@ -15,6 +15,7 @@ import {
|
|
|
15
15
|
Group,
|
|
16
16
|
IcosahedronGeometry,
|
|
17
17
|
InstancedMesh,
|
|
18
|
+
MathUtils,
|
|
18
19
|
Matrix4,
|
|
19
20
|
Mesh,
|
|
20
21
|
MeshStandardMaterial,
|
|
@@ -521,7 +522,7 @@ export function buildCourseView(course: ICourse, seed = 734): ICourseView {
|
|
|
521
522
|
|
|
522
523
|
function smooth(edge0: number, edge1: number, x: number): number {
|
|
523
524
|
const t = Math.min(1, Math.max(0, (x - edge0) / (edge1 - edge0)));
|
|
524
|
-
return t
|
|
525
|
+
return MathUtils.smoothstep(t, 0, 1);
|
|
525
526
|
}
|
|
526
527
|
|
|
527
528
|
/** True when x/z is at least `clearance` metres from every sample of the line. */
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
@source "../index.html";
|
|
4
4
|
@source "./";
|
|
5
|
+
/* `src/render/` is shader and material source: a word in its comments ("blur", "filter",
|
|
6
|
+
"table") became a real utility rule, which is what made a clean HUD look like a native-css
|
|
7
|
+
profile failure. Tailwind scans what it is told to scan. */
|
|
8
|
+
@source not "./render";
|
|
5
9
|
|
|
6
10
|
@theme {
|
|
7
11
|
--color-ink: #1d3a5c;
|
|
@@ -10,6 +10,8 @@
|
|
|
10
10
|
*/
|
|
11
11
|
|
|
12
12
|
/** Metres between samples of the centre line. */
|
|
13
|
+
import { MathUtils } from "three";
|
|
14
|
+
|
|
13
15
|
export const STEP = 1;
|
|
14
16
|
|
|
15
17
|
/** The lateral profile, in metres from the centre line. */
|
|
@@ -69,7 +71,7 @@ function plateau(s: number, at: number, length: number, flat: number, ramp: numb
|
|
|
69
71
|
|
|
70
72
|
function smooth(edge0: number, edge1: number, x: number): number {
|
|
71
73
|
const t = Math.min(1, Math.max(0, (x - edge0) / (edge1 - edge0)));
|
|
72
|
-
return t
|
|
74
|
+
return MathUtils.smoothstep(t, 0, 1);
|
|
73
75
|
}
|
|
74
76
|
|
|
75
77
|
export interface ICourse {
|
|
@@ -2,6 +2,7 @@ import tailwindcss from "@tailwindcss/vite";
|
|
|
2
2
|
import { watchAssets } from "@threenative/assets";
|
|
3
3
|
import react from "@vitejs/plugin-react";
|
|
4
4
|
import {
|
|
5
|
+
createEngineCatalogPlugin,
|
|
5
6
|
createEngineFreshnessPlugin,
|
|
6
7
|
createWebBrandPlugin,
|
|
7
8
|
webRuntimeDecoders,
|
|
@@ -36,6 +37,7 @@ export default defineConfig({
|
|
|
36
37
|
plugins: [
|
|
37
38
|
createEngineFreshnessPlugin(),
|
|
38
39
|
createWebBrandPlugin(),
|
|
40
|
+
createEngineCatalogPlugin(),
|
|
39
41
|
react(),
|
|
40
42
|
tailwindcss(),
|
|
41
43
|
assetsWatchPlugin(),
|
|
@@ -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,7 +38,7 @@ 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/`: `conventions.ts`, `entities/`, `game.ts`, `main.ts`, `render/`, `scenes/`, `state.ts`.
|
|
41
|
-
|
|
41
|
+
7 scenarios in `playtests/`; `playtests/survives.playtest.json` is the smoke proof.
|
|
42
42
|
Exposure policy: `src/render/exposure.ts` (`node_modules/create-threenative/agent-docs/references/auto-exposure.md`).
|
|
43
43
|
Kit notes: `node_modules/create-threenative/agent-docs/references/kit-minimal.md`.
|
|
44
44
|
<!-- /shared -->
|
|
@@ -55,6 +55,7 @@ pnpm test # typecheck, lint, format, then every playtest
|
|
|
55
55
|
pnpm build --target desktop # also: web, android, ios
|
|
56
56
|
pnpm studio # open the game in Studio
|
|
57
57
|
npx threenative doctor # build, import, device or blank-frame failure
|
|
58
|
+
npx threenative doctor --fix # refresh agent files
|
|
58
59
|
```
|
|
59
60
|
<!-- /shared -->
|
|
60
61
|
|
|
@@ -64,6 +65,7 @@ npx threenative doctor # build, import, device or blank-frame failure
|
|
|
64
65
|
Each is on by default with a named override. Detail: `node_modules/create-threenative/agent-docs/references/conventions.md#<id>`.
|
|
65
66
|
|
|
66
67
|
- **Look** `#look`: filmic curve, metered auto exposure. Override: `tonemapMode: "aces"`; `autoExposureEnabled: false` + `exposure`. Marker: `TN_WORLD_ENVIRONMENT`.
|
|
68
|
+
- **Ambient occlusion** `#ao-indirect`: darkens indirect light only, not the sun. Override: `gtaoIndirectOnly: false`; `gtaoEnabled: false`. Marker: `TN_WORLD_ENVIRONMENT`.
|
|
67
69
|
- **Quality tier (`src/render/quality.ts`)** `#quality`: GPU class picks `high`, `medium` or `low`. Override: `setupPost(..., { tier: "low" })`. Marker: `TN_QUALITY_TIER`.
|
|
68
70
|
- **Resolution scale** `#resolution`: `"auto"`, 0.85 on mobile-low. Override: numeric `resolutionScale`. Marker: `TN_FRAME_BUDGET`.
|
|
69
71
|
- **Budget real time for the look** `#frame-budget`: frame meter and scene verdict on. Override: `frameBudget: false`. Marker: `TN_FRAME_BUDGET`, `TN_SCENE_WARNING`.
|
|
@@ -90,12 +92,15 @@ Each is on by default with a named override. Detail: `node_modules/create-threen
|
|
|
90
92
|
- **Frame spans** `#spans`: off. Override: `TN_FRAME_SPANS=1`. Marker: `TN_FRAME_SPANS`.
|
|
91
93
|
- **Multiplayer** `#net`: none; unsupported transport rejects. Override: `connect` from `@threenative/core/net` with four limits. Marker: `TN_NET_UNAVAILABLE`.
|
|
92
94
|
- **Desktop window** `#desktop-mode`: CLI, then `display.fullscreen`, then `window.maximized`. Override: `--windowed`; `--maximized`; `--fullscreen`.
|
|
95
|
+
- **CPU priority** `#cpu-priority`: game threads first. Override: `display.priority: "normal"`. Marker: `TN_PROCESS_PRIORITY`.
|
|
93
96
|
- **Terrain** `#terrain`: authored in the game. Override: optional `@threenative/terrain`; `references/terrain-authoring.md`.
|
|
94
97
|
- **Navigation** `#navigation`: none; browser-only WASM. Override: import `@threenative/physics/navigation` on purpose.
|
|
98
|
+
- **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`.
|
|
95
99
|
- **Move input** `#move-axis`: `input.vector("move").y` is +up. Override: one explicit `-move.y` conversion.
|
|
96
100
|
- **Scene change** `#scene-change`: `ctx.goto(name)` keeps state. Override: `game.goto(name)` resets state.
|
|
97
101
|
- **Randomness** `#seed`: unseeded. Override: `defineGame({ seed })`.
|
|
98
102
|
- **Engine** `#engine`: owned C++ engine. Override: `engine: "threejs"` only when the user asks. Marker: `TN_NATIVE_ENGINE_UNBOUND`.
|
|
103
|
+
- **Refused imports** `#engine-catalog`: refused `three` imports fail at their line. Override: `createEngineCatalogPlugin({ mode: "warn" })`. Marker: `TN_ENGINE_CATALOG`.
|
|
99
104
|
<!-- /shared -->
|
|
100
105
|
|
|
101
106
|
<!-- shared: kit-stuck -->
|