create-threenative 0.2.3 → 0.2.4
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/README.md +53 -2
- package/agent-docs/references/assertion-reference.md +173 -6
- package/agent-docs/references/capability-reference.md +1303 -99
- package/agent-docs/references/capture-the-frame.md +7 -0
- package/agent-docs/references/creating-creatures.md +215 -0
- package/agent-docs/references/ctx-cookbook.md +69 -0
- package/agent-docs/references/debug-surface.md +8 -3
- package/agent-docs/references/dream-loop.md +150 -0
- package/agent-docs/references/finding-assets.md +70 -2
- package/agent-docs/references/sculpt-from-a-reference.md +3 -2
- package/agent-docs/references/trace-a-slow-frame.md +99 -0
- package/agent-docs/references/visual-baseline.md +41 -0
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
- package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
- package/agent-files/.agents/skills/threenative-builder/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
- package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
- package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
- package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
- package/agent-files/.agents/skills/threenative-verifier/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
- package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
- package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
- package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
- package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
- package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
- package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
- package/agent-files/scripts/reference.mjs +705 -0
- package/agent-files/scripts/visual-loop.mjs +382 -0
- package/capabilities.json +1881 -131
- package/dist/index.d.ts +39 -6
- package/dist/index.js +297 -32
- package/dist/threenative.js +822 -105
- package/package.json +30 -5
- package/template-assets/loading.ts +12 -2
- package/template-assets/patches/three@0.185.1.patch +249 -14
- package/template-assets/worldEnvironment.ts +758 -0
- package/templates/action-rpg/.codex/config.toml +4 -0
- package/templates/action-rpg/.cursor/mcp.json +32 -0
- package/templates/action-rpg/.gemini/settings.json +32 -0
- package/templates/action-rpg/.mcp.json +15 -3
- package/templates/action-rpg/.vscode/mcp.json +36 -0
- package/templates/action-rpg/.zed/settings.json +36 -0
- package/templates/action-rpg/AGENTS.md +69 -378
- package/templates/action-rpg/CLAUDE.md +69 -378
- package/templates/action-rpg/opencode.json +41 -0
- package/templates/action-rpg/package.json +7 -7
- package/templates/action-rpg/playtests/combat.playtest.json +9 -0
- package/templates/action-rpg/playtests/performance.playtest.json +24 -7
- package/templates/action-rpg/playtests/survives.playtest.json +27 -0
- package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
- package/templates/action-rpg/src/conventions.ts +35 -0
- package/templates/action-rpg/src/entities/Enemy.ts +2 -3
- package/templates/action-rpg/src/entities/Player.ts +20 -3
- package/templates/action-rpg/src/render/camera.ts +7 -2
- package/templates/action-rpg/src/render/lighting.ts +5 -3
- package/templates/action-rpg/src/render/loading.ts +12 -2
- package/templates/action-rpg/src/render/materials.ts +11 -0
- package/templates/action-rpg/src/render/palette.ts +10 -3
- package/templates/action-rpg/src/render/postprocessing.ts +21 -58
- package/templates/action-rpg/src/render/quality.ts +170 -0
- package/templates/action-rpg/src/render/shapes.ts +185 -26
- package/templates/action-rpg/src/render/touch-controls.ts +185 -0
- package/templates/action-rpg/src/render/vfx.ts +257 -0
- package/templates/action-rpg/src/render/worldEnvironment.ts +208 -33
- package/templates/action-rpg/src/scenes/Play.ts +43 -6
- package/templates/action-rpg/src/style.css +20 -0
- package/templates/action-rpg/threenative.config.ts +7 -0
- package/templates/defense/.codex/config.toml +4 -0
- package/templates/defense/.cursor/mcp.json +32 -0
- package/templates/defense/.gemini/settings.json +32 -0
- package/templates/defense/.mcp.json +15 -3
- package/templates/defense/.vscode/mcp.json +36 -0
- package/templates/defense/.zed/settings.json +36 -0
- package/templates/defense/AGENTS.md +62 -385
- package/templates/defense/CLAUDE.md +62 -385
- package/templates/defense/opencode.json +41 -0
- package/templates/defense/package.json +7 -7
- package/templates/defense/playtests/performance.playtest.json +24 -7
- package/templates/defense/playtests/pointer-placement.playtest.json +87 -20
- package/templates/defense/playtests/scan.playtest.json +1 -1
- package/templates/defense/playtests/survive.playtest.json +14 -0
- package/templates/defense/src/attackers/Attacker.ts +4 -4
- package/templates/defense/src/board/Route.ts +22 -8
- package/templates/defense/src/conventions.ts +18 -0
- package/templates/defense/src/entities/Player.ts +11 -3
- package/templates/defense/src/game.ts +2 -3
- package/templates/defense/src/physics.ts +9 -39
- package/templates/defense/src/placement/Buildable.ts +4 -4
- package/templates/defense/src/render/camera.ts +9 -3
- package/templates/defense/src/render/loading.ts +12 -2
- package/templates/defense/src/render/materials.ts +9 -0
- package/templates/defense/src/render/palette.ts +12 -5
- package/templates/defense/src/render/postprocessing.ts +21 -58
- package/templates/defense/src/render/quality.ts +170 -0
- package/templates/defense/src/render/shapes.ts +142 -23
- package/templates/defense/src/render/sky.ts +2 -2
- package/templates/defense/src/render/worldEnvironment.ts +208 -33
- package/templates/defense/src/scenes/Boot.ts +2 -2
- package/templates/defense/src/scenes/Defense.ts +13 -6
- package/templates/defense/src/style.css +20 -0
- package/templates/defense/src/towers/Tower.ts +11 -12
- package/templates/defense/src/towers/targeting.ts +1 -1
- package/templates/defense/src/ui/App.tsx +2 -2
- package/templates/defense/threenative.config.ts +7 -0
- package/templates/minimal/.codex/config.toml +4 -0
- package/templates/minimal/.cursor/mcp.json +32 -0
- package/templates/minimal/.gemini/settings.json +32 -0
- package/templates/minimal/.mcp.json +15 -3
- package/templates/minimal/.vscode/mcp.json +36 -0
- package/templates/minimal/.zed/settings.json +36 -0
- package/templates/minimal/AGENTS.md +76 -485
- package/templates/minimal/CLAUDE.md +76 -485
- package/templates/minimal/opencode.json +41 -0
- package/templates/minimal/package.json +6 -6
- package/templates/minimal/playtests/play.playtest.json +2 -1
- package/templates/minimal/playtests/survives.playtest.json +48 -4
- package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
- package/templates/minimal/src/conventions.ts +18 -0
- package/templates/minimal/src/entities/Player.ts +39 -6
- package/templates/minimal/src/main.ts +14 -4
- package/templates/minimal/src/render/materials.ts +7 -0
- package/templates/minimal/src/render/palette.ts +3 -3
- package/templates/minimal/src/render/postprocessing.ts +17 -56
- package/templates/minimal/src/render/quality.ts +162 -0
- package/templates/minimal/src/render/sky.ts +23 -9
- package/templates/minimal/src/render/touch-controls.ts +165 -0
- package/templates/minimal/src/render/worldEnvironment.ts +208 -33
- package/templates/minimal/src/scenes/Play.ts +47 -11
- package/templates/minimal/src/style.css +20 -0
- package/templates/minimal/threenative.config.ts +7 -0
- package/templates/platformer/.codex/config.toml +4 -0
- package/templates/platformer/.cursor/mcp.json +32 -0
- package/templates/platformer/.gemini/settings.json +32 -0
- package/templates/platformer/.mcp.json +15 -3
- package/templates/platformer/.vscode/mcp.json +36 -0
- package/templates/platformer/.zed/settings.json +36 -0
- package/templates/platformer/AGENTS.md +70 -430
- package/templates/platformer/CLAUDE.md +70 -430
- package/templates/platformer/opencode.json +41 -0
- package/templates/platformer/package.json +7 -7
- package/templates/platformer/playtests/oneway.playtest.json +29 -2
- package/templates/platformer/playtests/performance.playtest.json +2 -1
- package/templates/platformer/playtests/survives.playtest.json +31 -0
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +3 -0
- package/templates/platformer/playtests/touch-controls-web.playtest.json +15 -4
- package/templates/platformer/src/conventions.ts +18 -0
- package/templates/platformer/src/entities/Character.ts +63 -1
- package/templates/platformer/src/game.ts +3 -1
- package/templates/platformer/src/level/Platform.ts +13 -1
- package/templates/platformer/src/render/lighting.ts +7 -4
- package/templates/platformer/src/render/loading.ts +12 -2
- package/templates/platformer/src/render/palette.ts +4 -1
- package/templates/platformer/src/render/postprocessing.ts +32 -57
- package/templates/platformer/src/render/quality.ts +170 -0
- package/templates/platformer/src/render/worldEnvironment.ts +208 -33
- package/templates/platformer/src/scenes/Level.ts +52 -12
- package/templates/platformer/src/style.css +20 -0
- package/templates/platformer/threenative.config.ts +7 -0
- package/templates/puzzle/.codex/config.toml +19 -0
- package/templates/puzzle/.cursor/mcp.json +32 -0
- package/templates/puzzle/.gemini/settings.json +32 -0
- package/templates/puzzle/.mcp.json +32 -0
- package/templates/puzzle/.vscode/mcp.json +36 -0
- package/templates/puzzle/.zed/settings.json +36 -0
- package/templates/puzzle/AGENTS.md +96 -0
- package/templates/puzzle/CLAUDE.md +98 -0
- package/templates/puzzle/README.md +43 -0
- package/templates/puzzle/index.html +12 -0
- package/templates/puzzle/kit.json +7 -0
- package/templates/puzzle/opencode.json +41 -0
- package/templates/puzzle/package.json +50 -0
- package/templates/puzzle/playtests/carry.playtest.json +71 -0
- package/templates/puzzle/playtests/performance.playtest.json +23 -0
- package/templates/puzzle/playtests/survives.playtest.json +51 -0
- package/templates/puzzle/playtests/swing.playtest.json +38 -0
- package/templates/puzzle/public/favicon.svg +5 -0
- package/templates/puzzle/src/conventions.ts +25 -0
- package/templates/puzzle/src/entities/Ball.ts +70 -0
- package/templates/puzzle/src/entities/Crate.ts +76 -0
- package/templates/puzzle/src/entities/Gripper.ts +69 -0
- package/templates/puzzle/src/entities/Pendulum.ts +89 -0
- package/templates/puzzle/src/game.ts +48 -0
- package/templates/puzzle/src/main.ts +15 -0
- package/templates/puzzle/src/physics.ts +19 -0
- package/templates/puzzle/src/render/camera.ts +37 -0
- package/templates/puzzle/src/render/lighting.ts +55 -0
- package/templates/puzzle/src/render/loading.ts +325 -0
- package/templates/puzzle/src/render/materials.ts +28 -0
- package/templates/puzzle/src/render/palette.ts +31 -0
- package/templates/puzzle/src/render/postprocessing.ts +34 -0
- package/templates/puzzle/src/render/quality.ts +170 -0
- package/templates/puzzle/src/render/shapes.ts +134 -0
- package/templates/puzzle/src/render/sky.ts +16 -0
- package/templates/puzzle/src/render/touch-controls.ts +185 -0
- package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
- package/templates/puzzle/src/room.ts +83 -0
- package/templates/puzzle/src/scenes/Boot.ts +12 -0
- package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
- package/templates/puzzle/src/state.ts +30 -0
- package/templates/puzzle/src/style.css +96 -0
- package/templates/puzzle/src/ui/App.tsx +22 -0
- package/templates/puzzle/src/ui/GameUi.tsx +20 -0
- package/templates/puzzle/src/ui/Hud.tsx +57 -0
- package/templates/puzzle/src/ui/Menu.tsx +7 -0
- package/templates/puzzle/src/ui/main.tsx +14 -0
- package/templates/puzzle/tailwind.config.ts +1 -0
- package/templates/puzzle/threenative.config.ts +49 -0
- package/templates/puzzle/tsconfig.json +17 -0
- package/templates/puzzle/vite.config.ts +38 -0
- package/templates/racing/.codex/config.toml +4 -0
- package/templates/racing/.cursor/mcp.json +32 -0
- package/templates/racing/.gemini/settings.json +32 -0
- package/templates/racing/.mcp.json +15 -3
- package/templates/racing/.vscode/mcp.json +36 -0
- package/templates/racing/.zed/settings.json +36 -0
- package/templates/racing/AGENTS.md +63 -379
- package/templates/racing/CLAUDE.md +63 -379
- package/templates/racing/native-playtests/survives.playtest.json +43 -0
- package/templates/racing/opencode.json +41 -0
- package/templates/racing/package.json +8 -7
- package/templates/racing/playtests/performance.playtest.json +24 -7
- package/templates/racing/playtests/survives.playtest.json +36 -4
- package/templates/racing/playtests/touch-controls.playtest.json +41 -0
- package/templates/racing/src/conventions.ts +6 -0
- package/templates/racing/src/entities/RacingCar.ts +16 -4
- package/templates/racing/src/entities/Rival.ts +5 -2
- package/templates/racing/src/render/camera.ts +7 -4
- package/templates/racing/src/render/lighting.ts +22 -13
- package/templates/racing/src/render/loading.ts +12 -2
- package/templates/racing/src/render/materials.ts +54 -4
- package/templates/racing/src/render/palette.ts +23 -6
- package/templates/racing/src/render/postprocessing.ts +21 -58
- package/templates/racing/src/render/quality.ts +170 -0
- package/templates/racing/src/render/shapes.ts +537 -26
- package/templates/racing/src/render/sky.ts +5 -2
- package/templates/racing/src/render/touch-controls.ts +185 -0
- package/templates/racing/src/render/worldEnvironment.ts +208 -33
- package/templates/racing/src/scenes/Race.ts +17 -2
- package/templates/racing/src/style.css +20 -0
- package/templates/racing/src/track/Track.ts +270 -31
- package/templates/racing/threenative.config.ts +7 -0
- package/templates/runner/.codex/config.toml +19 -0
- package/templates/runner/.cursor/mcp.json +32 -0
- package/templates/runner/.gemini/settings.json +32 -0
- package/templates/runner/.mcp.json +32 -0
- package/templates/runner/.vscode/mcp.json +36 -0
- package/templates/runner/.zed/settings.json +36 -0
- package/templates/runner/AGENTS.md +96 -0
- package/templates/runner/CLAUDE.md +98 -0
- package/templates/runner/README.md +43 -0
- package/templates/runner/index.html +12 -0
- package/templates/runner/kit.json +7 -0
- package/templates/runner/opencode.json +41 -0
- package/templates/runner/package.json +50 -0
- package/templates/runner/playtests/performance.playtest.json +23 -0
- package/templates/runner/playtests/streams.playtest.json +38 -0
- package/templates/runner/playtests/survives.playtest.json +51 -0
- package/templates/runner/public/favicon.svg +5 -0
- package/templates/runner/src/conventions.ts +24 -0
- package/templates/runner/src/entities/Runner.ts +135 -0
- package/templates/runner/src/game.ts +50 -0
- package/templates/runner/src/main.ts +15 -0
- package/templates/runner/src/physics.ts +13 -0
- package/templates/runner/src/render/camera.ts +39 -0
- package/templates/runner/src/render/dust.ts +131 -0
- package/templates/runner/src/render/lighting.ts +57 -0
- package/templates/runner/src/render/loading.ts +325 -0
- package/templates/runner/src/render/materials.ts +27 -0
- package/templates/runner/src/render/palette.ts +30 -0
- package/templates/runner/src/render/postprocessing.ts +34 -0
- package/templates/runner/src/render/quality.ts +170 -0
- package/templates/runner/src/render/shapes.ts +68 -0
- package/templates/runner/src/render/sky.ts +51 -0
- package/templates/runner/src/render/touch-controls.ts +185 -0
- package/templates/runner/src/render/worldEnvironment.ts +758 -0
- package/templates/runner/src/scenes/Boot.ts +12 -0
- package/templates/runner/src/scenes/Run.ts +142 -0
- package/templates/runner/src/state.ts +29 -0
- package/templates/runner/src/style.css +96 -0
- package/templates/runner/src/track.ts +176 -0
- package/templates/runner/src/ui/App.tsx +22 -0
- package/templates/runner/src/ui/GameUi.tsx +20 -0
- package/templates/runner/src/ui/Hud.tsx +55 -0
- package/templates/runner/src/ui/Menu.tsx +7 -0
- package/templates/runner/src/ui/main.tsx +14 -0
- package/templates/runner/tailwind.config.ts +1 -0
- package/templates/runner/threenative.config.ts +49 -0
- package/templates/runner/tsconfig.json +17 -0
- package/templates/runner/vite.config.ts +38 -0
- package/templates/sailing/.codex/config.toml +4 -0
- package/templates/sailing/.cursor/mcp.json +32 -0
- package/templates/sailing/.gemini/settings.json +32 -0
- package/templates/sailing/.mcp.json +15 -3
- package/templates/sailing/.vscode/mcp.json +36 -0
- package/templates/sailing/.zed/settings.json +36 -0
- package/templates/sailing/AGENTS.md +62 -355
- package/templates/sailing/CLAUDE.md +62 -355
- package/templates/sailing/README.md +12 -9
- package/templates/sailing/native-playtests/float.playtest.json +55 -0
- package/templates/sailing/native-playtests/survives.playtest.json +20 -3
- package/templates/sailing/opencode.json +41 -0
- package/templates/sailing/package.json +8 -8
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
- package/templates/sailing/playtests/float.playtest.json +59 -0
- package/templates/sailing/playtests/performance.playtest.json +21 -6
- package/templates/sailing/playtests/survives.playtest.json +8 -0
- package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
- package/templates/sailing/src/conventions.ts +8 -0
- package/templates/sailing/src/entities/Ship.ts +150 -13
- package/templates/sailing/src/render/camera.ts +15 -8
- package/templates/sailing/src/render/lighting.ts +10 -5
- package/templates/sailing/src/render/loading.ts +12 -2
- package/templates/sailing/src/render/materials.ts +24 -8
- package/templates/sailing/src/render/ocean.ts +179 -0
- package/templates/sailing/src/render/palette.ts +14 -21
- package/templates/sailing/src/render/postprocessing.ts +23 -22
- package/templates/sailing/src/render/props.ts +584 -34
- package/templates/sailing/src/render/quality.ts +140 -0
- package/templates/sailing/src/render/sky.ts +8 -3
- package/templates/sailing/src/render/touch-controls.ts +142 -0
- package/templates/sailing/src/render/worldEnvironment.ts +206 -38
- package/templates/sailing/src/scenes/Sailing.ts +43 -16
- package/templates/sailing/src/style.css +20 -0
- package/templates/sailing/threenative.config.ts +7 -1
- package/templates/shooter/.codex/config.toml +4 -0
- package/templates/shooter/.cursor/mcp.json +32 -0
- package/templates/shooter/.gemini/settings.json +32 -0
- package/templates/shooter/.mcp.json +15 -3
- package/templates/shooter/.vscode/mcp.json +36 -0
- package/templates/shooter/.zed/settings.json +36 -0
- package/templates/shooter/AGENTS.md +76 -415
- package/templates/shooter/CLAUDE.md +76 -415
- package/templates/shooter/kit.json +2 -2
- package/templates/shooter/opencode.json +41 -0
- package/templates/shooter/package.json +7 -7
- package/templates/shooter/playtests/combat.playtest.json +48 -0
- package/templates/shooter/playtests/input-control.playtest.json +165 -35
- package/templates/shooter/playtests/per-item.playtest.json +3 -3
- package/templates/shooter/playtests/performance.playtest.json +24 -7
- package/templates/shooter/playtests/shooter.playtest.json +13 -7
- package/templates/shooter/playtests/survives.playtest.json +27 -0
- package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
- package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
- package/templates/shooter/src/combat/damage.ts +1 -2
- package/templates/shooter/src/conventions.ts +51 -0
- package/templates/shooter/src/entities/Player.ts +235 -18
- package/templates/shooter/src/entities/Target.ts +2 -2
- package/templates/shooter/src/game.ts +13 -4
- package/templates/shooter/src/render/camera.ts +49 -39
- package/templates/shooter/src/render/decals.ts +211 -0
- package/templates/shooter/src/render/lighting.ts +7 -3
- package/templates/shooter/src/render/loading.ts +12 -2
- package/templates/shooter/src/render/materials.ts +56 -3
- package/templates/shooter/src/render/palette.ts +6 -3
- package/templates/shooter/src/render/postprocessing.ts +21 -58
- package/templates/shooter/src/render/quality.ts +170 -0
- package/templates/shooter/src/render/scale.ts +22 -0
- package/templates/shooter/src/render/shapes.ts +343 -62
- package/templates/shooter/src/render/sky.ts +5 -1
- package/templates/shooter/src/render/touch-controls.ts +305 -0
- package/templates/shooter/src/render/ui.css +85 -0
- package/templates/shooter/src/render/ui.ts +19 -3
- package/templates/shooter/src/render/vfx.ts +215 -0
- package/templates/shooter/src/render/worldEnvironment.ts +208 -33
- package/templates/shooter/src/scenes/Play.ts +171 -56
- package/templates/shooter/src/state.ts +5 -0
- package/templates/shooter/src/style.css +20 -0
- package/templates/shooter/src/ui/Crosshair.tsx +25 -0
- package/templates/shooter/src/ui/GameUi.tsx +2 -0
- package/templates/shooter/src/ui/Hud.tsx +7 -1
- package/templates/shooter/src/weapons/Hitscan.ts +3 -4
- package/templates/shooter/src/weapons/Projectile.ts +8 -3
- package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
- package/templates/shooter/threenative.config.ts +7 -0
- package/templates/starter/.codex/config.toml +4 -0
- package/templates/starter/.cursor/mcp.json +32 -0
- package/templates/starter/.gemini/settings.json +32 -0
- package/templates/starter/.mcp.json +15 -3
- package/templates/starter/.vscode/mcp.json +36 -0
- package/templates/starter/.zed/settings.json +36 -0
- package/templates/starter/AGENTS.md +70 -527
- package/templates/starter/CLAUDE.md +70 -527
- package/templates/starter/native-playtests/render-chain.playtest.json +73 -4
- package/templates/starter/opencode.json +41 -0
- package/templates/starter/package.json +7 -7
- package/templates/starter/playtests/boot-failure.playtest.json +45 -0
- package/templates/starter/playtests/look.playtest.json +110 -6
- package/templates/starter/playtests/play.playtest.json +3 -2
- package/templates/starter/playtests/survives.playtest.json +21 -0
- package/templates/starter/playtests/touch-controls.playtest.json +42 -0
- package/templates/starter/src/conventions.ts +18 -0
- package/templates/starter/src/entities/Goal.ts +18 -3
- package/templates/starter/src/entities/Player.ts +72 -9
- package/templates/starter/src/game.ts +2 -0
- package/templates/starter/src/render/adaptiveQuality.ts +195 -0
- package/templates/starter/src/render/camera.ts +1 -1
- package/templates/starter/src/render/coast.ts +199 -0
- package/templates/starter/src/render/hero.ts +88 -0
- package/templates/starter/src/render/implicitSurface.ts +199 -0
- package/templates/starter/src/render/kuwahara.ts +174 -0
- package/templates/starter/src/render/lighting.ts +4 -4
- package/templates/starter/src/render/loading.ts +12 -2
- package/templates/starter/src/render/materials.ts +25 -6
- package/templates/starter/src/render/outline.ts +141 -0
- package/templates/starter/src/render/painterly.ts +86 -0
- package/templates/starter/src/render/palette.ts +15 -6
- package/templates/starter/src/render/postprocessing.ts +87 -36
- package/templates/starter/src/render/quality.ts +185 -0
- package/templates/starter/src/render/rockRidge.ts +198 -0
- package/templates/starter/src/render/rockRidge.worker.ts +77 -0
- package/templates/starter/src/render/scenery.ts +16 -59
- package/templates/starter/src/render/textureLifetime.ts +53 -0
- package/templates/starter/src/render/touch-controls.ts +165 -0
- package/templates/starter/src/render/water.ts +38 -0
- package/templates/starter/src/render/watercolor.ts +85 -0
- package/templates/starter/src/render/worldEnvironment.ts +208 -33
- package/templates/starter/src/scenes/Play.ts +103 -16
- package/templates/starter/src/style.css +27 -7
- package/templates/starter/threenative.config.ts +7 -7
- package/agent-docs/asset-mcp-loop.md +0 -33
- package/agent-docs/ctx-surface.md +0 -69
- package/agent-docs/engine-capabilities.md +0 -4
- package/agent-docs/framework-blocks-you.md +0 -60
- package/agent-docs/look-at-it-and-budget-the-look.md +0 -27
- package/agent-docs/performance-default.md +0 -42
- package/agent-docs/pixel-budget.md +0 -20
- package/agent-docs/playtest-fail-closed.md +0 -23
- package/agent-docs/sculpt-loop.md +0 -16
- package/templates/action-rpg/src/physics.ts +0 -40
- package/templates/defense/public/icon.png +0 -0
- package/templates/minimal/public/icon.png +0 -0
- package/templates/platformer/public/icon.png +0 -0
- package/templates/racing/public/icon.png +0 -0
- package/templates/sailing/public/icon.png +0 -0
- package/templates/sailing/src/render/water-material.ts +0 -14
- package/templates/sailing/src/render/water-shaders.ts +0 -12
- package/templates/sailing/src/render/wave-nodes.ts +0 -10
- package/templates/shooter/public/icon.png +0 -0
- package/templates/shooter/src/physics.ts +0 -49
- package/templates/starter/public/icon.png +0 -0
- /package/{templates/action-rpg/public → template-assets}/icon.png +0 -0
|
@@ -0,0 +1,41 @@
|
|
|
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-blender": {
|
|
33
|
+
"type": "local",
|
|
34
|
+
"command": [
|
|
35
|
+
"node",
|
|
36
|
+
"./node_modules/@threenative/core/mcp/blender.mjs"
|
|
37
|
+
],
|
|
38
|
+
"enabled": true
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "__PROJECT_NAME__",
|
|
3
|
+
"private": true,
|
|
4
|
+
"license": "MIT",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"scripts": {
|
|
7
|
+
"dev": "vite",
|
|
8
|
+
"build": "threenative build",
|
|
9
|
+
"build:web": "threenative build --target web",
|
|
10
|
+
"build:desktop": "threenative build --target desktop",
|
|
11
|
+
"build:android": "threenative build --target android",
|
|
12
|
+
"build:ios": "threenative build --target ios",
|
|
13
|
+
"pretest": "playwright install chromium",
|
|
14
|
+
"test": "vite build && threenative-playtest --scenario \"playtests/*.playtest.json\" --browser-recipe webgpu --headed --server-command \"pnpm dev --host 127.0.0.1 --port $PORT --strictPort\"",
|
|
15
|
+
"typecheck": "tsc --noEmit -p tsconfig.json"
|
|
16
|
+
},
|
|
17
|
+
"dependencies": {
|
|
18
|
+
"@threenative/core": "0.3.1",
|
|
19
|
+
"@threenative/physics": "0.3.1",
|
|
20
|
+
"@threenative/ui": "0.3.1",
|
|
21
|
+
"react": "19.2.0",
|
|
22
|
+
"react-dom": "19.2.0",
|
|
23
|
+
"three": "0.185.1"
|
|
24
|
+
},
|
|
25
|
+
"devDependencies": {
|
|
26
|
+
"@gltf-transform/cli": "4.4.2",
|
|
27
|
+
"@tailwindcss/vite": "4.3.3",
|
|
28
|
+
"@threenative/assets": "0.3.1",
|
|
29
|
+
"@threenative/playtest": "0.3.1",
|
|
30
|
+
"@types/react": "19.2.0",
|
|
31
|
+
"@types/react-dom": "19.2.0",
|
|
32
|
+
"@types/three": "0.185.3",
|
|
33
|
+
"@vitejs/plugin-react": "6.0.5",
|
|
34
|
+
"create-threenative": "0.2.4",
|
|
35
|
+
"esbuild": "0.27.0",
|
|
36
|
+
"playwright": "1.62.1",
|
|
37
|
+
"tailwindcss": "4.3.3",
|
|
38
|
+
"typescript": "5.9.3",
|
|
39
|
+
"vite": "8.2.0"
|
|
40
|
+
},
|
|
41
|
+
"optionalDependencies": {
|
|
42
|
+
"@threenative/runtime-native": "0.3.1"
|
|
43
|
+
},
|
|
44
|
+
"pnpm": {
|
|
45
|
+
"onlyBuiltDependencies": ["@threenative/core", "@threenative/runtime-native"],
|
|
46
|
+
"patchedDependencies": {
|
|
47
|
+
"three@0.185.1": "patches/three@0.185.1.patch"
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "carry",
|
|
3
|
+
"target": "web",
|
|
4
|
+
"schemaVersion": 1,
|
|
5
|
+
"viewport": {
|
|
6
|
+
"width": 1280,
|
|
7
|
+
"height": 720
|
|
8
|
+
},
|
|
9
|
+
"warmupFrames": 40,
|
|
10
|
+
"subject": "player",
|
|
11
|
+
"steps": [
|
|
12
|
+
{
|
|
13
|
+
"kind": "input",
|
|
14
|
+
"label": "walk-to-crate",
|
|
15
|
+
"press": "ArrowUp",
|
|
16
|
+
"holdTicks": 30,
|
|
17
|
+
"release": true
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"kind": "input",
|
|
21
|
+
"label": "grab",
|
|
22
|
+
"press": "KeyE",
|
|
23
|
+
"holdTicks": 4,
|
|
24
|
+
"release": true
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"kind": "wait",
|
|
28
|
+
"label": "lift",
|
|
29
|
+
"waitTicks": 30,
|
|
30
|
+
"release": true
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
"kind": "input",
|
|
34
|
+
"label": "carry-back",
|
|
35
|
+
"press": "ArrowDown",
|
|
36
|
+
"holdTicks": 70,
|
|
37
|
+
"release": true
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"kind": "wait",
|
|
41
|
+
"label": "settle",
|
|
42
|
+
"waitTicks": 20,
|
|
43
|
+
"release": true
|
|
44
|
+
}
|
|
45
|
+
],
|
|
46
|
+
"assert": {
|
|
47
|
+
"diagnostics": {
|
|
48
|
+
"noConsoleErrors": true,
|
|
49
|
+
"noNetworkErrors": true,
|
|
50
|
+
"noRuntimeDiagnostics": true,
|
|
51
|
+
"runtimeReady": true
|
|
52
|
+
},
|
|
53
|
+
"components": [
|
|
54
|
+
{
|
|
55
|
+
"component": "held",
|
|
56
|
+
"entity": "crate.0",
|
|
57
|
+
"equals": true
|
|
58
|
+
},
|
|
59
|
+
{
|
|
60
|
+
"changed": true,
|
|
61
|
+
"component": "position",
|
|
62
|
+
"entity": "crate.0",
|
|
63
|
+
"path": "2"
|
|
64
|
+
}
|
|
65
|
+
],
|
|
66
|
+
"movement": {
|
|
67
|
+
"entity": "player",
|
|
68
|
+
"minDistance": 1.5
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
{
|
|
2
|
+
"acceptanceId": "puzzle-production-performance",
|
|
3
|
+
"artifacts": { "screenshots": "after" },
|
|
4
|
+
"assert": {
|
|
5
|
+
"performance": {
|
|
6
|
+
"maxDrawCalls": 145,
|
|
7
|
+
"maxFrameMsP95": 33,
|
|
8
|
+
"maxTriangles": 12000,
|
|
9
|
+
"minFps": 30
|
|
10
|
+
},
|
|
11
|
+
"renderChain": { "tier": "high" }
|
|
12
|
+
},
|
|
13
|
+
"name": "production-performance",
|
|
14
|
+
"schemaVersion": 1,
|
|
15
|
+
"steps": [
|
|
16
|
+
{ "kind": "input", "press": "ArrowRight", "holdTicks": 60, "release": true },
|
|
17
|
+
{ "kind": "wait", "waitTicks": 600, "release": true }
|
|
18
|
+
],
|
|
19
|
+
"subject": "player",
|
|
20
|
+
"target": "web",
|
|
21
|
+
"viewport": { "height": 1080, "width": 1920 },
|
|
22
|
+
"warmupFrames": 60
|
|
23
|
+
}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "survives",
|
|
3
|
+
"target": "web",
|
|
4
|
+
"schemaVersion": 1,
|
|
5
|
+
"viewport": { "width": 1280, "height": 720 },
|
|
6
|
+
"warmupFrames": 40,
|
|
7
|
+
"subject": "player",
|
|
8
|
+
"steps": [
|
|
9
|
+
{ "kind": "input", "label": "move", "press": "ArrowUp", "holdTicks": 60, "release": true },
|
|
10
|
+
{ "kind": "wait", "label": "settle", "waitTicks": 10, "release": true }
|
|
11
|
+
],
|
|
12
|
+
"assert": {
|
|
13
|
+
"diagnostics": {
|
|
14
|
+
"noConsoleErrors": true,
|
|
15
|
+
"noNetworkErrors": true,
|
|
16
|
+
"noRuntimeDiagnostics": true,
|
|
17
|
+
"runtimeReady": true
|
|
18
|
+
},
|
|
19
|
+
"components": [
|
|
20
|
+
{
|
|
21
|
+
"allowTrivial": "GroundSnap settles the claw before this movement observation; the finite near-zero clearance is the generated call-site proof.",
|
|
22
|
+
"component": "groundClearance",
|
|
23
|
+
"entity": "player",
|
|
24
|
+
"lte": 0.01
|
|
25
|
+
}
|
|
26
|
+
],
|
|
27
|
+
"movement": {
|
|
28
|
+
"entity": "player",
|
|
29
|
+
"minDistance": 0.5,
|
|
30
|
+
"minAxisDelta": { "axis": "-z", "min": 0.5 }
|
|
31
|
+
},
|
|
32
|
+
"visibility": [
|
|
33
|
+
{
|
|
34
|
+
"entity": "touch-controls",
|
|
35
|
+
"present": false,
|
|
36
|
+
"allowTrivial": "Desktop keyboard lanes intentionally omit touch controls while movement proves the scene is active."
|
|
37
|
+
}
|
|
38
|
+
],
|
|
39
|
+
"visual": [
|
|
40
|
+
{
|
|
41
|
+
"region": {
|
|
42
|
+
"x": 0,
|
|
43
|
+
"y": 0,
|
|
44
|
+
"width": 1280,
|
|
45
|
+
"height": 720,
|
|
46
|
+
"minNonblankPixelRatio": 0.01
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
]
|
|
50
|
+
}
|
|
51
|
+
}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "swing",
|
|
3
|
+
"target": "web",
|
|
4
|
+
"schemaVersion": 1,
|
|
5
|
+
"viewport": { "width": 1280, "height": 720 },
|
|
6
|
+
"warmupFrames": 60,
|
|
7
|
+
"subject": "pendulum",
|
|
8
|
+
"steps": [
|
|
9
|
+
{ "kind": "wait", "label": "hang-still", "waitTicks": 60, "release": true },
|
|
10
|
+
{ "kind": "input", "label": "shove", "press": "KeyF", "holdTicks": 4, "release": true },
|
|
11
|
+
{ "kind": "wait", "label": "swing-out", "waitTicks": 40, "release": true }
|
|
12
|
+
],
|
|
13
|
+
"assert": {
|
|
14
|
+
"diagnostics": {
|
|
15
|
+
"noConsoleErrors": true,
|
|
16
|
+
"noNetworkErrors": true,
|
|
17
|
+
"noRuntimeDiagnostics": true,
|
|
18
|
+
"runtimeReady": true
|
|
19
|
+
},
|
|
20
|
+
"components": [
|
|
21
|
+
{
|
|
22
|
+
"component": "swings",
|
|
23
|
+
"entity": "pendulum",
|
|
24
|
+
"gte": 1
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"changed": true,
|
|
28
|
+
"component": "position",
|
|
29
|
+
"entity": "pendulum",
|
|
30
|
+
"path": "2"
|
|
31
|
+
}
|
|
32
|
+
],
|
|
33
|
+
"movement": {
|
|
34
|
+
"entity": "pendulum",
|
|
35
|
+
"minDistance": 0.3
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { GroundSnap, normaliseToMetres } from "@threenative/core";
|
|
2
|
+
import type { Group } from "three";
|
|
3
|
+
|
|
4
|
+
export interface IPuzzleConventions {
|
|
5
|
+
readonly applyGrounding: (surfaceY: number, dt: number) => void;
|
|
6
|
+
readonly groundSnap: GroundSnap;
|
|
7
|
+
readonly normaliseFactor: number;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* One metre is one metre, and the claw's feet meet the floor.
|
|
12
|
+
*
|
|
13
|
+
* `normaliseToMetres` returns the factor it applied, and `GroundSnap` reports the clearance it
|
|
14
|
+
* settled on. Both are published through the gripper's `debug()`, so a scenario can prove the
|
|
15
|
+
* conventions ran rather than trusting that they did.
|
|
16
|
+
*/
|
|
17
|
+
export function prepareGripperConventions(model: Group): IPuzzleConventions {
|
|
18
|
+
const normaliseFactor = normaliseToMetres(model, { axis: "height", metres: 1.7 });
|
|
19
|
+
const groundSnap = new GroundSnap(model);
|
|
20
|
+
return {
|
|
21
|
+
applyGrounding: (surfaceY, dt) => groundSnap.apply(model, surfaceY, dt),
|
|
22
|
+
groundSnap,
|
|
23
|
+
normaliseFactor,
|
|
24
|
+
};
|
|
25
|
+
}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import type { ICtx } from "@threenative/core";
|
|
2
|
+
import { Area3D, CollisionShape3D, RigidBody3D } from "@threenative/physics";
|
|
3
|
+
import type { Mesh } from "three";
|
|
4
|
+
import { BALL_LAYER, BALL_MASK, type PuzzlePhysics } from "../physics.js";
|
|
5
|
+
import { BALL_RADIUS, GOAL_RADIUS, ball as ballMesh } from "../render/shapes.js";
|
|
6
|
+
import { BALL_START, GOAL_POSITION } from "../room.js";
|
|
7
|
+
import type { GameState } from "../state.js";
|
|
8
|
+
|
|
9
|
+
type GameCtx = ICtx<GameState, PuzzlePhysics>;
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* The thing that has to reach the goal, and the goal that notices when it does.
|
|
13
|
+
*
|
|
14
|
+
* The goal is an `Area3D`: an overlap volume that reports what is inside it without becoming
|
|
15
|
+
* something the ball can bounce off. A win condition written as a distance check instead would
|
|
16
|
+
* pass through walls and fire on a ball that flew over the ring.
|
|
17
|
+
*/
|
|
18
|
+
export class Ball {
|
|
19
|
+
readonly mesh: Mesh;
|
|
20
|
+
readonly body: RigidBody3D;
|
|
21
|
+
readonly goal: Area3D;
|
|
22
|
+
#scored = false;
|
|
23
|
+
|
|
24
|
+
constructor(ctx: GameCtx) {
|
|
25
|
+
this.mesh = ballMesh();
|
|
26
|
+
this.mesh.position.set(BALL_START.x, BALL_START.y, BALL_START.z);
|
|
27
|
+
ctx.add(this.mesh);
|
|
28
|
+
this.body = new RigidBody3D({
|
|
29
|
+
collisionLayer: BALL_LAYER,
|
|
30
|
+
collisionMask: BALL_MASK,
|
|
31
|
+
entity: "ball",
|
|
32
|
+
mass: 3.2,
|
|
33
|
+
object: this.mesh,
|
|
34
|
+
physics: ctx.physics,
|
|
35
|
+
shape: CollisionShape3D.sphere(BALL_RADIUS),
|
|
36
|
+
});
|
|
37
|
+
this.goal = new Area3D({
|
|
38
|
+
collisionLayer: 0,
|
|
39
|
+
collisionMask: BALL_LAYER,
|
|
40
|
+
entity: "goal",
|
|
41
|
+
physics: ctx.physics,
|
|
42
|
+
position: { x: GOAL_POSITION.x, y: GOAL_POSITION.y + 0.5, z: GOAL_POSITION.z },
|
|
43
|
+
shape: CollisionShape3D.sphere(GOAL_RADIUS),
|
|
44
|
+
});
|
|
45
|
+
// Godot's `Area3D.body_entered`, unchanged. The mask above means only the ball can raise it.
|
|
46
|
+
this.goal.on("bodyEntered", () => {
|
|
47
|
+
this.#scored = true;
|
|
48
|
+
});
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** True once the ball has entered the goal volume, and every frame after. */
|
|
52
|
+
get scored(): boolean {
|
|
53
|
+
return this.#scored;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
debug(): Record<string, unknown> {
|
|
57
|
+
const velocity = this.body.linearVelocity;
|
|
58
|
+
return {
|
|
59
|
+
position: this.mesh.position.toArray(),
|
|
60
|
+
scored: this.scored,
|
|
61
|
+
speed: Math.hypot(velocity.x, velocity.y, velocity.z),
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
dispose(): void {
|
|
66
|
+
this.goal.dispose();
|
|
67
|
+
this.body.dispose();
|
|
68
|
+
this.mesh.removeFromParent();
|
|
69
|
+
}
|
|
70
|
+
}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
import type { ICtx } from "@threenative/core";
|
|
2
|
+
import { CollisionShape3D, RigidBody3D } from "@threenative/physics";
|
|
3
|
+
import type { Mesh, Vector3 } from "three";
|
|
4
|
+
import { CRATE_LAYER, CRATE_MASK, type PuzzlePhysics } from "../physics.js";
|
|
5
|
+
import { CRATE_SIZE, crate as crateMesh } from "../render/shapes.js";
|
|
6
|
+
import type { GameState } from "../state.js";
|
|
7
|
+
|
|
8
|
+
type GameCtx = ICtx<GameState, PuzzlePhysics>;
|
|
9
|
+
|
|
10
|
+
const CARRY_HEIGHT = 1.15;
|
|
11
|
+
const CARRY_BLEND = 12;
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* A box the player can pick up, carry and set down.
|
|
15
|
+
*
|
|
16
|
+
* Carrying is a velocity, not a teleport. Snapping a dynamic body to the claw each frame makes it
|
|
17
|
+
* pass through walls and pop the solver; steering its velocity toward the carry point keeps every
|
|
18
|
+
* contact the room has honest, which is the whole point of a physics puzzle.
|
|
19
|
+
*/
|
|
20
|
+
export class Crate {
|
|
21
|
+
readonly mesh: Mesh;
|
|
22
|
+
readonly body: RigidBody3D;
|
|
23
|
+
#held = false;
|
|
24
|
+
|
|
25
|
+
constructor(
|
|
26
|
+
ctx: GameCtx,
|
|
27
|
+
position: Vector3,
|
|
28
|
+
readonly id: string,
|
|
29
|
+
) {
|
|
30
|
+
this.mesh = crateMesh();
|
|
31
|
+
this.mesh.position.copy(position);
|
|
32
|
+
ctx.add(this.mesh);
|
|
33
|
+
this.body = new RigidBody3D({
|
|
34
|
+
collisionLayer: CRATE_LAYER,
|
|
35
|
+
collisionMask: CRATE_MASK,
|
|
36
|
+
entity: `crate.${id}`,
|
|
37
|
+
mass: 14,
|
|
38
|
+
object: this.mesh,
|
|
39
|
+
physics: ctx.physics,
|
|
40
|
+
shape: CollisionShape3D.box(CRATE_SIZE, CRATE_SIZE, CRATE_SIZE),
|
|
41
|
+
});
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
get held(): boolean {
|
|
45
|
+
return this.#held;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
hold(): void {
|
|
49
|
+
this.#held = true;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** Lets go, keeping whatever velocity the carry gave it — a shove is a legitimate solution. */
|
|
53
|
+
release(): void {
|
|
54
|
+
this.#held = false;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
carry(target: Vector3, dt: number): void {
|
|
58
|
+
if (!this.#held) return;
|
|
59
|
+
const blend = Math.min(1, Math.max(0, dt) * CARRY_BLEND);
|
|
60
|
+
const position = this.mesh.position;
|
|
61
|
+
this.body.linearVelocity = {
|
|
62
|
+
x: ((target.x - position.x) / Math.max(dt, 1 / 240)) * blend,
|
|
63
|
+
y: ((target.y + CARRY_HEIGHT - position.y) / Math.max(dt, 1 / 240)) * blend,
|
|
64
|
+
z: ((target.z - position.z) / Math.max(dt, 1 / 240)) * blend,
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
debug(): Record<string, unknown> {
|
|
69
|
+
return { held: this.#held, position: this.mesh.position.toArray() };
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
dispose(): void {
|
|
73
|
+
this.body.dispose();
|
|
74
|
+
this.mesh.removeFromParent();
|
|
75
|
+
}
|
|
76
|
+
}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import type { ICtx } from "@threenative/core";
|
|
2
|
+
import { type Group, Vector3 } from "three";
|
|
3
|
+
import { type IPuzzleConventions, prepareGripperConventions } from "../conventions.js";
|
|
4
|
+
import type { PuzzlePhysics } from "../physics.js";
|
|
5
|
+
import { gripper as gripperMesh } from "../render/shapes.js";
|
|
6
|
+
import type { ITouchInput } from "../render/touch-controls.js";
|
|
7
|
+
import { ROOM_DEPTH, ROOM_WIDTH } from "../room.js";
|
|
8
|
+
import type { GameState } from "../state.js";
|
|
9
|
+
|
|
10
|
+
type GameCtx = ICtx<GameState, PuzzlePhysics>;
|
|
11
|
+
|
|
12
|
+
const MOVE_SPEED = 5.2;
|
|
13
|
+
const SPAWN = new Vector3(-5.5, 0, 9);
|
|
14
|
+
const MARGIN = 1.4;
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* The player.
|
|
18
|
+
*
|
|
19
|
+
* A claw rather than a character: this game is about what the player moves, not about the mover,
|
|
20
|
+
* so the gripper is kinematic, stays on the floor, and carries exactly one crate. It is a plain
|
|
21
|
+
* transform with no rigid body — nothing in the room should be solvable by shoving the player
|
|
22
|
+
* into it.
|
|
23
|
+
*/
|
|
24
|
+
export class Gripper {
|
|
25
|
+
readonly mesh: Group;
|
|
26
|
+
readonly tags = ["player", "gripper"];
|
|
27
|
+
#conventions: IPuzzleConventions;
|
|
28
|
+
|
|
29
|
+
constructor(ctx: GameCtx) {
|
|
30
|
+
this.mesh = gripperMesh();
|
|
31
|
+
this.mesh.name = "player";
|
|
32
|
+
this.mesh.position.copy(SPAWN);
|
|
33
|
+
this.#conventions = prepareGripperConventions(this.mesh);
|
|
34
|
+
ctx.add(this.mesh);
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
update(ctx: GameCtx, dt: number, touch?: ITouchInput): void {
|
|
38
|
+
const move = ctx.input.vector("move");
|
|
39
|
+
if (touch !== undefined) {
|
|
40
|
+
move.x += touch.move.x;
|
|
41
|
+
move.y += touch.move.y;
|
|
42
|
+
move.clampLength(0, 1);
|
|
43
|
+
}
|
|
44
|
+
const limitX = ROOM_WIDTH / 2 - MARGIN;
|
|
45
|
+
const limitZ = ROOM_DEPTH / 2 - MARGIN;
|
|
46
|
+
this.mesh.position.x = Math.min(
|
|
47
|
+
limitX,
|
|
48
|
+
Math.max(-limitX, this.mesh.position.x + move.x * MOVE_SPEED * dt),
|
|
49
|
+
);
|
|
50
|
+
this.mesh.position.z = Math.min(
|
|
51
|
+
limitZ,
|
|
52
|
+
Math.max(-limitZ, this.mesh.position.z - move.y * MOVE_SPEED * dt),
|
|
53
|
+
);
|
|
54
|
+
if (move.lengthSq() > 0) this.mesh.rotation.y = Math.atan2(move.x, -move.y);
|
|
55
|
+
this.#conventions.applyGrounding(0, dt);
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
debug(): Record<string, unknown> {
|
|
59
|
+
return {
|
|
60
|
+
groundClearance: this.#conventions.groundSnap.clearance,
|
|
61
|
+
normaliseFactor: this.#conventions.normaliseFactor,
|
|
62
|
+
position: this.mesh.position.toArray(),
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
dispose(): void {
|
|
67
|
+
this.mesh.removeFromParent();
|
|
68
|
+
}
|
|
69
|
+
}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import type { ICtx } from "@threenative/core";
|
|
2
|
+
import { CollisionShape3D, Joint3D, RigidBody3D } from "@threenative/physics";
|
|
3
|
+
import { type Mesh, Vector3 } from "three";
|
|
4
|
+
import { type PuzzlePhysics, ROOM_LAYER, WEIGHT_LAYER } from "../physics.js";
|
|
5
|
+
import { weight as weightMesh } from "../render/shapes.js";
|
|
6
|
+
import { GANTRY_HEIGHT } from "../room.js";
|
|
7
|
+
import type { GameState } from "../state.js";
|
|
8
|
+
|
|
9
|
+
type GameCtx = ICtx<GameState, PuzzlePhysics>;
|
|
10
|
+
|
|
11
|
+
const BOB_RADIUS = 0.62;
|
|
12
|
+
const CABLE = 2.6;
|
|
13
|
+
const ANCHOR = new Vector3(0, GANTRY_HEIGHT, 3.2);
|
|
14
|
+
const SHOVE = 7.5;
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* A weight on a hinge, and the only force in the room the player cannot supply by walking.
|
|
18
|
+
*
|
|
19
|
+
* The beam is a fixed body with no visual of its own — the gantry mesh is decoration, and the
|
|
20
|
+
* hinge needs something on the world side to hang from. `Joint3D.hinge` takes the anchor in each
|
|
21
|
+
* body's *local* space, so the beam's anchor is its origin and the bob's is the cable length
|
|
22
|
+
* above its centre.
|
|
23
|
+
*/
|
|
24
|
+
export class Pendulum {
|
|
25
|
+
readonly mesh: Mesh;
|
|
26
|
+
readonly bob: RigidBody3D;
|
|
27
|
+
readonly beam: RigidBody3D;
|
|
28
|
+
readonly hinge: Joint3D;
|
|
29
|
+
#swings = 0;
|
|
30
|
+
|
|
31
|
+
constructor(ctx: GameCtx) {
|
|
32
|
+
this.mesh = weightMesh(BOB_RADIUS);
|
|
33
|
+
this.mesh.name = "pendulum-weight";
|
|
34
|
+
this.mesh.position.set(ANCHOR.x, ANCHOR.y - CABLE, ANCHOR.z);
|
|
35
|
+
ctx.add(this.mesh);
|
|
36
|
+
|
|
37
|
+
this.beam = new RigidBody3D({
|
|
38
|
+
collisionLayer: ROOM_LAYER,
|
|
39
|
+
collisionMask: 0,
|
|
40
|
+
entity: "pendulum.beam",
|
|
41
|
+
physics: ctx.physics,
|
|
42
|
+
position: { x: ANCHOR.x, y: ANCHOR.y, z: ANCHOR.z },
|
|
43
|
+
shape: CollisionShape3D.box(0.3, 0.2, 0.3),
|
|
44
|
+
type: "fixed",
|
|
45
|
+
});
|
|
46
|
+
this.bob = new RigidBody3D({
|
|
47
|
+
collisionLayer: WEIGHT_LAYER,
|
|
48
|
+
entity: "pendulum.bob",
|
|
49
|
+
mass: 90,
|
|
50
|
+
object: this.mesh,
|
|
51
|
+
physics: ctx.physics,
|
|
52
|
+
shape: CollisionShape3D.sphere(BOB_RADIUS),
|
|
53
|
+
});
|
|
54
|
+
this.hinge = Joint3D.hinge({
|
|
55
|
+
anchorA: { x: 0, y: 0, z: 0 },
|
|
56
|
+
anchorB: { x: 0, y: CABLE, z: 0 },
|
|
57
|
+
axis: { x: 1, y: 0, z: 0 },
|
|
58
|
+
bodyA: this.beam,
|
|
59
|
+
bodyB: this.bob,
|
|
60
|
+
physics: ctx.physics,
|
|
61
|
+
});
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
get swings(): number {
|
|
65
|
+
return this.#swings;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/** One shove along +z. The bob does the rest, which is the reason it is on a hinge. */
|
|
69
|
+
swing(): void {
|
|
70
|
+
this.#swings += 1;
|
|
71
|
+
const velocity = this.bob.linearVelocity;
|
|
72
|
+
this.bob.linearVelocity = { x: velocity.x, y: velocity.y, z: velocity.z + SHOVE };
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
debug(): Record<string, unknown> {
|
|
76
|
+
return {
|
|
77
|
+
position: this.mesh.position.toArray(),
|
|
78
|
+
speed: Math.hypot(this.bob.linearVelocity.x, this.bob.linearVelocity.z),
|
|
79
|
+
swings: this.#swings,
|
|
80
|
+
};
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
dispose(): void {
|
|
84
|
+
this.hinge.dispose();
|
|
85
|
+
this.bob.dispose();
|
|
86
|
+
this.beam.dispose();
|
|
87
|
+
this.mesh.removeFromParent();
|
|
88
|
+
}
|
|
89
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { defineGame } from "@threenative/core";
|
|
2
|
+
import { playtest } from "@threenative/core/playtest";
|
|
3
|
+
import { rapier } from "@threenative/physics";
|
|
4
|
+
import config from "../threenative.config.js";
|
|
5
|
+
import type { PuzzlePhysics } from "./physics.js";
|
|
6
|
+
import { Boot } from "./scenes/Boot.js";
|
|
7
|
+
import { Puzzle } from "./scenes/Puzzle.js";
|
|
8
|
+
import type { GameState } from "./state.js";
|
|
9
|
+
|
|
10
|
+
const game = defineGame<GameState, PuzzlePhysics>({
|
|
11
|
+
input: {
|
|
12
|
+
move: {
|
|
13
|
+
down: ["ArrowDown", "KeyS"],
|
|
14
|
+
left: ["ArrowLeft", "KeyA"],
|
|
15
|
+
right: ["ArrowRight", "KeyD"],
|
|
16
|
+
up: ["ArrowUp", "KeyW"],
|
|
17
|
+
},
|
|
18
|
+
grab: { keys: ["KeyE", "Space"] },
|
|
19
|
+
restart: { keys: ["KeyR"] },
|
|
20
|
+
swing: { keys: ["KeyF"] },
|
|
21
|
+
},
|
|
22
|
+
plugins: [rapier({ gravity: { x: 0, y: -9.81, z: 0 } }), playtest()],
|
|
23
|
+
display: config.display,
|
|
24
|
+
render: config.renderer,
|
|
25
|
+
scenes: { boot: Boot, puzzle: Puzzle },
|
|
26
|
+
seed: 51_204,
|
|
27
|
+
start: "boot",
|
|
28
|
+
});
|
|
29
|
+
|
|
30
|
+
export default game;
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* What the UI can ask the game to do.
|
|
34
|
+
*
|
|
35
|
+
* Intents are one-way and named by the game: the UI sends `restart`, `pause` or `resume` and the
|
|
36
|
+
* game decides what each means. Nothing comes back this way — the UI reads the game's published
|
|
37
|
+
* state instead, which keeps one source of truth on the side that owns the simulation.
|
|
38
|
+
*/
|
|
39
|
+
game.ui.onIntent((intent) => {
|
|
40
|
+
if (intent === "restart") void game.goto("puzzle");
|
|
41
|
+
if (intent === "pause") game.pause();
|
|
42
|
+
if (intent === "resume") game.resume();
|
|
43
|
+
game.state.set({
|
|
44
|
+
uiReady: game.ui.connected,
|
|
45
|
+
...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
|
|
46
|
+
});
|
|
47
|
+
game.state.flush();
|
|
48
|
+
});
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { acceptHotUpdate } from "@threenative/core/hot";
|
|
2
|
+
import { createElement } from "react";
|
|
3
|
+
import { createRoot } from "react-dom/client";
|
|
4
|
+
import game from "./game.js";
|
|
5
|
+
import { App } from "./ui/App.js";
|
|
6
|
+
import "./style.css";
|
|
7
|
+
|
|
8
|
+
import.meta.hot?.accept();
|
|
9
|
+
acceptHotUpdate(game, import.meta.hot);
|
|
10
|
+
const root = document.getElementById("root");
|
|
11
|
+
if (root === null) throw new Error("Missing #root element.");
|
|
12
|
+
const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
|
|
13
|
+
const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
|
|
14
|
+
appRoot.__threenativeRoot = reactRoot;
|
|
15
|
+
reactRoot.render(createElement(App, { game }));
|