create-threenative 0.2.10 → 0.2.13
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/references/assertion-reference.md +109 -3
- package/agent-docs/references/auto-exposure.md +28 -45
- package/agent-docs/references/build-profiles.md +1 -1
- package/agent-docs/references/capability-reference.md +527 -44
- package/agent-docs/references/debug-surface.md +64 -0
- package/agent-docs/references/finding-assets.md +11 -12
- package/agent-docs/references/performance-basics.md +19 -0
- package/agent-docs/references/trace-a-slow-frame.md +21 -0
- package/agent-docs/references/visual-baseline.md +23 -4
- package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
- package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
- package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
- package/agent-files/scripts/reference.mjs +9 -4
- package/capabilities.json +739 -50
- package/dist/index.d.ts +40 -6
- package/dist/index.js +227 -34
- package/dist/quality.d.ts +12 -0
- package/dist/quality.js +166747 -0
- package/dist/threenative.js +60 -44
- package/dist/web-engine-gltf-loader.js +2 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
- package/dist/web-engine-mesh-bvh.js +7 -0
- package/dist/web-engine-post-effects.js +645 -19
- package/dist/web-engine-runtime.js +3528 -343
- package/package.json +19 -9
- package/template-assets/assets/bay-PROVENANCE.md +21 -0
- package/template-assets/assets/bay-ground.webp +0 -0
- package/template-assets/assets/bay-metal.webp +0 -0
- package/template-assets/assets/bay-pavement-normal.webp +0 -0
- package/template-assets/assets/bay-pavement.webp +0 -0
- package/template-assets/assets/bay-plaster-normal.webp +0 -0
- package/template-assets/assets/bay-plaster.webp +0 -0
- package/template-assets/assets/bay-wood-normal.webp +0 -0
- package/template-assets/assets/bay-wood.webp +0 -0
- package/template-assets/assets/tex-PROVENANCE.md +25 -0
- package/template-assets/assets/tex-bark-normal.webp +0 -0
- package/template-assets/assets/tex-bark.webp +0 -0
- package/template-assets/assets/tex-birch-bark.webp +0 -0
- package/template-assets/assets/tex-grass.webp +0 -0
- package/template-assets/assets/tex-planks-normal.webp +0 -0
- package/template-assets/assets/tex-planks.webp +0 -0
- package/template-assets/assets/tex-rock-normal.webp +0 -0
- package/template-assets/assets/tex-rock.webp +0 -0
- package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
- package/template-assets/assets/tex-roof-tiles.webp +0 -0
- package/template-assets/assets/tex-sand-normal.webp +0 -0
- package/template-assets/assets/tex-sand.webp +0 -0
- package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
- package/template-assets/assets/tex-stone-wall.webp +0 -0
- package/template-assets/kitExposure.ts +20 -0
- package/template-assets/patches/three@0.185.1.patch +481 -272
- package/template-assets/quality/biome.json +7 -0
- package/template-assets/quality/eslint.config.js +3 -0
- package/template-assets/realistic-ocean/README.md +113 -0
- package/template-assets/realistic-ocean/install.mjs +56 -0
- package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
- package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
- package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
- package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
- package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
- package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
- package/templates/AGENTS.md +21 -0
- package/templates/CLAUDE.md +23 -0
- package/templates/action-rpg/.codex/config.toml +6 -2
- package/templates/action-rpg/.cursor/mcp.json +8 -2
- package/templates/action-rpg/.gemini/settings.json +8 -2
- package/templates/action-rpg/.mcp.json +8 -2
- package/templates/action-rpg/.vscode/mcp.json +9 -2
- package/templates/action-rpg/.zed/settings.json +9 -2
- package/templates/action-rpg/AGENTS.md +11 -11
- package/templates/action-rpg/CLAUDE.md +11 -11
- package/templates/action-rpg/opencode.json +10 -2
- package/templates/action-rpg/package.json +15 -10
- package/templates/action-rpg/playtests/combat.playtest.json +6 -0
- package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
- package/templates/action-rpg/playtests/performance.playtest.json +1 -1
- package/templates/action-rpg/playtests/roll.playtest.json +112 -0
- package/templates/action-rpg/playtests/swing.playtest.json +55 -0
- package/templates/action-rpg/playtests/win.playtest.json +4 -4
- package/templates/action-rpg/src/entities/Fighter.ts +44 -4
- package/templates/action-rpg/src/entities/Player.ts +64 -12
- package/templates/action-rpg/src/render/atmosphere.ts +444 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
- package/templates/action-rpg/src/render/clouds.ts +605 -0
- package/templates/action-rpg/src/render/dungeon.ts +8 -6
- package/templates/action-rpg/src/render/exposure.ts +11 -109
- package/templates/action-rpg/src/render/gpuSky.ts +752 -0
- package/templates/action-rpg/src/render/lighting.ts +27 -4
- package/templates/action-rpg/src/render/materialLighting.ts +2 -11
- package/templates/action-rpg/src/render/palette.ts +1 -0
- package/templates/action-rpg/src/render/postprocessing.ts +4 -4
- package/templates/action-rpg/src/render/props.ts +10 -8
- package/templates/action-rpg/src/render/quality.ts +56 -108
- package/templates/action-rpg/src/render/sky.ts +74 -1
- package/templates/action-rpg/src/scenes/Play.ts +16 -12
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
- package/templates/action-rpg/src/ui/Hud.tsx +5 -7
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/adventure/.codex/config.toml +23 -0
- package/templates/adventure/.cursor/mcp.json +38 -0
- package/templates/adventure/.gemini/settings.json +38 -0
- package/templates/adventure/.mcp.json +38 -0
- package/templates/adventure/.vscode/mcp.json +43 -0
- package/templates/adventure/.zed/settings.json +43 -0
- package/templates/adventure/AGENTS.md +60 -0
- package/templates/adventure/CLAUDE.md +62 -0
- package/templates/adventure/index.html +14 -0
- package/templates/adventure/kit.json +8 -0
- package/templates/adventure/native-playtests/survives.playtest.json +52 -0
- package/templates/adventure/opencode.json +49 -0
- package/templates/adventure/package.json +65 -0
- package/templates/adventure/playtests/boss.playtest.json +406 -0
- package/templates/adventure/playtests/combat.playtest.json +342 -0
- package/templates/adventure/playtests/controls.playtest.json +142 -0
- package/templates/adventure/playtests/explore.playtest.json +45 -0
- package/templates/adventure/playtests/flicker.playtest.json +206 -0
- package/templates/adventure/playtests/hearts.playtest.json +171 -0
- package/templates/adventure/playtests/lockon.playtest.json +256 -0
- package/templates/adventure/playtests/look.playtest.json +72 -0
- package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
- package/templates/adventure/playtests/move.playtest.json +84 -0
- package/templates/adventure/playtests/performance.playtest.json +55 -0
- package/templates/adventure/playtests/puzzle.playtest.json +250 -0
- package/templates/adventure/playtests/stride.playtest.json +67 -0
- package/templates/adventure/playtests/survives.playtest.json +171 -0
- package/templates/adventure/playtests/thornback.playtest.json +267 -0
- package/templates/adventure/public/favicon.svg +4 -0
- package/templates/adventure/src/entities/Block.ts +114 -0
- package/templates/adventure/src/entities/Chest.ts +69 -0
- package/templates/adventure/src/entities/Door.ts +81 -0
- package/templates/adventure/src/entities/Dummy.ts +69 -0
- package/templates/adventure/src/entities/Flicker.ts +239 -0
- package/templates/adventure/src/entities/Hero.ts +561 -0
- package/templates/adventure/src/entities/LockOn.ts +180 -0
- package/templates/adventure/src/entities/Mossling.ts +249 -0
- package/templates/adventure/src/entities/Switch.ts +49 -0
- package/templates/adventure/src/entities/Thornback.ts +238 -0
- package/templates/adventure/src/entities/Warden.ts +196 -0
- package/templates/adventure/src/game.ts +65 -0
- package/templates/adventure/src/interact.ts +63 -0
- package/templates/adventure/src/level/Hollow.ts +240 -0
- package/templates/adventure/src/level/Vale.ts +383 -0
- package/templates/adventure/src/main.ts +18 -0
- package/templates/adventure/src/render/camera.ts +416 -0
- package/templates/adventure/src/render/creatures.ts +405 -0
- package/templates/adventure/src/render/effects.ts +333 -0
- package/templates/adventure/src/render/foliage.ts +1072 -0
- package/templates/adventure/src/render/hero.ts +1447 -0
- package/templates/adventure/src/render/kitExposure.ts +20 -0
- package/templates/adventure/src/render/lighting.ts +74 -0
- package/templates/adventure/src/render/loading.ts +332 -0
- package/templates/adventure/src/render/materials.ts +179 -0
- package/templates/adventure/src/render/palette.ts +137 -0
- package/templates/adventure/src/render/postprocessing.ts +70 -0
- package/templates/adventure/src/render/props.ts +383 -0
- package/templates/adventure/src/render/quality.ts +46 -0
- package/templates/adventure/src/render/sky.ts +271 -0
- package/templates/adventure/src/render/surface.ts +259 -0
- package/templates/adventure/src/render/touch-controls.ts +137 -0
- package/templates/adventure/src/scenes/Play.ts +959 -0
- package/templates/adventure/src/state.ts +113 -0
- package/templates/adventure/src/style.css +98 -0
- package/templates/adventure/src/ui/App.tsx +22 -0
- package/templates/adventure/src/ui/GameUi.tsx +20 -0
- package/templates/adventure/src/ui/Hud.tsx +70 -0
- package/templates/adventure/src/ui/Menu.tsx +15 -0
- package/templates/adventure/src/ui/main.tsx +14 -0
- package/templates/adventure/tailwind.config.ts +2 -0
- package/templates/adventure/threenative.config.ts +62 -0
- package/templates/adventure/tsconfig.json +17 -0
- package/templates/adventure/vite.config.ts +49 -0
- package/templates/collectathon/.codex/config.toml +23 -0
- package/templates/collectathon/.cursor/mcp.json +38 -0
- package/templates/collectathon/.gemini/settings.json +38 -0
- package/templates/collectathon/.mcp.json +38 -0
- package/templates/collectathon/.vscode/mcp.json +43 -0
- package/templates/collectathon/.zed/settings.json +43 -0
- package/templates/collectathon/AGENTS.md +58 -0
- package/templates/collectathon/CLAUDE.md +60 -0
- package/templates/collectathon/index.html +14 -0
- package/templates/collectathon/kit.json +8 -0
- package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
- package/templates/collectathon/opencode.json +49 -0
- package/templates/collectathon/package.json +65 -0
- package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
- package/templates/collectathon/playtests/camera.playtest.json +80 -0
- package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
- package/templates/collectathon/playtests/collect.playtest.json +196 -0
- package/templates/collectathon/playtests/combat.playtest.json +246 -0
- package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
- package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
- package/templates/collectathon/playtests/effects.playtest.json +124 -0
- package/templates/collectathon/playtests/enemies.playtest.json +295 -0
- package/templates/collectathon/playtests/explore.playtest.json +45 -0
- package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
- package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
- package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
- package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
- package/templates/collectathon/playtests/ledge.playtest.json +100 -0
- package/templates/collectathon/playtests/look.playtest.json +64 -0
- package/templates/collectathon/playtests/performance.playtest.json +55 -0
- package/templates/collectathon/playtests/stride.playtest.json +111 -0
- package/templates/collectathon/playtests/survives.playtest.json +123 -0
- package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
- package/templates/collectathon/playtests/thornback.playtest.json +157 -0
- package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
- package/templates/collectathon/playtests/win.playtest.json +166 -0
- package/templates/collectathon/public/favicon.svg +4 -0
- package/templates/collectathon/src/entities/Hero.ts +915 -0
- package/templates/collectathon/src/entities/Pickup.ts +63 -0
- package/templates/collectathon/src/entities/Walker.ts +248 -0
- package/templates/collectathon/src/game.ts +51 -0
- package/templates/collectathon/src/level/Course.ts +590 -0
- package/templates/collectathon/src/level/terrain.ts +144 -0
- package/templates/collectathon/src/main.ts +14 -0
- package/templates/collectathon/src/playtest-events.ts +15 -0
- package/templates/collectathon/src/render/camera.ts +163 -0
- package/templates/collectathon/src/render/castle.ts +408 -0
- package/templates/collectathon/src/render/effects.ts +284 -0
- package/templates/collectathon/src/render/foliage.ts +744 -0
- package/templates/collectathon/src/render/ground.ts +139 -0
- package/templates/collectathon/src/render/hero.ts +452 -0
- package/templates/collectathon/src/render/kitExposure.ts +20 -0
- package/templates/collectathon/src/render/lighting.ts +65 -0
- package/templates/collectathon/src/render/loading.ts +332 -0
- package/templates/collectathon/src/render/materials.ts +196 -0
- package/templates/collectathon/src/render/palette.ts +82 -0
- package/templates/collectathon/src/render/postprocessing.ts +79 -0
- package/templates/collectathon/src/render/props.ts +218 -0
- package/templates/collectathon/src/render/quality.ts +54 -0
- package/templates/collectathon/src/render/sky.ts +262 -0
- package/templates/collectathon/src/render/surface.ts +269 -0
- package/templates/collectathon/src/render/touch-controls.ts +179 -0
- package/templates/collectathon/src/render/touch-layout.ts +48 -0
- package/templates/collectathon/src/render/water.ts +191 -0
- package/templates/collectathon/src/scenes/Play.ts +481 -0
- package/templates/collectathon/src/state.ts +38 -0
- package/templates/collectathon/src/style.css +106 -0
- package/templates/collectathon/src/ui/App.tsx +22 -0
- package/templates/collectathon/src/ui/GameUi.tsx +20 -0
- package/templates/collectathon/src/ui/Hud.tsx +77 -0
- package/templates/collectathon/src/ui/Menu.tsx +13 -0
- package/templates/collectathon/src/ui/main.tsx +14 -0
- package/templates/collectathon/tailwind.config.ts +2 -0
- package/templates/collectathon/threenative.config.ts +62 -0
- package/templates/collectathon/tsconfig.json +17 -0
- package/templates/collectathon/vite.config.ts +49 -0
- package/templates/kart/.codex/config.toml +23 -0
- package/templates/kart/.cursor/mcp.json +38 -0
- package/templates/kart/.gemini/settings.json +38 -0
- package/templates/kart/.mcp.json +38 -0
- package/templates/kart/.vscode/mcp.json +43 -0
- package/templates/kart/.zed/settings.json +43 -0
- package/templates/kart/AGENTS.md +58 -0
- package/templates/kart/CLAUDE.md +60 -0
- package/templates/kart/index.html +14 -0
- package/templates/kart/kit.json +8 -0
- package/templates/kart/native-playtests/survives.playtest.json +65 -0
- package/templates/kart/opencode.json +49 -0
- package/templates/kart/package.json +64 -0
- package/templates/kart/playtests/drift.playtest.json +226 -0
- package/templates/kart/playtests/explore.playtest.json +45 -0
- package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
- package/templates/kart/playtests/item-key.playtest.json +108 -0
- package/templates/kart/playtests/items.playtest.json +143 -0
- package/templates/kart/playtests/lap-times.playtest.json +138 -0
- package/templates/kart/playtests/laps.playtest.json +149 -0
- package/templates/kart/playtests/performance.playtest.json +57 -0
- package/templates/kart/playtests/race.playtest.json +294 -0
- package/templates/kart/playtests/restart.playtest.json +87 -0
- package/templates/kart/playtests/rocket-start.playtest.json +56 -0
- package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
- package/templates/kart/playtests/surfaces.playtest.json +113 -0
- package/templates/kart/playtests/survives.playtest.json +116 -0
- package/templates/kart/playtests/wall.playtest.json +118 -0
- package/templates/kart/public/favicon.svg +4 -0
- package/templates/kart/src/entities/Driver.ts +123 -0
- package/templates/kart/src/entities/Items.ts +194 -0
- package/templates/kart/src/entities/Kart.ts +517 -0
- package/templates/kart/src/game.ts +45 -0
- package/templates/kart/src/main.ts +14 -0
- package/templates/kart/src/playtest-events.ts +15 -0
- package/templates/kart/src/render/camera.ts +83 -0
- package/templates/kart/src/render/course.ts +579 -0
- package/templates/kart/src/render/effects.ts +266 -0
- package/templates/kart/src/render/items.ts +163 -0
- package/templates/kart/src/render/kart.ts +256 -0
- package/templates/kart/src/render/kitExposure.ts +20 -0
- package/templates/kart/src/render/lighting.ts +58 -0
- package/templates/kart/src/render/loading.ts +332 -0
- package/templates/kart/src/render/materials.ts +119 -0
- package/templates/kart/src/render/palette.ts +74 -0
- package/templates/kart/src/render/postprocessing.ts +79 -0
- package/templates/kart/src/render/quality.ts +54 -0
- package/templates/kart/src/render/skids.ts +86 -0
- package/templates/kart/src/render/sky.ts +105 -0
- package/templates/kart/src/render/touch-controls.ts +168 -0
- package/templates/kart/src/render/touch-layout.ts +48 -0
- package/templates/kart/src/scenes/Race.ts +850 -0
- package/templates/kart/src/state.ts +53 -0
- package/templates/kart/src/style.css +106 -0
- package/templates/kart/src/track/Course.ts +276 -0
- package/templates/kart/src/track/Race.ts +133 -0
- package/templates/kart/src/ui/App.tsx +21 -0
- package/templates/kart/src/ui/GameUi.tsx +20 -0
- package/templates/kart/src/ui/Hud.tsx +172 -0
- package/templates/kart/src/ui/Menu.tsx +13 -0
- package/templates/kart/src/ui/main.tsx +14 -0
- package/templates/kart/tailwind.config.ts +2 -0
- package/templates/kart/threenative.config.ts +62 -0
- package/templates/kart/tsconfig.json +17 -0
- package/templates/kart/vite.config.ts +49 -0
- package/templates/minimal/.codex/config.toml +6 -2
- package/templates/minimal/.cursor/mcp.json +8 -2
- package/templates/minimal/.gemini/settings.json +8 -2
- package/templates/minimal/.mcp.json +8 -2
- package/templates/minimal/.vscode/mcp.json +9 -2
- package/templates/minimal/.zed/settings.json +9 -2
- package/templates/minimal/AGENTS.md +11 -13
- package/templates/minimal/CLAUDE.md +11 -13
- package/templates/minimal/opencode.json +10 -2
- package/templates/minimal/package.json +14 -9
- package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
- package/templates/minimal/playtests/jump.playtest.json +45 -0
- package/templates/minimal/playtests/play.playtest.json +1 -1
- package/templates/minimal/src/game.ts +2 -0
- package/templates/minimal/src/render/atmosphere.ts +444 -0
- package/templates/minimal/src/render/backlightMaterial.ts +49 -18
- package/templates/minimal/src/render/camera.ts +35 -4
- package/templates/minimal/src/render/clouds.ts +605 -0
- package/templates/minimal/src/render/exposure.ts +7 -111
- package/templates/minimal/src/render/gpuSky.ts +752 -0
- package/templates/minimal/src/render/lighting.ts +26 -4
- package/templates/minimal/src/render/materialLighting.ts +2 -10
- package/templates/minimal/src/render/postprocessing.ts +4 -4
- package/templates/minimal/src/render/quality.ts +10 -116
- package/templates/minimal/src/render/sky.ts +73 -1
- package/templates/minimal/src/scenes/Play.ts +18 -7
- package/templates/platformer/.codex/config.toml +6 -2
- package/templates/platformer/.cursor/mcp.json +8 -2
- package/templates/platformer/.gemini/settings.json +8 -2
- package/templates/platformer/.mcp.json +8 -2
- package/templates/platformer/.vscode/mcp.json +9 -2
- package/templates/platformer/.zed/settings.json +9 -2
- package/templates/platformer/AGENTS.md +13 -9
- package/templates/platformer/CLAUDE.md +13 -9
- package/templates/platformer/opencode.json +10 -2
- package/templates/platformer/package.json +15 -10
- package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
- package/templates/platformer/playtests/finish.playtest.json +58 -0
- package/templates/platformer/playtests/idle.playtest.json +44 -0
- package/templates/platformer/playtests/performance.playtest.json +1 -1
- package/templates/platformer/src/entities/Fox.ts +19 -6
- package/templates/platformer/src/game.ts +1 -0
- package/templates/platformer/src/level/Stage.ts +4 -1
- package/templates/platformer/src/render/backlightMaterial.ts +49 -18
- package/templates/platformer/src/render/camera.ts +30 -1
- package/templates/platformer/src/render/exposure.ts +6 -111
- package/templates/platformer/src/render/fox.ts +5 -2
- package/templates/platformer/src/render/kitExposure.ts +20 -0
- package/templates/platformer/src/render/materialLighting.ts +2 -11
- package/templates/platformer/src/render/postprocessing.ts +4 -4
- package/templates/platformer/src/render/props.ts +1 -2
- package/templates/platformer/src/render/quality.ts +10 -118
- package/templates/platformer/src/scenes/Play.ts +31 -15
- package/templates/platformer/src/ui/Menu.tsx +1 -1
- package/templates/puzzle/.codex/config.toml +6 -2
- package/templates/puzzle/.cursor/mcp.json +8 -2
- package/templates/puzzle/.gemini/settings.json +8 -2
- package/templates/puzzle/.mcp.json +8 -2
- package/templates/puzzle/.vscode/mcp.json +9 -2
- package/templates/puzzle/.zed/settings.json +9 -2
- package/templates/puzzle/AGENTS.md +14 -17
- package/templates/puzzle/CLAUDE.md +14 -17
- package/templates/puzzle/opencode.json +10 -2
- package/templates/puzzle/package.json +15 -10
- package/templates/puzzle/playtests/performance.playtest.json +1 -1
- package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
- package/templates/puzzle/src/render/exposure.ts +11 -109
- package/templates/puzzle/src/render/lighting.ts +3 -3
- package/templates/puzzle/src/render/materialLighting.ts +2 -11
- package/templates/puzzle/src/render/palette.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +4 -4
- package/templates/puzzle/src/render/quality.ts +44 -153
- package/templates/puzzle/src/render/vault.ts +18 -6
- package/templates/puzzle/src/scenes/Play.ts +6 -1
- package/templates/puzzle/src/ui/Hud.tsx +8 -43
- package/templates/racing/.codex/config.toml +6 -2
- package/templates/racing/.cursor/mcp.json +8 -2
- package/templates/racing/.gemini/settings.json +8 -2
- package/templates/racing/.mcp.json +8 -2
- package/templates/racing/.vscode/mcp.json +9 -2
- package/templates/racing/.zed/settings.json +9 -2
- package/templates/racing/AGENTS.md +10 -12
- package/templates/racing/CLAUDE.md +10 -12
- package/templates/racing/opencode.json +10 -2
- package/templates/racing/package.json +15 -10
- package/templates/racing/playtests/brake.playtest.json +54 -0
- package/templates/racing/playtests/outcome.playtest.json +19 -0
- package/templates/racing/playtests/performance.playtest.json +1 -1
- package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
- package/templates/racing/src/entities/RacingCar.ts +12 -3
- package/templates/racing/src/entities/Rival.ts +11 -2
- package/templates/racing/src/render/atmosphere.ts +444 -0
- package/templates/racing/src/render/backlightMaterial.ts +49 -18
- package/templates/racing/src/render/clouds.ts +605 -0
- package/templates/racing/src/render/exposure.ts +6 -111
- package/templates/racing/src/render/gpuSky.ts +752 -0
- package/templates/racing/src/render/kitExposure.ts +20 -0
- package/templates/racing/src/render/lighting.ts +26 -4
- package/templates/racing/src/render/materialLighting.ts +2 -11
- package/templates/racing/src/render/materials.ts +2 -1
- package/templates/racing/src/render/postprocessing.ts +4 -4
- package/templates/racing/src/render/quality.ts +27 -115
- package/templates/racing/src/render/sky.ts +72 -1
- package/templates/racing/src/scenes/Race.ts +9 -7
- package/templates/racing/src/track/TrackSector.ts +5 -2
- package/templates/racing/src/ui/Hud.tsx +12 -7
- package/templates/rain/.codex/config.toml +6 -2
- package/templates/rain/.cursor/mcp.json +8 -2
- package/templates/rain/.gemini/settings.json +8 -2
- package/templates/rain/.mcp.json +8 -2
- package/templates/rain/.vscode/mcp.json +9 -2
- package/templates/rain/.zed/settings.json +9 -2
- package/templates/rain/AGENTS.md +12 -12
- package/templates/rain/CLAUDE.md +12 -12
- package/templates/rain/opencode.json +10 -2
- package/templates/rain/package.json +14 -9
- package/templates/rain/playtests/performance.playtest.json +1 -1
- package/templates/rain/src/game.ts +1 -1
- package/templates/rain/src/render/bloom-shader.ts +1 -1
- package/templates/rain/src/render/clouds-shader.ts +2 -2
- package/templates/rain/src/render/clouds.ts +2 -1
- package/templates/rain/src/render/exposure.ts +11 -109
- package/templates/rain/src/render/post-shader.ts +7 -11
- package/templates/rain/src/render/postprocessing.ts +8 -24
- package/templates/rain/src/render/quality.ts +44 -98
- package/templates/rain/src/render/world-shader.ts +281 -97
- package/templates/rain/src/render/world.ts +82 -2
- package/templates/rain/src/style.css +1 -1
- package/templates/rain/src/ui/GameUi.tsx +6 -2
- package/templates/rain/src/ui/Hud.tsx +1 -1
- package/templates/rain/tools/generate-shaders.mjs +2 -2
- package/templates/rain/tools/tempest-post.frag +4 -6
- package/templates/rain/tools/tempest-world.frag +80 -12
- package/templates/rts/.codex/config.toml +6 -2
- package/templates/rts/.cursor/mcp.json +8 -2
- package/templates/rts/.gemini/settings.json +8 -2
- package/templates/rts/.mcp.json +8 -2
- package/templates/rts/.vscode/mcp.json +9 -2
- package/templates/rts/.zed/settings.json +9 -2
- package/templates/rts/AGENTS.md +15 -16
- package/templates/rts/CLAUDE.md +15 -16
- package/templates/rts/opencode.json +10 -2
- package/templates/rts/package.json +14 -9
- package/templates/rts/playtests/performance.playtest.json +1 -1
- package/templates/rts/playtests/rts-attack.playtest.json +5 -0
- package/templates/rts/playtests/rts-build.playtest.json +20 -1
- package/templates/rts/playtests/rts-orders.playtest.json +1 -1
- package/templates/rts/playtests/rts-pause.playtest.json +112 -0
- package/templates/rts/playtests/rts-train.playtest.json +1 -1
- package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
- package/templates/rts/src/game.ts +29 -7
- package/templates/rts/src/render/army.ts +181 -49
- package/templates/rts/src/render/backlightMaterial.ts +49 -18
- package/templates/rts/src/render/environment.ts +276 -0
- package/templates/rts/src/render/exposure.ts +3 -65
- package/templates/rts/src/render/ground.ts +478 -0
- package/templates/rts/src/render/lighting.ts +62 -11
- package/templates/rts/src/render/materialLighting.ts +2 -11
- package/templates/rts/src/render/materials.ts +47 -118
- package/templates/rts/src/render/palette.ts +30 -13
- package/templates/rts/src/render/picking.ts +18 -0
- package/templates/rts/src/render/postprocessing.ts +4 -4
- package/templates/rts/src/render/quality.ts +64 -85
- package/templates/rts/src/render/resources.ts +21 -22
- package/templates/rts/src/render/sky.ts +9 -12
- package/templates/rts/src/render/terrain.ts +36 -11
- package/templates/rts/src/scenes/Play.ts +373 -38
- package/templates/rts/src/sim/ai.ts +0 -11
- package/templates/rts/src/state.ts +46 -0
- package/templates/rts/src/style.css +1543 -0
- package/templates/rts/src/ui/Commands.tsx +204 -107
- package/templates/rts/src/ui/GameUi.tsx +12 -5
- package/templates/rts/src/ui/Hud.tsx +611 -116
- package/templates/rts/src/ui/Minimap.tsx +103 -37
- package/templates/rts/src/ui/icons.tsx +116 -0
- package/templates/rts/src/ui/labels.ts +73 -0
- package/templates/rts/src/ui/minimapPoint.ts +30 -0
- package/templates/rts/threenative.config.ts +1 -1
- package/templates/runner/.codex/config.toml +6 -2
- package/templates/runner/.cursor/mcp.json +8 -2
- package/templates/runner/.gemini/settings.json +8 -2
- package/templates/runner/.mcp.json +8 -2
- package/templates/runner/.vscode/mcp.json +9 -2
- package/templates/runner/.zed/settings.json +9 -2
- package/templates/runner/AGENTS.md +12 -12
- package/templates/runner/CLAUDE.md +12 -12
- package/templates/runner/opencode.json +10 -2
- package/templates/runner/package.json +15 -10
- package/templates/runner/playtests/near-miss.playtest.json +48 -0
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/playtests/stride.playtest.json +27 -0
- package/templates/runner/playtests/survives.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +3 -1
- package/templates/runner/src/entities/Runner.ts +11 -5
- package/templates/runner/src/render/atmosphere.ts +444 -0
- package/templates/runner/src/render/backlightMaterial.ts +49 -18
- package/templates/runner/src/render/clouds.ts +605 -0
- package/templates/runner/src/render/exposure.ts +6 -111
- package/templates/runner/src/render/gpuSky.ts +752 -0
- package/templates/runner/src/render/kitExposure.ts +20 -0
- package/templates/runner/src/render/lighting.ts +26 -4
- package/templates/runner/src/render/materialLighting.ts +2 -11
- package/templates/runner/src/render/postprocessing.ts +4 -4
- package/templates/runner/src/render/quality.ts +26 -114
- package/templates/runner/src/render/sky.ts +73 -1
- package/templates/runner/src/scenes/Run.ts +19 -15
- package/templates/runner/src/track.ts +12 -3
- package/templates/sailing/.codex/config.toml +6 -2
- package/templates/sailing/.cursor/mcp.json +8 -2
- package/templates/sailing/.gemini/settings.json +8 -2
- package/templates/sailing/.mcp.json +8 -2
- package/templates/sailing/.vscode/mcp.json +9 -2
- package/templates/sailing/.zed/settings.json +9 -2
- package/templates/sailing/AGENTS.md +10 -11
- package/templates/sailing/CLAUDE.md +10 -11
- package/templates/sailing/opencode.json +10 -2
- package/templates/sailing/package.json +15 -10
- package/templates/sailing/playtests/fail.playtest.json +46 -5
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
- package/templates/sailing/playtests/performance.playtest.json +1 -1
- package/templates/sailing/src/game.ts +1 -0
- package/templates/sailing/src/render/backlightMaterial.ts +49 -18
- package/templates/sailing/src/render/exposure.ts +6 -111
- package/templates/sailing/src/render/kitExposure.ts +20 -0
- package/templates/sailing/src/render/materialLighting.ts +2 -11
- package/templates/sailing/src/render/ocean.ts +0 -1
- package/templates/sailing/src/render/postprocessing.ts +4 -4
- package/templates/sailing/src/render/quality.ts +31 -138
- package/templates/sailing/src/scenes/Sailing.ts +12 -4
- package/templates/sailing/src/ui/Hud.tsx +6 -2
- package/templates/sailing/src/ui/Menu.tsx +1 -1
- package/templates/shooter/.codex/config.toml +6 -2
- package/templates/shooter/.cursor/mcp.json +8 -2
- package/templates/shooter/.gemini/settings.json +8 -2
- package/templates/shooter/.mcp.json +8 -2
- package/templates/shooter/.vscode/mcp.json +9 -2
- package/templates/shooter/.zed/settings.json +9 -2
- package/templates/shooter/AGENTS.md +13 -12
- package/templates/shooter/CLAUDE.md +13 -12
- package/templates/shooter/index.html +1 -1
- package/templates/shooter/main.html +13 -0
- package/templates/shooter/opencode.json +10 -2
- package/templates/shooter/package.json +15 -10
- package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
- package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
- package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
- package/templates/shooter/playtests/performance.playtest.json +3 -3
- package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
- package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
- package/templates/shooter/src/entities/Breakables.ts +34 -10
- package/templates/shooter/src/entities/Enemy.ts +176 -54
- package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
- package/templates/shooter/src/entities/Rifle.ts +83 -9
- package/templates/shooter/src/entities/movement.ts +96 -0
- package/templates/shooter/src/render/atmosphere.ts +444 -0
- package/templates/shooter/src/render/backlightMaterial.ts +49 -18
- package/templates/shooter/src/render/camera.ts +3 -1
- package/templates/shooter/src/render/clouds.ts +605 -0
- package/templates/shooter/src/render/exposure.ts +10 -109
- package/templates/shooter/src/render/facade.ts +26 -68
- package/templates/shooter/src/render/gpuSky.ts +752 -0
- package/templates/shooter/src/render/lighting.ts +27 -4
- package/templates/shooter/src/render/materialAssignments.ts +9 -1
- package/templates/shooter/src/render/materialLighting.ts +2 -11
- package/templates/shooter/src/render/occlusion.ts +13 -4
- package/templates/shooter/src/render/palette.ts +1 -0
- package/templates/shooter/src/render/postprocessing.ts +4 -4
- package/templates/shooter/src/render/quality.ts +50 -108
- package/templates/shooter/src/render/scale.ts +0 -11
- package/templates/shooter/src/render/sky.ts +103 -2
- package/templates/shooter/src/render/surface.ts +140 -0
- package/templates/shooter/src/render/town.ts +3 -6
- package/templates/shooter/src/render/townMaterials.ts +95 -42
- package/templates/shooter/src/render/vehicles.ts +2 -0
- package/templates/shooter/src/scenes/Play.ts +83 -23
- package/templates/shooter/src/ui/Hud.tsx +268 -193
- package/templates/shooter/src/worker-page.ts +29 -0
- package/templates/shooter/src/worker.ts +5 -0
- package/templates/shooter/threenative.config.ts +3 -0
- package/templates/shooter/vite.config.ts +2 -0
- package/templates/snow/.codex/config.toml +6 -2
- package/templates/snow/.cursor/mcp.json +8 -2
- package/templates/snow/.gemini/settings.json +8 -2
- package/templates/snow/.mcp.json +8 -2
- package/templates/snow/.vscode/mcp.json +9 -2
- package/templates/snow/.zed/settings.json +9 -2
- package/templates/snow/AGENTS.md +12 -10
- package/templates/snow/CLAUDE.md +12 -10
- package/templates/snow/opencode.json +10 -2
- package/templates/snow/package.json +15 -10
- package/templates/snow/playtests/performance.playtest.json +1 -1
- package/templates/snow/src/render/backlightMaterial.ts +49 -18
- package/templates/snow/src/render/exposure.ts +17 -106
- package/templates/snow/src/render/materialLighting.ts +2 -11
- package/templates/snow/src/render/postprocessing.ts +11 -5
- package/templates/snow/src/render/quality.ts +46 -126
- package/templates/snow/src/render/snowSurface.ts +32 -15
- package/templates/snow/src/scenes/Snow.ts +2 -1
- package/templates/starter/.codex/config.toml +6 -2
- package/templates/starter/.cursor/mcp.json +8 -2
- package/templates/starter/.gemini/settings.json +8 -2
- package/templates/starter/.mcp.json +8 -2
- package/templates/starter/.vscode/mcp.json +9 -2
- package/templates/starter/.zed/settings.json +9 -2
- package/templates/starter/AGENTS.md +18 -14
- package/templates/starter/CLAUDE.md +18 -14
- package/templates/starter/index.html +1 -1
- package/templates/starter/main.html +12 -0
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
- package/templates/starter/opencode.json +10 -2
- package/templates/starter/package.json +15 -10
- package/templates/starter/playtests/play.playtest.json +22 -2
- package/templates/starter/playtests/production-readiness.playtest.json +14 -0
- package/templates/starter/src/entities/Crate.ts +19 -1
- package/templates/starter/src/render/arena.ts +2 -2
- package/templates/starter/src/render/atmosphere.ts +444 -0
- package/templates/starter/src/render/backlightMaterial.ts +49 -18
- package/templates/starter/src/render/camera.ts +28 -0
- package/templates/starter/src/render/clouds.ts +605 -0
- package/templates/starter/src/render/contactShadow.ts +50 -0
- package/templates/starter/src/render/exposure.ts +9 -111
- package/templates/starter/src/render/gpuSky.ts +752 -0
- package/templates/starter/src/render/grade.ts +1 -1
- package/templates/starter/src/render/lighting.ts +34 -6
- package/templates/starter/src/render/materialLighting.ts +2 -11
- package/templates/starter/src/render/postprocessing.ts +27 -14
- package/templates/starter/src/render/quality.ts +18 -147
- package/templates/starter/src/render/sky.ts +90 -40
- package/templates/starter/src/render/temporalAA.ts +1 -1
- package/templates/starter/src/render/temporalAAStage.ts +1 -1
- package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
- package/templates/starter/src/render/temporalDetailStage.ts +106 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
- package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
- package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
- package/templates/starter/src/scenes/Play.ts +11 -8
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/worker-page.ts +29 -0
- package/templates/starter/src/worker.ts +5 -0
- package/templates/starter/vite.config.ts +2 -0
- package/templates/tower-defense/.codex/config.toml +6 -2
- package/templates/tower-defense/.cursor/mcp.json +8 -2
- package/templates/tower-defense/.gemini/settings.json +8 -2
- package/templates/tower-defense/.mcp.json +8 -2
- package/templates/tower-defense/.vscode/mcp.json +9 -2
- package/templates/tower-defense/.zed/settings.json +9 -2
- package/templates/tower-defense/AGENTS.md +10 -12
- package/templates/tower-defense/CLAUDE.md +10 -12
- package/templates/tower-defense/opencode.json +10 -2
- package/templates/tower-defense/package.json +15 -10
- package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
- package/templates/tower-defense/playtests/performance.playtest.json +1 -1
- package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
- package/templates/tower-defense/src/render/exposure.ts +11 -109
- package/templates/tower-defense/src/render/lighting.ts +4 -2
- package/templates/tower-defense/src/render/materialLighting.ts +2 -11
- package/templates/tower-defense/src/render/postprocessing.ts +4 -4
- package/templates/tower-defense/src/render/quality.ts +10 -116
- package/templates/tower-defense/src/render/sky.ts +2 -2
- package/templates/tower-defense/src/scenes/Battle.ts +4 -0
- package/template-assets/autoExposure.ts +0 -225
- package/template-assets/exposureGraph.ts +0 -178
- package/template-assets/exposureReadback.ts +0 -79
- package/template-assets/worldEnvironment.ts +0 -1212
- package/templates/action-rpg/src/render/autoExposure.ts +0 -225
- package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
- package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
- package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
- package/templates/minimal/src/render/autoExposure.ts +0 -225
- package/templates/minimal/src/render/exposureGraph.ts +0 -178
- package/templates/minimal/src/render/exposureReadback.ts +0 -79
- package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
- package/templates/platformer/src/render/autoExposure.ts +0 -225
- package/templates/platformer/src/render/exposureGraph.ts +0 -178
- package/templates/platformer/src/render/exposureReadback.ts +0 -79
- package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
- package/templates/puzzle/src/render/autoExposure.ts +0 -225
- package/templates/puzzle/src/render/exposureGraph.ts +0 -178
- package/templates/puzzle/src/render/exposureReadback.ts +0 -79
- package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
- package/templates/racing/src/render/autoExposure.ts +0 -225
- package/templates/racing/src/render/exposureGraph.ts +0 -178
- package/templates/racing/src/render/exposureReadback.ts +0 -79
- package/templates/racing/src/render/worldEnvironment.ts +0 -1212
- package/templates/rain/src/render/autoExposure.ts +0 -225
- package/templates/rain/src/render/exposureGraph.ts +0 -178
- package/templates/rain/src/render/exposureReadback.ts +0 -79
- package/templates/rain/src/render/worldEnvironment.ts +0 -1212
- package/templates/rts/src/render/autoExposure.ts +0 -225
- package/templates/rts/src/render/exposureGraph.ts +0 -178
- package/templates/rts/src/render/exposureReadback.ts +0 -79
- package/templates/rts/src/render/worldEnvironment.ts +0 -1212
- package/templates/runner/src/render/autoExposure.ts +0 -225
- package/templates/runner/src/render/exposureGraph.ts +0 -178
- package/templates/runner/src/render/exposureReadback.ts +0 -79
- package/templates/runner/src/render/worldEnvironment.ts +0 -1212
- package/templates/sailing/src/render/autoExposure.ts +0 -225
- package/templates/sailing/src/render/exposureGraph.ts +0 -178
- package/templates/sailing/src/render/exposureReadback.ts +0 -79
- package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
- package/templates/shooter/src/render/autoExposure.ts +0 -225
- package/templates/shooter/src/render/exposureGraph.ts +0 -178
- package/templates/shooter/src/render/exposureReadback.ts +0 -79
- package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
- package/templates/snow/src/render/autoExposure.ts +0 -225
- package/templates/snow/src/render/exposureGraph.ts +0 -178
- package/templates/snow/src/render/exposureReadback.ts +0 -79
- package/templates/snow/src/render/worldEnvironment.ts +0 -1212
- package/templates/starter/src/render/autoExposure.ts +0 -225
- package/templates/starter/src/render/exposureGraph.ts +0 -178
- package/templates/starter/src/render/exposureReadback.ts +0 -79
- package/templates/starter/src/render/worldEnvironment.ts +0 -1212
- package/templates/tower-defense/src/render/autoExposure.ts +0 -225
- package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
- package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
- package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
{
|
|
2
|
+
"context_servers": {
|
|
3
|
+
"threenative-assets": {
|
|
4
|
+
"source": "custom",
|
|
5
|
+
"command": "node",
|
|
6
|
+
"args": [
|
|
7
|
+
"./node_modules/@threenative/core/mcp/assets.mjs"
|
|
8
|
+
],
|
|
9
|
+
"env": {
|
|
10
|
+
"ASSET_DOWNLOAD_DIR": "./public/assets",
|
|
11
|
+
"AUDIO_DOWNLOAD_DIR": "./public/audio"
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
"threenative-sculpt": {
|
|
15
|
+
"source": "custom",
|
|
16
|
+
"command": "node",
|
|
17
|
+
"args": [
|
|
18
|
+
"./node_modules/@threenative/core/mcp/sculpt.mjs"
|
|
19
|
+
]
|
|
20
|
+
},
|
|
21
|
+
"threenative-engine": {
|
|
22
|
+
"source": "custom",
|
|
23
|
+
"command": "node",
|
|
24
|
+
"args": [
|
|
25
|
+
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
26
|
+
]
|
|
27
|
+
},
|
|
28
|
+
"threenative-animation": {
|
|
29
|
+
"source": "custom",
|
|
30
|
+
"command": "node",
|
|
31
|
+
"args": [
|
|
32
|
+
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
33
|
+
]
|
|
34
|
+
},
|
|
35
|
+
"threenative-devtools": {
|
|
36
|
+
"source": "custom",
|
|
37
|
+
"command": "node",
|
|
38
|
+
"args": [
|
|
39
|
+
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
40
|
+
]
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# AGENTS.md — __PROJECT_NAME__ collectathon (Hop Garden)
|
|
2
|
+
|
|
3
|
+
Pip, a stout sprout-keeper in a teal knit beanie and a belted mustard tunic, roams one free island for three Sunseeds: reach the summit, collect the eight red gems, climb the wall-kick shaft. The moveset is a 3D platformer's: run, single, double and triple jump, crouch, back flip, side flip, long jump, wall kick, ledge grab, dive and ground pound, with an eight-wedge health meter, coins that heal, and three kinds of walker. Every model and animation is procedural — no mesh or clip file. The tiling surfaces (grass, sand, rock, stone, bark, planks) are generated WebP images in `assets/` (`tex-*.webp`, shared by the kits and copied when a source names the file), each traced in `tex-PROVENANCE.md`; keep `assets/` at most 1.5 MB (the scaffold spec checks both), load textures in `Scene.load()` through `loadSurfaces(ctx.assets)` in `src/render/surface.ts`, and never sample a tile plainly: `stochastic`, `macro` and `triplanar` there hide its repeat. Paint a one-off texture in code with `paintedTexture` in `src/render/materials.ts`. Instructions for the AI agent in this game; `CLAUDE.md` mirrors this file.
|
|
4
|
+
|
|
5
|
+
## Ownership
|
|
6
|
+
|
|
7
|
+
ThreeNative owns bootstrap, renderer, fixed-step loop, input, loading, physics bindings, the state bridge, and the look's render chain (`WorldEnvironment` from `@threenative/core`: the filmic tone curve and metered auto exposure). This repository owns the course, the hero's feel, the walkers, the pickups, the HUD, the camera, and the scene's own sky, sun and materials; `src/game.ts` is portable and React mounts from `src/main.ts`. The render camera also skips an object that projects under **0.5 px** in it; `renderer.minimumProjectedPixels` raises that threshold (`false` disables the cut, not the count) and `alwaysRender(object)` exempts an object, while camera-attached objects and shadow casters are kept. The engine also owns the per-frame world-matrix walk, and by default it does not descend into a hidden subtree — so a game that reads a hidden object's `matrixWorld` directly must use `getWorldPosition` (or call `object.updateWorldMatrix(true, false)`) first; `renderer.matrixWorld: "all"` restores three's every-node walk, and `TN_PROJECTION` reports the visited-node count either way. Physics bodies and `ctx.camera` interpolate between fixed ticks by default; `physicsInterpolation: false` disables it globally, `body.interpolate = false` disables one body, `ctx.interpolate(object)` opts in another transform, and `ctx.resetInterpolation(object)` resets game-driven teleports (`TN_PHYSICS_INTERPOLATION` reports the setting and tracked count).
|
|
8
|
+
|
|
9
|
+
## Start every change
|
|
10
|
+
|
|
11
|
+
1. **Critical authoring gate:** invoke `threenative-capabilities` to choose the route. New games: steps 1-8. Existing games: steps 5-7 only, using existing context. Follow the `ponytail` ladder. References borrow mechanics only: no code, level layouts, character names or art. A session started outside this folder has no `mcp__threenative-*` tools: call them with `node node_modules/@threenative/core/mcp/call.mjs <server> <tool> '<json>'`.
|
|
12
|
+
2. **New game only:** run discovery in `threenative-capabilities` before `prd-creator`. Draft the core-mechanics plan from the kit, both discovery passes and binding constraints, direct the user to review it, and wait for explicit approval plus an instruction to implement it.
|
|
13
|
+
3. Treat returned constraints as binding. `@threenative/physics/navigation` is browser-only WASM, and this course needs no navigation: walkers chase in a straight line inside a leash, and the course is authored geometry, so the hero collides with exactly the triangles it sees and desktop/native stays honest.
|
|
14
|
+
4. If a build, import, device, or blank frame fails, run `npx threenative doctor` and `npx @threenative/playtest doctor`; missing observations are not zero. For *"a bullet passes through a wall"*, `RigidBody3D` defaults to continuous collision; `continuousCollision` is the named per-body override, and `body.continuousCollision` reports the effective setting on web/native.
|
|
15
|
+
|
|
16
|
+
## When the framework blocks you, write plain Three.js
|
|
17
|
+
|
|
18
|
+
When an `@threenative/*` API is broken, missing, or does not do what you need, replace only that piece with portable Three.js/plain code. Keep the loop, scenes, input, registry, and playtest bridge; avoid DOM globals, dynamic `import()`, and raw physics handles. **Report what blocked you** (API, expectation, result, replacement); never stall the game.
|
|
19
|
+
|
|
20
|
+
## Workflow skills
|
|
21
|
+
- `.agents/skills/prd-creator/SKILL.md` / `.claude/skills/prd-creator/SKILL.md` — game plan and approval gate.
|
|
22
|
+
- `.agents/skills/threenative-capabilities/SKILL.md` / `.claude/skills/threenative-capabilities/SKILL.md` — capability search and classic-game mechanics references.
|
|
23
|
+
- `.agents/skills/threenative-playtest/SKILL.md` / `.claude/skills/threenative-playtest/SKILL.md` — diagnosis and proof.
|
|
24
|
+
- `.agents/skills/threenative-assets/SKILL.md` / `.claude/skills/threenative-assets/SKILL.md` — assets and sculpting.
|
|
25
|
+
- `.agents/skills/threenative-visuals/SKILL.md` / `.claude/skills/threenative-visuals/SKILL.md` — captures and look.
|
|
26
|
+
- `.agents/skills/threenative-performance/SKILL.md` / `.claude/skills/threenative-performance/SKILL.md` — measured budgets; read it first when the game is slow or stutters: `playtest trace`, then the `threenative-devtools` MCP server.
|
|
27
|
+
- `.agents/skills/threenative-ui/SKILL.md` / `.claude/skills/threenative-ui/SKILL.md` — native-safe UI. `.agents/skills/threenative-context/SKILL.md` / `.claude/skills/threenative-context/SKILL.md` — portable ctx APIs.
|
|
28
|
+
- Confirmed framework bugs: use `file-engine-bug` in `.agents/skills/` or `.claude/skills/` after a minimal repro. A game-side `patches/` fix is temporary: once it is settled, it moves into the engine in one PR. Lazy-first: `.agents/skills/ponytail/SKILL.md` / `.claude/skills/ponytail/SKILL.md` — smallest correct change, and its reuse rung is the capability search above. Engine: The owned C++ engine is the default for a new game: the Wasm engine on web and the engine player on desktop. This template runs on it: `threenative.config.ts` names no `engine`. `engine: "threejs"` switches to upstream Three.js only when the user asks for it; it is never a fix for a build error. Android and iOS use the legacy host.
|
|
29
|
+
## Commands and map
|
|
30
|
+
|
|
31
|
+
```sh
|
|
32
|
+
pnpm dev
|
|
33
|
+
pnpm build
|
|
34
|
+
pnpm build --target desktop
|
|
35
|
+
pnpm test # runs `pnpm check` first: typecheck, ESLint, Biome format
|
|
36
|
+
pnpm typecheck
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
`src/entities/Hero.ts` owns the moveset: one action state machine on a `CharacterBody3D` and `HERO_FEEL`, the one table of metres and seconds (run cap 9.6 m/s, jumps 12.6 / 15.6 / 20.7 m/s up, 0.3 s chain window with a 0.12 s press buffer, one air double jump per flight at 12.6 m/s from a second press 0.1 s after take-off, 0.167 s wall-kick window that a press up to 0.12 s before the bonk also reaches (a press at a wall is a kick, never the air double), long jump ×1.5 at half gravity, ledge band 1.0–1.6 m above the feet, found by wall rays 0.3 m and 1.5 m above them) the course is laid out from — change a number there and a gap in `src/level/Course.ts` changes its meaning. The stick is camera-relative. The wall and the ledge are found with `ctx.physics.directSpaceState.intersectRay` against the static world's layer (`WORLD_LAYER`), because `moveAndSlide` reports the floor and not the wall. `Walker.ts` is the three enemy kinds, each with a telegraph before it attacks: a bumblet chaser, a hopper that crouches then hops, and a thornback that rears then charges (a stomp, a dive or a ground pound defeats a bumblet or a hopper; a thornback's spikes hurt a stomp, so only a dive or a pound beats it; a touch costs a wedge), `Pickup.ts` a coin, red gem or Sunseed; `src/scenes/Play.ts` registers every placeable entity in `load()` so a scenario's `setup.place` reaches it, then owns wedges, Sunseeds, checkpoints and the kill plane; `src/render/` is ordinary Three.js and every model in the game, `src/level/terrain.ts` shapes the island (hills, cliffs, the castle plateau) on core's `Heightfield` and keeps every route and level zone at y = 0, so place things with `course.ground(x, z)`, never a fixed height; `src/render/ground.ts` writes the blend weights `surface.ts` paints it with (grass, path sand, rock by slope), `src/render/castle.ts` is the castle and the signpost, `src/render/water.ts` the sea (tinted by a baked depth map of the island, its swell core's `WaveField` from `Course.ts`), `src/render/foliage.ts` the instanced planting, meadow and pebbles (never solid; `course.meadow.update(camera.position)` thins far grass each frame, `GRASS_SHARE` in `quality.ts` sets the share per tier), and `playtests/survives.playtest.json` asserts the relief, slope shares, castle, grass, pebbles and signpost; `src/render/effects.ts` is every particle look (the dust, flash, pollen and sparkle emitters and the `BURSTS` table), and `Play.ts` fires them through four pooled `GPUParticles3D` spawn emitters, proven by `playtests/effects.playtest.json`; `src/ui/Hud.tsx` is the one HUD. The orbit camera (`src/render/camera.ts`, turned by the mouse once a click takes the pointer lock, proven by `playtests/look.playtest.json`) and the sun are written in `afterPhysics`, never in the scene's frame function, because `moveAndSlide` only queues motion; the camera pulls in front of any wall on a ray the scene passes it, and when a wall boxes it in it cuts to the clearest side, never steeper than 35°. The orbiting platform is a kinematic `RigidBody3D` the scene moves by its mesh: the engine carries a character standing on it, so there is no carry code here. Keep `playtests/survives.playtest.json` as smoke proof and `touch-controls.ts`/`touch-layout.ts` aligned with the native playtest; `playtests/` holds one scenario per move (`jump-chain`, `double-tap`, `double-tap-air`, `acrobatics`, `wall-kick`, `ledge`, `ledge-angle`, `ledge-too-high`) and per rule (`collect`, `combat`, `enemies`, `thornback`, `telegraphs`, `camera`). Collision is the engine's, from your geometry: `buildStaticColliders(ctx, course.group, { predicate: (object) => object.userData.solid === true, reachableCeiling: 40 })` turns the tagged walkable meshes into fixed trimesh bodies; the raised ceiling keeps the 16 m shaft walls solid. A `CollisionShape3D` capsule is centred on the body's origin, so the origin is the hero's waist and its rig is pushed down by `halfHeight + radius`; forget that and the hero floats a body-length above every surface.
|
|
40
|
+
|
|
41
|
+
Play gates: `playtests/explore.playtest.json` drives 7200 ticks of seeded random input and fails on any page error; `look.playtest.json` fails when mouse motion does not turn `camera.main`. `performance.playtest.json` pins no frame time: the harness holds every tier to 16.7 ms p95 (60 fps) of the engine's own CPU and GPU cost (plus the frame interval on a real display), and a `TN_SCENE_WARNING` or a `TN_RENDER_PROJECTION` decline fails the run, so answer it by cutting unique geometry or materials. A procedural rig bounds its feet with `footSlip` on sole nodes named `footL`/`footR`: `maxSlideSpeed: 1` fails a planted sole that slides faster than 1 m/s, and unnamed soles fail closed. A new key binding joins `explore`'s `move` or `actions` in the same change.
|
|
42
|
+
|
|
43
|
+
## Portable authoring contracts
|
|
44
|
+
Leave `assets` absent: this kit ships no authored model, texture or sound, so the cook has nothing to do. Before adding one, read `node_modules/create-threenative/agent-docs/references/finding-assets.md`; the cook's passes, `assets.exclude` globs and `assets.budget` ceilings count bytes left uncooked and are reported either way.
|
|
45
|
+
|
|
46
|
+
Relative look capture: a binding with `pointerRelative: true` captures the canvas on click by default; set `captureOnClick: false` and call `ctx.input.captureMouse()` from your own gesture to opt out. Desktop mode precedence is CLI (`--windowed`, `--maximized`, `--fullscreen`) over `display.fullscreen` over `window.maximized`; with both false, `window.width`/`height` size the normal window. Scenes use `load`, `enter`, `update`, `exit`, `render`; physics nodes are Godot-named and disposable. No model here is imported, so there is no authored scale to normalise and the collider is the body: the generated scale-and-snap conventions do not apply to this template. `input.vector("move").y` is +up, so forward uses one explicit `-move.y` conversion. Rigged assets: put a `.glb` in `assets/`, await `ctx.assets.model("hero.glb")` in `Scene.load()`, then drive `AnimationPlayer` beside its entity. `ctx.goto(name)` rebuilds without resetting game state; from a frame function `goto` and then `return`; `ctx.state.set({ /* copy this game's initial-state shape */ })` is a partial patch. `game.goto("<scene-name>")` also rebuilds the scene, but it resets the game's state. Seeded randomness is deterministic only when `defineGame({ seed })` is configured.
|
|
47
|
+
|
|
48
|
+
WebGPU reports `TN_GPU_CLASS` once per launch. Automatic `render.resolutionScale` starts at 0.85 for `mobile-low`, otherwise 1; a numeric value pins it. `TN_FRAME_BUDGET` reports the actual scale under both policies. `src/render/sky.ts` builds the sky (gradient, sun halo, seeded cumulus) from `palette.ts` and uses it as both background and environment light, and `SUN_DIRECTION` aims `lighting.ts`'s one authored sun. Imported foliage (Fab/Megascans cutouts) draws with its own albedo, normal map and alpha cutoff under the environment light `sky.ts` makes — never tint it, fake its emission or flatten its normals to make up for missing light; `TN_UNLIT_FOLIAGE` names cutout materials drawn with no environment. No material backlighting ships: as in a stock Unreal scene, the sun, the sky light and each material's own colour are the whole light. The look's chain is core's, not vendored: `src/render/postprocessing.ts` calls `new WorldEnvironment(qualityPreset(tier))`, and `qualityPreset` in `src/render/quality.ts` is the `@threenative/core` preset plus this game's overrides, each with its reason — it starts empty, so the game gets the stock Unreal 5.8.3 look (`TN_WORLD_ENVIRONMENT` reports the filmic curve and `TN_AUTO_EXPOSURE` the meter), metered at 0 EV by the starter kits' shared `src/render/kitExposure.ts`. Pin `tonemapMode: "aces"`, or `autoExposureEnabled: false` with a fixed `exposure`, there and only there, and say why. `src/render/quality.ts` owns `low`, `medium`, `high`; the GPU family from `ctx.renderer.gpuClass` sets the start (`discrete` `high`, `integrated` and `mobile-high` `medium`, other phones `low`); `isMobile()` chooses `low`, otherwise `high` when the family is `unknown`; override with `setupPost(..., { tier: "low" })`. Unknown tiers throw. `high` draws 4x MSAA and `medium` and `low` SMAA; `temporalAA: true` is the named opt-in. Keep state values human-readable; the bridge flushes about 100 ms and per-frame feel stays in scene-owned Three.js.
|
|
49
|
+
|
|
50
|
+
When an animation looks wrong, measure it before rewriting it. `clipPoseError` scores a retargeted clip against its source per bone in degrees — whole quaternions relative to each rig's own bind pose, so the two rigs' bind conventions cancel and a limb rolled about its own axis is caught where a bone-direction check reads zero. `clipTrackBindings` names tracks that bind nothing (the `<bone>.undefined` failure that plays the bind pose instead of the animation), `clipBoneCoverage` names bones the clip does not drive and which therefore keep the previous clip's pose, and `boneContact` reports in metres whether a named bone reaches the prop it is supposed to be touching. Two loading conventions come from `@threenative/core`, not from your own loops: `loadAll(items, load)` fetches six at a time and returns results **in the input's order** (a pool that pushes returns completion order, so a positional pick lands a different asset every load), and `addInSlices(objects, (object) => ctx.add(object))` attaches in 8 ms slices so hundreds of objects never land in one long frame; override `concurrency`/`sliceSize`, pass `while: () => alive` to stop a torn-down scene without throwing, and `marker: false` silences `TN_LOAD_ALL`/`TN_ADD_SLICES` but never the measurement. Gate the loading curtain on a measured readiness with `ctx.startup.hold(label, () => ready)`: core polls it every rendered frame, so it settles without a physics step. Assets download on demand and stay on disk between web visits: await everything the spawn camera sees before the reveal, and `await ctx.assets.prefetch(["next-level.glb"])` before `ctx.goto` only for what is out of view (a reveal before the visible content loads shows a half-built world); the idle fill downloads the rest after the reveal. Overrides on `defineGame`'s `assets`: `cache: false`, `backgroundFill: false`, both reported on `ctx.assets.cache`; native hosts read installed files.
|
|
51
|
+
|
|
52
|
+
## Budget real time for the look
|
|
53
|
+
Reference-driven authoring starts at `node_modules/create-threenative/agent-docs/references/dream-loop.md`. Open a capture after visual changes. A scenario with no assertions or missing observations fails. The engine warns you before a human does: `TN_SCENE_WARNING` fires when the GPU used under a third of the frame while the JS render phase ran longer than the display's own period, and names the census behind it — objects considered, draws per pass, triangles per draw, shadow-exempt casters. It is a scene-shape verdict, so answer it by moving the draw and object counts, not the engine: read the bucket census before promising a merge. `npx threenative doctor` repeats the last verdict and the `DEV_MODE=true` chip shows it on screen (it draws the verdict alone — no frame rate, which reads throttled under a compositor or a virtual display; see `agent-docs/references/performance-basics.md`); `TN_FRAME_SPANS=1` adds the render phase's own span tree when you need to know which part costs the milliseconds. The cheapest static object is one whose transform you never write: measured on 1,561 objects, leaving them alone costs 10.10 ms of render phase against 17.45 ms when the game rewrites every transform each frame, because three skips the per-object binding update when nothing changed. So do not touch a transform you do not need to — that is worth ~7 ms where `markStatic(root)`, which additionally composes a never-moving subtree once, measured 0.009 ms. Use it for scenery you are sure of, and `invalidateStatic(object)` to announce a write inside one; it deletes matrix arithmetic, not the walk. `TN_RENDERLIST_VALIDATE=1` recomputes every world matrix the long way each frame and throws on the first that disagrees, which is how you prove a freeze did not leave something stale on screen.
|
|
54
|
+
|
|
55
|
+
For terrain generation or editing, read `node_modules/create-threenative/agent-docs/references/terrain-authoring.md`; install optional `@threenative/terrain`, bake before play, and own its appearance in `src/render/`; test water proximity with its `createSegmentIndex` and steep ground with `slopeQuantile`, never a per-point scan or fixed degrees. Recipes are installed with the scaffold, under `node_modules/create-threenative/agent-docs/references/`: `assertion-reference`, `build-profiles`, `capability-reference`, `capture-the-frame`, `creating-creatures`, `ctx-cookbook`, `debug-surface`, `finding-assets`, `gameplay-recipes`, `menu-screens`, `mobile-memory-budget`, `performance-basics`, `rigging-characters`, `sculpt-from-a-reference`, `trace-a-slow-frame`, `visual-baseline` and `webview-ui` (`.md`).
|
|
56
|
+
|
|
57
|
+
## Optional multiplayer transport
|
|
58
|
+
For online play only, import `connect` from `@threenative/core/net` with an HTTPS URL and nonempty identity credential; configure `connectTimeoutMs`, `maxReliableMessageBytes`, `maxQueuedReliableBytes`, and `maxQueuedDatagrams` (10s/65,536/1 MiB/256), use `reliable-ordered` for ordered reliable messages and bounded `unreliable` datagrams that may drop, and keep serialization, replication, prediction, interpolation, snapshots and rejoin in this game's `src/` and server. There is no fallback: unsupported WebTransport/native rejects with `TN_NET_UNAVAILABLE`; reference Go server: `packages/runtime-native/examples/webtransport/server`.
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
<!-- Generated mirror of AGENTS.md. Do not edit; edit AGENTS.md. -->
|
|
2
|
+
|
|
3
|
+
# AGENTS.md — __PROJECT_NAME__ collectathon (Hop Garden)
|
|
4
|
+
|
|
5
|
+
Pip, a stout sprout-keeper in a teal knit beanie and a belted mustard tunic, roams one free island for three Sunseeds: reach the summit, collect the eight red gems, climb the wall-kick shaft. The moveset is a 3D platformer's: run, single, double and triple jump, crouch, back flip, side flip, long jump, wall kick, ledge grab, dive and ground pound, with an eight-wedge health meter, coins that heal, and three kinds of walker. Every model and animation is procedural — no mesh or clip file. The tiling surfaces (grass, sand, rock, stone, bark, planks) are generated WebP images in `assets/` (`tex-*.webp`, shared by the kits and copied when a source names the file), each traced in `tex-PROVENANCE.md`; keep `assets/` at most 1.5 MB (the scaffold spec checks both), load textures in `Scene.load()` through `loadSurfaces(ctx.assets)` in `src/render/surface.ts`, and never sample a tile plainly: `stochastic`, `macro` and `triplanar` there hide its repeat. Paint a one-off texture in code with `paintedTexture` in `src/render/materials.ts`. Instructions for the AI agent in this game; `CLAUDE.md` mirrors this file.
|
|
6
|
+
|
|
7
|
+
## Ownership
|
|
8
|
+
|
|
9
|
+
ThreeNative owns bootstrap, renderer, fixed-step loop, input, loading, physics bindings, the state bridge, and the look's render chain (`WorldEnvironment` from `@threenative/core`: the filmic tone curve and metered auto exposure). This repository owns the course, the hero's feel, the walkers, the pickups, the HUD, the camera, and the scene's own sky, sun and materials; `src/game.ts` is portable and React mounts from `src/main.ts`. The render camera also skips an object that projects under **0.5 px** in it; `renderer.minimumProjectedPixels` raises that threshold (`false` disables the cut, not the count) and `alwaysRender(object)` exempts an object, while camera-attached objects and shadow casters are kept. The engine also owns the per-frame world-matrix walk, and by default it does not descend into a hidden subtree — so a game that reads a hidden object's `matrixWorld` directly must use `getWorldPosition` (or call `object.updateWorldMatrix(true, false)`) first; `renderer.matrixWorld: "all"` restores three's every-node walk, and `TN_PROJECTION` reports the visited-node count either way. Physics bodies and `ctx.camera` interpolate between fixed ticks by default; `physicsInterpolation: false` disables it globally, `body.interpolate = false` disables one body, `ctx.interpolate(object)` opts in another transform, and `ctx.resetInterpolation(object)` resets game-driven teleports (`TN_PHYSICS_INTERPOLATION` reports the setting and tracked count).
|
|
10
|
+
|
|
11
|
+
## Start every change
|
|
12
|
+
|
|
13
|
+
1. **Critical authoring gate:** invoke `threenative-capabilities` to choose the route. New games: steps 1-8. Existing games: steps 5-7 only, using existing context. Follow the `ponytail` ladder. References borrow mechanics only: no code, level layouts, character names or art. A session started outside this folder has no `mcp__threenative-*` tools: call them with `node node_modules/@threenative/core/mcp/call.mjs <server> <tool> '<json>'`.
|
|
14
|
+
2. **New game only:** run discovery in `threenative-capabilities` before `prd-creator`. Draft the core-mechanics plan from the kit, both discovery passes and binding constraints, direct the user to review it, and wait for explicit approval plus an instruction to implement it.
|
|
15
|
+
3. Treat returned constraints as binding. `@threenative/physics/navigation` is browser-only WASM, and this course needs no navigation: walkers chase in a straight line inside a leash, and the course is authored geometry, so the hero collides with exactly the triangles it sees and desktop/native stays honest.
|
|
16
|
+
4. If a build, import, device, or blank frame fails, run `npx threenative doctor` and `npx @threenative/playtest doctor`; missing observations are not zero. For *"a bullet passes through a wall"*, `RigidBody3D` defaults to continuous collision; `continuousCollision` is the named per-body override, and `body.continuousCollision` reports the effective setting on web/native.
|
|
17
|
+
|
|
18
|
+
## When the framework blocks you, write plain Three.js
|
|
19
|
+
|
|
20
|
+
When an `@threenative/*` API is broken, missing, or does not do what you need, replace only that piece with portable Three.js/plain code. Keep the loop, scenes, input, registry, and playtest bridge; avoid DOM globals, dynamic `import()`, and raw physics handles. **Report what blocked you** (API, expectation, result, replacement); never stall the game.
|
|
21
|
+
|
|
22
|
+
## Workflow skills
|
|
23
|
+
- `.agents/skills/prd-creator/SKILL.md` / `.claude/skills/prd-creator/SKILL.md` — game plan and approval gate.
|
|
24
|
+
- `.agents/skills/threenative-capabilities/SKILL.md` / `.claude/skills/threenative-capabilities/SKILL.md` — capability search and classic-game mechanics references.
|
|
25
|
+
- `.agents/skills/threenative-playtest/SKILL.md` / `.claude/skills/threenative-playtest/SKILL.md` — diagnosis and proof.
|
|
26
|
+
- `.agents/skills/threenative-assets/SKILL.md` / `.claude/skills/threenative-assets/SKILL.md` — assets and sculpting.
|
|
27
|
+
- `.agents/skills/threenative-visuals/SKILL.md` / `.claude/skills/threenative-visuals/SKILL.md` — captures and look.
|
|
28
|
+
- `.agents/skills/threenative-performance/SKILL.md` / `.claude/skills/threenative-performance/SKILL.md` — measured budgets; read it first when the game is slow or stutters: `playtest trace`, then the `threenative-devtools` MCP server.
|
|
29
|
+
- `.agents/skills/threenative-ui/SKILL.md` / `.claude/skills/threenative-ui/SKILL.md` — native-safe UI. `.agents/skills/threenative-context/SKILL.md` / `.claude/skills/threenative-context/SKILL.md` — portable ctx APIs.
|
|
30
|
+
- Confirmed framework bugs: use `file-engine-bug` in `.agents/skills/` or `.claude/skills/` after a minimal repro. A game-side `patches/` fix is temporary: once it is settled, it moves into the engine in one PR. Lazy-first: `.agents/skills/ponytail/SKILL.md` / `.claude/skills/ponytail/SKILL.md` — smallest correct change, and its reuse rung is the capability search above. Engine: The owned C++ engine is the default for a new game: the Wasm engine on web and the engine player on desktop. This template runs on it: `threenative.config.ts` names no `engine`. `engine: "threejs"` switches to upstream Three.js only when the user asks for it; it is never a fix for a build error. Android and iOS use the legacy host.
|
|
31
|
+
## Commands and map
|
|
32
|
+
|
|
33
|
+
```sh
|
|
34
|
+
pnpm dev
|
|
35
|
+
pnpm build
|
|
36
|
+
pnpm build --target desktop
|
|
37
|
+
pnpm test # runs `pnpm check` first: typecheck, ESLint, Biome format
|
|
38
|
+
pnpm typecheck
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
`src/entities/Hero.ts` owns the moveset: one action state machine on a `CharacterBody3D` and `HERO_FEEL`, the one table of metres and seconds (run cap 9.6 m/s, jumps 12.6 / 15.6 / 20.7 m/s up, 0.3 s chain window with a 0.12 s press buffer, one air double jump per flight at 12.6 m/s from a second press 0.1 s after take-off, 0.167 s wall-kick window that a press up to 0.12 s before the bonk also reaches (a press at a wall is a kick, never the air double), long jump ×1.5 at half gravity, ledge band 1.0–1.6 m above the feet, found by wall rays 0.3 m and 1.5 m above them) the course is laid out from — change a number there and a gap in `src/level/Course.ts` changes its meaning. The stick is camera-relative. The wall and the ledge are found with `ctx.physics.directSpaceState.intersectRay` against the static world's layer (`WORLD_LAYER`), because `moveAndSlide` reports the floor and not the wall. `Walker.ts` is the three enemy kinds, each with a telegraph before it attacks: a bumblet chaser, a hopper that crouches then hops, and a thornback that rears then charges (a stomp, a dive or a ground pound defeats a bumblet or a hopper; a thornback's spikes hurt a stomp, so only a dive or a pound beats it; a touch costs a wedge), `Pickup.ts` a coin, red gem or Sunseed; `src/scenes/Play.ts` registers every placeable entity in `load()` so a scenario's `setup.place` reaches it, then owns wedges, Sunseeds, checkpoints and the kill plane; `src/render/` is ordinary Three.js and every model in the game, `src/level/terrain.ts` shapes the island (hills, cliffs, the castle plateau) on core's `Heightfield` and keeps every route and level zone at y = 0, so place things with `course.ground(x, z)`, never a fixed height; `src/render/ground.ts` writes the blend weights `surface.ts` paints it with (grass, path sand, rock by slope), `src/render/castle.ts` is the castle and the signpost, `src/render/water.ts` the sea (tinted by a baked depth map of the island, its swell core's `WaveField` from `Course.ts`), `src/render/foliage.ts` the instanced planting, meadow and pebbles (never solid; `course.meadow.update(camera.position)` thins far grass each frame, `GRASS_SHARE` in `quality.ts` sets the share per tier), and `playtests/survives.playtest.json` asserts the relief, slope shares, castle, grass, pebbles and signpost; `src/render/effects.ts` is every particle look (the dust, flash, pollen and sparkle emitters and the `BURSTS` table), and `Play.ts` fires them through four pooled `GPUParticles3D` spawn emitters, proven by `playtests/effects.playtest.json`; `src/ui/Hud.tsx` is the one HUD. The orbit camera (`src/render/camera.ts`, turned by the mouse once a click takes the pointer lock, proven by `playtests/look.playtest.json`) and the sun are written in `afterPhysics`, never in the scene's frame function, because `moveAndSlide` only queues motion; the camera pulls in front of any wall on a ray the scene passes it, and when a wall boxes it in it cuts to the clearest side, never steeper than 35°. The orbiting platform is a kinematic `RigidBody3D` the scene moves by its mesh: the engine carries a character standing on it, so there is no carry code here. Keep `playtests/survives.playtest.json` as smoke proof and `touch-controls.ts`/`touch-layout.ts` aligned with the native playtest; `playtests/` holds one scenario per move (`jump-chain`, `double-tap`, `double-tap-air`, `acrobatics`, `wall-kick`, `ledge`, `ledge-angle`, `ledge-too-high`) and per rule (`collect`, `combat`, `enemies`, `thornback`, `telegraphs`, `camera`). Collision is the engine's, from your geometry: `buildStaticColliders(ctx, course.group, { predicate: (object) => object.userData.solid === true, reachableCeiling: 40 })` turns the tagged walkable meshes into fixed trimesh bodies; the raised ceiling keeps the 16 m shaft walls solid. A `CollisionShape3D` capsule is centred on the body's origin, so the origin is the hero's waist and its rig is pushed down by `halfHeight + radius`; forget that and the hero floats a body-length above every surface.
|
|
42
|
+
|
|
43
|
+
Play gates: `playtests/explore.playtest.json` drives 7200 ticks of seeded random input and fails on any page error; `look.playtest.json` fails when mouse motion does not turn `camera.main`. `performance.playtest.json` pins no frame time: the harness holds every tier to 16.7 ms p95 (60 fps) of the engine's own CPU and GPU cost (plus the frame interval on a real display), and a `TN_SCENE_WARNING` or a `TN_RENDER_PROJECTION` decline fails the run, so answer it by cutting unique geometry or materials. A procedural rig bounds its feet with `footSlip` on sole nodes named `footL`/`footR`: `maxSlideSpeed: 1` fails a planted sole that slides faster than 1 m/s, and unnamed soles fail closed. A new key binding joins `explore`'s `move` or `actions` in the same change.
|
|
44
|
+
|
|
45
|
+
## Portable authoring contracts
|
|
46
|
+
Leave `assets` absent: this kit ships no authored model, texture or sound, so the cook has nothing to do. Before adding one, read `node_modules/create-threenative/agent-docs/references/finding-assets.md`; the cook's passes, `assets.exclude` globs and `assets.budget` ceilings count bytes left uncooked and are reported either way.
|
|
47
|
+
|
|
48
|
+
Relative look capture: a binding with `pointerRelative: true` captures the canvas on click by default; set `captureOnClick: false` and call `ctx.input.captureMouse()` from your own gesture to opt out. Desktop mode precedence is CLI (`--windowed`, `--maximized`, `--fullscreen`) over `display.fullscreen` over `window.maximized`; with both false, `window.width`/`height` size the normal window. Scenes use `load`, `enter`, `update`, `exit`, `render`; physics nodes are Godot-named and disposable. No model here is imported, so there is no authored scale to normalise and the collider is the body: the generated scale-and-snap conventions do not apply to this template. `input.vector("move").y` is +up, so forward uses one explicit `-move.y` conversion. Rigged assets: put a `.glb` in `assets/`, await `ctx.assets.model("hero.glb")` in `Scene.load()`, then drive `AnimationPlayer` beside its entity. `ctx.goto(name)` rebuilds without resetting game state; from a frame function `goto` and then `return`; `ctx.state.set({ /* copy this game's initial-state shape */ })` is a partial patch. `game.goto("<scene-name>")` also rebuilds the scene, but it resets the game's state. Seeded randomness is deterministic only when `defineGame({ seed })` is configured.
|
|
49
|
+
|
|
50
|
+
WebGPU reports `TN_GPU_CLASS` once per launch. Automatic `render.resolutionScale` starts at 0.85 for `mobile-low`, otherwise 1; a numeric value pins it. `TN_FRAME_BUDGET` reports the actual scale under both policies. `src/render/sky.ts` builds the sky (gradient, sun halo, seeded cumulus) from `palette.ts` and uses it as both background and environment light, and `SUN_DIRECTION` aims `lighting.ts`'s one authored sun. Imported foliage (Fab/Megascans cutouts) draws with its own albedo, normal map and alpha cutoff under the environment light `sky.ts` makes — never tint it, fake its emission or flatten its normals to make up for missing light; `TN_UNLIT_FOLIAGE` names cutout materials drawn with no environment. No material backlighting ships: as in a stock Unreal scene, the sun, the sky light and each material's own colour are the whole light. The look's chain is core's, not vendored: `src/render/postprocessing.ts` calls `new WorldEnvironment(qualityPreset(tier))`, and `qualityPreset` in `src/render/quality.ts` is the `@threenative/core` preset plus this game's overrides, each with its reason — it starts empty, so the game gets the stock Unreal 5.8.3 look (`TN_WORLD_ENVIRONMENT` reports the filmic curve and `TN_AUTO_EXPOSURE` the meter), metered at 0 EV by the starter kits' shared `src/render/kitExposure.ts`. Pin `tonemapMode: "aces"`, or `autoExposureEnabled: false` with a fixed `exposure`, there and only there, and say why. `src/render/quality.ts` owns `low`, `medium`, `high`; the GPU family from `ctx.renderer.gpuClass` sets the start (`discrete` `high`, `integrated` and `mobile-high` `medium`, other phones `low`); `isMobile()` chooses `low`, otherwise `high` when the family is `unknown`; override with `setupPost(..., { tier: "low" })`. Unknown tiers throw. `high` draws 4x MSAA and `medium` and `low` SMAA; `temporalAA: true` is the named opt-in. Keep state values human-readable; the bridge flushes about 100 ms and per-frame feel stays in scene-owned Three.js.
|
|
51
|
+
|
|
52
|
+
When an animation looks wrong, measure it before rewriting it. `clipPoseError` scores a retargeted clip against its source per bone in degrees — whole quaternions relative to each rig's own bind pose, so the two rigs' bind conventions cancel and a limb rolled about its own axis is caught where a bone-direction check reads zero. `clipTrackBindings` names tracks that bind nothing (the `<bone>.undefined` failure that plays the bind pose instead of the animation), `clipBoneCoverage` names bones the clip does not drive and which therefore keep the previous clip's pose, and `boneContact` reports in metres whether a named bone reaches the prop it is supposed to be touching. Two loading conventions come from `@threenative/core`, not from your own loops: `loadAll(items, load)` fetches six at a time and returns results **in the input's order** (a pool that pushes returns completion order, so a positional pick lands a different asset every load), and `addInSlices(objects, (object) => ctx.add(object))` attaches in 8 ms slices so hundreds of objects never land in one long frame; override `concurrency`/`sliceSize`, pass `while: () => alive` to stop a torn-down scene without throwing, and `marker: false` silences `TN_LOAD_ALL`/`TN_ADD_SLICES` but never the measurement. Gate the loading curtain on a measured readiness with `ctx.startup.hold(label, () => ready)`: core polls it every rendered frame, so it settles without a physics step. Assets download on demand and stay on disk between web visits: await everything the spawn camera sees before the reveal, and `await ctx.assets.prefetch(["next-level.glb"])` before `ctx.goto` only for what is out of view (a reveal before the visible content loads shows a half-built world); the idle fill downloads the rest after the reveal. Overrides on `defineGame`'s `assets`: `cache: false`, `backgroundFill: false`, both reported on `ctx.assets.cache`; native hosts read installed files.
|
|
53
|
+
|
|
54
|
+
## Budget real time for the look
|
|
55
|
+
Reference-driven authoring starts at `node_modules/create-threenative/agent-docs/references/dream-loop.md`. Open a capture after visual changes. A scenario with no assertions or missing observations fails. The engine warns you before a human does: `TN_SCENE_WARNING` fires when the GPU used under a third of the frame while the JS render phase ran longer than the display's own period, and names the census behind it — objects considered, draws per pass, triangles per draw, shadow-exempt casters. It is a scene-shape verdict, so answer it by moving the draw and object counts, not the engine: read the bucket census before promising a merge. `npx threenative doctor` repeats the last verdict and the `DEV_MODE=true` chip shows it on screen (it draws the verdict alone — no frame rate, which reads throttled under a compositor or a virtual display; see `agent-docs/references/performance-basics.md`); `TN_FRAME_SPANS=1` adds the render phase's own span tree when you need to know which part costs the milliseconds. The cheapest static object is one whose transform you never write: measured on 1,561 objects, leaving them alone costs 10.10 ms of render phase against 17.45 ms when the game rewrites every transform each frame, because three skips the per-object binding update when nothing changed. So do not touch a transform you do not need to — that is worth ~7 ms where `markStatic(root)`, which additionally composes a never-moving subtree once, measured 0.009 ms. Use it for scenery you are sure of, and `invalidateStatic(object)` to announce a write inside one; it deletes matrix arithmetic, not the walk. `TN_RENDERLIST_VALIDATE=1` recomputes every world matrix the long way each frame and throws on the first that disagrees, which is how you prove a freeze did not leave something stale on screen.
|
|
56
|
+
|
|
57
|
+
For terrain generation or editing, read `node_modules/create-threenative/agent-docs/references/terrain-authoring.md`; install optional `@threenative/terrain`, bake before play, and own its appearance in `src/render/`; test water proximity with its `createSegmentIndex` and steep ground with `slopeQuantile`, never a per-point scan or fixed degrees. Recipes are installed with the scaffold, under `node_modules/create-threenative/agent-docs/references/`: `assertion-reference`, `build-profiles`, `capability-reference`, `capture-the-frame`, `creating-creatures`, `ctx-cookbook`, `debug-surface`, `finding-assets`, `gameplay-recipes`, `menu-screens`, `mobile-memory-budget`, `performance-basics`, `rigging-characters`, `sculpt-from-a-reference`, `trace-a-slow-frame`, `visual-baseline` and `webview-ui` (`.md`).
|
|
58
|
+
|
|
59
|
+
## Optional multiplayer transport
|
|
60
|
+
For online play only, import `connect` from `@threenative/core/net` with an HTTPS URL and nonempty identity credential; configure `connectTimeoutMs`, `maxReliableMessageBytes`, `maxQueuedReliableBytes`, and `maxQueuedDatagrams` (10s/65,536/1 MiB/256), use `reliable-ordered` for ordered reliable messages and bounded `unreliable` datagrams that may drop, and keep serialization, replication, prediction, interpolation, snapshots and rejoin in this game's `src/` and server. There is no fallback: unsupported WebTransport/native rejects with `TN_NET_UNAVAILABLE`; reference Go server: `packages/runtime-native/examples/webtransport/server`.
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8" />
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
6
|
+
<title>__PROJECT_NAME__</title>
|
|
7
|
+
<!-- The loading cover's colour, painted before any script or stylesheet loads. -->
|
|
8
|
+
<style>html { background: #6aaaea; }</style>
|
|
9
|
+
</head>
|
|
10
|
+
<body>
|
|
11
|
+
<div id="root"></div>
|
|
12
|
+
<script type="module" src="/src/main.ts"></script>
|
|
13
|
+
</body>
|
|
14
|
+
</html>
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "collectathon",
|
|
3
|
+
"title": "Hop Garden",
|
|
4
|
+
"blurb": "A stout sprout-keeper in a knit beanie runs one free-roam island with a triple jump, long jump, backflip, side flip, wall kick, dive, ground pound and ledge grab, collecting three Sunseeds past bumblets, hoppers and spiked thornbacks.",
|
|
5
|
+
"genre": "collectathon",
|
|
6
|
+
"aliases": ["mario", "sm64", "super-mario", "3d-platformer", "collectathon"],
|
|
7
|
+
"kit": true
|
|
8
|
+
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "collectathon-native-survives",
|
|
3
|
+
"target": "desktop",
|
|
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": "run",
|
|
18
|
+
"press": "ArrowUp",
|
|
19
|
+
"holdTicks": 60,
|
|
20
|
+
"release": true
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
"kind": "wait",
|
|
24
|
+
"label": "stand",
|
|
25
|
+
"waitTicks": 240,
|
|
26
|
+
"release": true
|
|
27
|
+
}
|
|
28
|
+
],
|
|
29
|
+
"assert": {
|
|
30
|
+
"tone": [
|
|
31
|
+
{
|
|
32
|
+
"p50": {
|
|
33
|
+
"min": 60,
|
|
34
|
+
"max": 230
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
],
|
|
38
|
+
"components": [
|
|
39
|
+
{
|
|
40
|
+
"entity": "player",
|
|
41
|
+
"component": "groundY",
|
|
42
|
+
"gte": -0.3,
|
|
43
|
+
"lte": 0.3,
|
|
44
|
+
"allowTrivial": "The capsule's origin is the waist, so a ground line near zero after 300 ticks proves the hero stands on the island floor on the native host too."
|
|
45
|
+
}
|
|
46
|
+
],
|
|
47
|
+
"movement": {
|
|
48
|
+
"entity": "player",
|
|
49
|
+
"minDistance": 3
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://opencode.ai/config.json",
|
|
3
|
+
"mcp": {
|
|
4
|
+
"threenative-assets": {
|
|
5
|
+
"type": "local",
|
|
6
|
+
"command": [
|
|
7
|
+
"node",
|
|
8
|
+
"./node_modules/@threenative/core/mcp/assets.mjs"
|
|
9
|
+
],
|
|
10
|
+
"enabled": true,
|
|
11
|
+
"environment": {
|
|
12
|
+
"ASSET_DOWNLOAD_DIR": "./public/assets",
|
|
13
|
+
"AUDIO_DOWNLOAD_DIR": "./public/audio"
|
|
14
|
+
}
|
|
15
|
+
},
|
|
16
|
+
"threenative-sculpt": {
|
|
17
|
+
"type": "local",
|
|
18
|
+
"command": [
|
|
19
|
+
"node",
|
|
20
|
+
"./node_modules/@threenative/core/mcp/sculpt.mjs"
|
|
21
|
+
],
|
|
22
|
+
"enabled": true
|
|
23
|
+
},
|
|
24
|
+
"threenative-engine": {
|
|
25
|
+
"type": "local",
|
|
26
|
+
"command": [
|
|
27
|
+
"node",
|
|
28
|
+
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
29
|
+
],
|
|
30
|
+
"enabled": true
|
|
31
|
+
},
|
|
32
|
+
"threenative-animation": {
|
|
33
|
+
"type": "local",
|
|
34
|
+
"command": [
|
|
35
|
+
"node",
|
|
36
|
+
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
37
|
+
],
|
|
38
|
+
"enabled": true
|
|
39
|
+
},
|
|
40
|
+
"threenative-devtools": {
|
|
41
|
+
"type": "local",
|
|
42
|
+
"command": [
|
|
43
|
+
"node",
|
|
44
|
+
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
45
|
+
],
|
|
46
|
+
"enabled": true
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "__PROJECT_NAME__",
|
|
3
|
+
"private": true,
|
|
4
|
+
"license": "MIT",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"scripts": {
|
|
7
|
+
"dev": "vite",
|
|
8
|
+
"studio": "threenative-studio",
|
|
9
|
+
"build": "threenative build",
|
|
10
|
+
"build:web": "threenative build --target web",
|
|
11
|
+
"build:desktop": "threenative build --target desktop",
|
|
12
|
+
"build:android": "threenative build --target android",
|
|
13
|
+
"build:ios": "threenative build --target ios",
|
|
14
|
+
"pretest": "playwright install chromium",
|
|
15
|
+
"test": "pnpm check && pnpm build:web && threenative-playtest --scenario \"playtests/*.playtest.json\" --browser-recipe webgpu --headed --server-command \"pnpm exec vite preview --host 127.0.0.1 --port $PORT --strictPort\"",
|
|
16
|
+
"typecheck": "tsc --noEmit -p tsconfig.json",
|
|
17
|
+
"check": "pnpm typecheck && pnpm lint && pnpm format:check",
|
|
18
|
+
"lint": "eslint src",
|
|
19
|
+
"format:check": "biome format src"
|
|
20
|
+
},
|
|
21
|
+
"dependencies": {
|
|
22
|
+
"@threenative/core": "0.3.9",
|
|
23
|
+
"@threenative/physics": "0.3.9",
|
|
24
|
+
"@threenative/ui": "0.3.9",
|
|
25
|
+
"react": "19.2.0",
|
|
26
|
+
"react-dom": "19.2.0",
|
|
27
|
+
"three": "0.185.1"
|
|
28
|
+
},
|
|
29
|
+
"devDependencies": {
|
|
30
|
+
"@tailwindcss/vite": "4.3.3",
|
|
31
|
+
"@vitejs/plugin-react": "6.0.5",
|
|
32
|
+
"@types/three": "0.185.3",
|
|
33
|
+
"@threenative/assets": "0.3.10",
|
|
34
|
+
"@threenative/playtest": "0.3.9",
|
|
35
|
+
"@types/react": "19.2.0",
|
|
36
|
+
"@types/react-dom": "19.2.0",
|
|
37
|
+
"create-threenative": "0.2.13",
|
|
38
|
+
"esbuild": "0.27.0",
|
|
39
|
+
"playwright": "1.62.1",
|
|
40
|
+
"tailwindcss": "4.3.3",
|
|
41
|
+
"typescript": "7.0.2",
|
|
42
|
+
"vite": "8.2.0",
|
|
43
|
+
"@gltf-transform/cli": "4.4.2",
|
|
44
|
+
"@biomejs/biome": "1.9.4",
|
|
45
|
+
"eslint": "10.13.0"
|
|
46
|
+
},
|
|
47
|
+
"optionalDependencies": {
|
|
48
|
+
"@threenative/runtime-native": "0.3.9"
|
|
49
|
+
},
|
|
50
|
+
"overrides": {
|
|
51
|
+
"sharp": ">=0.35.4",
|
|
52
|
+
"@vitejs/devtools": "0.4.1"
|
|
53
|
+
},
|
|
54
|
+
"pnpm": {
|
|
55
|
+
"overrides": {
|
|
56
|
+
"sharp": ">=0.35.4"
|
|
57
|
+
},
|
|
58
|
+
"onlyBuiltDependencies": ["@threenative/core", "@threenative/runtime-native"],
|
|
59
|
+
"patchedDependencies": {
|
|
60
|
+
"three@0.185.1": "patches/three@0.185.1.patch",
|
|
61
|
+
"vite@8.2.0": "patches/vite@8.2.0.patch",
|
|
62
|
+
"@tailwindcss/node@4.3.3": "patches/@tailwindcss__node@4.3.3.patch"
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
}
|
|
@@ -0,0 +1,238 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "collectathon-acrobatics",
|
|
3
|
+
"target": "web",
|
|
4
|
+
"schemaVersion": 1,
|
|
5
|
+
"viewport": {
|
|
6
|
+
"width": 1280,
|
|
7
|
+
"height": 720
|
|
8
|
+
},
|
|
9
|
+
"warmupFrames": 10,
|
|
10
|
+
"subject": "player",
|
|
11
|
+
"setup": {
|
|
12
|
+
"place": [
|
|
13
|
+
{
|
|
14
|
+
"entity": "player",
|
|
15
|
+
"at": {
|
|
16
|
+
"x": 0,
|
|
17
|
+
"y": 0.85,
|
|
18
|
+
"z": 30
|
|
19
|
+
},
|
|
20
|
+
"facing": {
|
|
21
|
+
"yaw": 0
|
|
22
|
+
}
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
"entity": "walker.0",
|
|
26
|
+
"at": {
|
|
27
|
+
"x": 30,
|
|
28
|
+
"y": 0,
|
|
29
|
+
"z": -10
|
|
30
|
+
},
|
|
31
|
+
"frozen": true
|
|
32
|
+
},
|
|
33
|
+
{
|
|
34
|
+
"entity": "walker.1",
|
|
35
|
+
"at": {
|
|
36
|
+
"x": -30,
|
|
37
|
+
"y": 0,
|
|
38
|
+
"z": -5
|
|
39
|
+
},
|
|
40
|
+
"frozen": true
|
|
41
|
+
}
|
|
42
|
+
]
|
|
43
|
+
},
|
|
44
|
+
"steps": [
|
|
45
|
+
{
|
|
46
|
+
"kind": "input",
|
|
47
|
+
"label": "run-up",
|
|
48
|
+
"press": ["KeyW"],
|
|
49
|
+
"holdTicks": 100,
|
|
50
|
+
"release": false
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
"kind": "input",
|
|
54
|
+
"label": "running-jump",
|
|
55
|
+
"press": ["KeyW", "Space"],
|
|
56
|
+
"holdTicks": 22,
|
|
57
|
+
"release": false
|
|
58
|
+
},
|
|
59
|
+
{
|
|
60
|
+
"kind": "input",
|
|
61
|
+
"label": "running-jump-fall",
|
|
62
|
+
"press": ["KeyW"],
|
|
63
|
+
"holdTicks": 1,
|
|
64
|
+
"release": false
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
"label": "running-jump-land",
|
|
68
|
+
"waitForResource": {
|
|
69
|
+
"id": "state",
|
|
70
|
+
"path": "action",
|
|
71
|
+
"equals": "run"
|
|
72
|
+
},
|
|
73
|
+
"timeoutMs": 120000,
|
|
74
|
+
"release": false
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
"kind": "wait",
|
|
78
|
+
"label": "rerun",
|
|
79
|
+
"waitTicks": 30,
|
|
80
|
+
"release": false
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
"kind": "input",
|
|
84
|
+
"label": "crouch-slide",
|
|
85
|
+
"press": ["KeyW", "ShiftLeft"],
|
|
86
|
+
"holdTicks": 3,
|
|
87
|
+
"release": false
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
"kind": "input",
|
|
91
|
+
"label": "long-jump",
|
|
92
|
+
"press": ["KeyW", "ShiftLeft", "Space"],
|
|
93
|
+
"holdTicks": 20,
|
|
94
|
+
"release": false
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"kind": "input",
|
|
98
|
+
"label": "long-jump-fall",
|
|
99
|
+
"press": ["KeyW"],
|
|
100
|
+
"holdTicks": 1,
|
|
101
|
+
"release": false
|
|
102
|
+
},
|
|
103
|
+
{
|
|
104
|
+
"label": "long-jump-land",
|
|
105
|
+
"waitForResource": {
|
|
106
|
+
"id": "state",
|
|
107
|
+
"path": "action",
|
|
108
|
+
"equals": "run"
|
|
109
|
+
},
|
|
110
|
+
"timeoutMs": 120000,
|
|
111
|
+
"release": false
|
|
112
|
+
},
|
|
113
|
+
{
|
|
114
|
+
"kind": "input",
|
|
115
|
+
"label": "stop",
|
|
116
|
+
"press": [],
|
|
117
|
+
"holdTicks": 45,
|
|
118
|
+
"release": false
|
|
119
|
+
},
|
|
120
|
+
{
|
|
121
|
+
"kind": "input",
|
|
122
|
+
"label": "crouch",
|
|
123
|
+
"press": ["ShiftLeft"],
|
|
124
|
+
"holdTicks": 3,
|
|
125
|
+
"release": false
|
|
126
|
+
},
|
|
127
|
+
{
|
|
128
|
+
"kind": "input",
|
|
129
|
+
"label": "backflip",
|
|
130
|
+
"press": ["ShiftLeft", "Space"],
|
|
131
|
+
"holdTicks": 30,
|
|
132
|
+
"release": false
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
"kind": "input",
|
|
136
|
+
"label": "backflip-fall",
|
|
137
|
+
"press": [],
|
|
138
|
+
"holdTicks": 1,
|
|
139
|
+
"release": false
|
|
140
|
+
},
|
|
141
|
+
{
|
|
142
|
+
"label": "backflip-land",
|
|
143
|
+
"waitForResource": {
|
|
144
|
+
"id": "state",
|
|
145
|
+
"path": "action",
|
|
146
|
+
"equals": "idle"
|
|
147
|
+
},
|
|
148
|
+
"timeoutMs": 120000,
|
|
149
|
+
"release": false
|
|
150
|
+
},
|
|
151
|
+
{
|
|
152
|
+
"kind": "input",
|
|
153
|
+
"label": "side-run",
|
|
154
|
+
"press": ["KeyW"],
|
|
155
|
+
"holdTicks": 60,
|
|
156
|
+
"release": false
|
|
157
|
+
},
|
|
158
|
+
{
|
|
159
|
+
"kind": "input",
|
|
160
|
+
"label": "skid",
|
|
161
|
+
"press": ["KeyS"],
|
|
162
|
+
"holdTicks": 4,
|
|
163
|
+
"release": false
|
|
164
|
+
},
|
|
165
|
+
{
|
|
166
|
+
"kind": "input",
|
|
167
|
+
"label": "sideflip",
|
|
168
|
+
"press": ["KeyS", "Space"],
|
|
169
|
+
"holdTicks": 30,
|
|
170
|
+
"release": false
|
|
171
|
+
},
|
|
172
|
+
{
|
|
173
|
+
"kind": "input",
|
|
174
|
+
"label": "sideflip-fall",
|
|
175
|
+
"press": ["KeyS"],
|
|
176
|
+
"holdTicks": 1,
|
|
177
|
+
"release": false
|
|
178
|
+
},
|
|
179
|
+
{
|
|
180
|
+
"label": "sideflip-land",
|
|
181
|
+
"waitForResource": {
|
|
182
|
+
"id": "state",
|
|
183
|
+
"path": "grounded",
|
|
184
|
+
"equals": true
|
|
185
|
+
},
|
|
186
|
+
"timeoutMs": 120000,
|
|
187
|
+
"release": false
|
|
188
|
+
},
|
|
189
|
+
{
|
|
190
|
+
"kind": "wait",
|
|
191
|
+
"label": "settle",
|
|
192
|
+
"waitTicks": 10,
|
|
193
|
+
"release": true
|
|
194
|
+
}
|
|
195
|
+
],
|
|
196
|
+
"assert": {
|
|
197
|
+
"diagnostics": {
|
|
198
|
+
"noConsoleErrors": true,
|
|
199
|
+
"noNetworkErrors": true,
|
|
200
|
+
"noRuntimeDiagnostics": true,
|
|
201
|
+
"runtimeReady": true
|
|
202
|
+
},
|
|
203
|
+
"components": [
|
|
204
|
+
{
|
|
205
|
+
"entity": "player",
|
|
206
|
+
"component": "distance",
|
|
207
|
+
"path": "single",
|
|
208
|
+
"gte": 3,
|
|
209
|
+
"lte": 9
|
|
210
|
+
},
|
|
211
|
+
{
|
|
212
|
+
"entity": "player",
|
|
213
|
+
"component": "distance",
|
|
214
|
+
"path": "longJump",
|
|
215
|
+
"gte": 10
|
|
216
|
+
},
|
|
217
|
+
{
|
|
218
|
+
"entity": "player",
|
|
219
|
+
"component": "distance",
|
|
220
|
+
"path": "backflip",
|
|
221
|
+
"lte": -2
|
|
222
|
+
},
|
|
223
|
+
{
|
|
224
|
+
"entity": "player",
|
|
225
|
+
"component": "counts",
|
|
226
|
+
"path": "sideflip",
|
|
227
|
+
"equals": 1,
|
|
228
|
+
"allowTrivial": "One skid then one jump press gives exactly one side flip."
|
|
229
|
+
},
|
|
230
|
+
{
|
|
231
|
+
"entity": "player",
|
|
232
|
+
"component": "sideflipFacingError",
|
|
233
|
+
"lte": 0.35,
|
|
234
|
+
"allowTrivial": "Facing the stick within 20 degrees on landing is the side flip's defining property; zero is the target."
|
|
235
|
+
}
|
|
236
|
+
]
|
|
237
|
+
}
|
|
238
|
+
}
|