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,83 @@
|
|
|
1
|
+
import { InstancedBatch } from "@threenative/core";
|
|
2
|
+
import { buildStaticColliders } from "@threenative/physics";
|
|
3
|
+
import { Group, type Object3D } from "three";
|
|
4
|
+
import { floorSlab, floorTile, gantry, ramp, wallSlab } from "./render/shapes.js";
|
|
5
|
+
|
|
6
|
+
export const ROOM_WIDTH = 22;
|
|
7
|
+
export const ROOM_DEPTH = 26;
|
|
8
|
+
export const WALL_HEIGHT = 4.4;
|
|
9
|
+
export const GANTRY_HEIGHT = 5;
|
|
10
|
+
export const GANTRY_SPAN = 5.4;
|
|
11
|
+
/** Where the ball starts, and where it has to end up. */
|
|
12
|
+
export const BALL_START = { x: -5.5, y: 0.5, z: 7 } as const;
|
|
13
|
+
export const GOAL_POSITION = { x: 5.4, y: 0, z: -8.4 } as const;
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* Every mesh the ball can hit and none it cannot.
|
|
17
|
+
*
|
|
18
|
+
* `buildStaticColliders` reads the meshes a game authored and builds fixed trimesh bodies from
|
|
19
|
+
* them, so the room's collision is the room's geometry rather than a second, hand-written list of
|
|
20
|
+
* boxes that drifts from it the first time a wall moves. The predicate is the game's: only meshes
|
|
21
|
+
* this file named `room-*` become colliders, so the floor tiles and the goal ring stay decorative.
|
|
22
|
+
*/
|
|
23
|
+
export function buildRoom(): Group {
|
|
24
|
+
const room = new Group();
|
|
25
|
+
room.name = "room";
|
|
26
|
+
room.add(floorSlab(ROOM_WIDTH, ROOM_DEPTH));
|
|
27
|
+
|
|
28
|
+
const half = { x: ROOM_WIDTH / 2, z: ROOM_DEPTH / 2 };
|
|
29
|
+
for (const [width, depth, x, z] of [
|
|
30
|
+
[ROOM_WIDTH, 0.6, 0, -half.z],
|
|
31
|
+
[ROOM_WIDTH, 0.6, 0, half.z],
|
|
32
|
+
[0.6, ROOM_DEPTH, -half.x, 0],
|
|
33
|
+
[0.6, ROOM_DEPTH, half.x, 0],
|
|
34
|
+
] as const) {
|
|
35
|
+
const wall = wallSlab(width, WALL_HEIGHT, depth);
|
|
36
|
+
wall.position.set(x, WALL_HEIGHT / 2, z);
|
|
37
|
+
room.add(wall);
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
// The lip the ball cannot clear on its own. Everything the player does is in service of
|
|
41
|
+
// getting past this one 0.55m step.
|
|
42
|
+
const lip = ramp(ROOM_WIDTH - 1.2, 0.55, 0.9);
|
|
43
|
+
lip.position.set(0, 0.275, -1.5);
|
|
44
|
+
room.add(lip);
|
|
45
|
+
|
|
46
|
+
const frame = gantry(GANTRY_SPAN, GANTRY_HEIGHT);
|
|
47
|
+
frame.position.set(0, 0, 3.2);
|
|
48
|
+
room.add(frame);
|
|
49
|
+
return room;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* The floor's tile grid, as one draw.
|
|
54
|
+
*
|
|
55
|
+
* `InstancedBatch` takes the geometry and the material from the game and places copies as the
|
|
56
|
+
* layout is walked, so the grid never has to be counted first. Two hundred and forty tiles cost
|
|
57
|
+
* one draw call, which is why the room can have a readable floor at all.
|
|
58
|
+
*/
|
|
59
|
+
export function buildFloorTiles(parent: Object3D, size = 2): void {
|
|
60
|
+
const { geometry, material } = floorTile(size);
|
|
61
|
+
const tiles = new InstancedBatch({ geometry, material });
|
|
62
|
+
const columns = Math.floor((ROOM_WIDTH - 1) / size);
|
|
63
|
+
const rows = Math.floor((ROOM_DEPTH - 1) / size);
|
|
64
|
+
for (let column = 0; column < columns; column += 1) {
|
|
65
|
+
for (let row = 0; row < rows; row += 1) {
|
|
66
|
+
if ((column + row) % 2 === 1) continue;
|
|
67
|
+
tiles.place({
|
|
68
|
+
position: [
|
|
69
|
+
(column + 0.5) * size - (columns * size) / 2,
|
|
70
|
+
0.03,
|
|
71
|
+
(row + 0.5) * size - (rows * size) / 2,
|
|
72
|
+
],
|
|
73
|
+
});
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
tiles.build({ name: "floor-tiles", parent, receiveShadow: true });
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
export function collideRoom(physics: Parameters<typeof buildStaticColliders>[0], room: Object3D) {
|
|
80
|
+
return buildStaticColliders(physics, room, {
|
|
81
|
+
predicate: (object) => object.name.startsWith("room-"),
|
|
82
|
+
});
|
|
83
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { Scene } from "@threenative/core";
|
|
2
|
+
import type { PuzzlePhysics } from "../physics.js";
|
|
3
|
+
import type { GameState } from "../state.js";
|
|
4
|
+
import { type GameCtx, Puzzle } from "./Puzzle.js";
|
|
5
|
+
|
|
6
|
+
export class Boot extends Scene<GameState, PuzzlePhysics> {
|
|
7
|
+
static override readonly initialState = Puzzle.initialState;
|
|
8
|
+
|
|
9
|
+
override enter(ctx: GameCtx): void {
|
|
10
|
+
void ctx.goto("puzzle");
|
|
11
|
+
}
|
|
12
|
+
}
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
import {
|
|
2
|
+
type ICtx,
|
|
3
|
+
Scene,
|
|
4
|
+
type SceneFrame,
|
|
5
|
+
afterPhysics,
|
|
6
|
+
isMobile,
|
|
7
|
+
isTouchscreenAvailable,
|
|
8
|
+
} from "@threenative/core";
|
|
9
|
+
import { type PerspectiveCamera, Vector3 } from "three";
|
|
10
|
+
import { Ball } from "../entities/Ball.js";
|
|
11
|
+
import { Crate } from "../entities/Crate.js";
|
|
12
|
+
import { Gripper } from "../entities/Gripper.js";
|
|
13
|
+
import { Pendulum } from "../entities/Pendulum.js";
|
|
14
|
+
import type { PuzzlePhysics } from "../physics.js";
|
|
15
|
+
import { followGripper, setupCamera } from "../render/camera.js";
|
|
16
|
+
import { setupLighting } from "../render/lighting.js";
|
|
17
|
+
import { createLoadingScreen } from "../render/loading.js";
|
|
18
|
+
import { setupPost } from "../render/postprocessing.js";
|
|
19
|
+
import { goalRing } from "../render/shapes.js";
|
|
20
|
+
import { setupSky } from "../render/sky.js";
|
|
21
|
+
import { TouchControls } from "../render/touch-controls.js";
|
|
22
|
+
import { GOAL_POSITION, buildFloorTiles, buildRoom, collideRoom } from "../room.js";
|
|
23
|
+
import { FLOOR_FAIL_Y, type GameState, INITIAL_STATE } from "../state.js";
|
|
24
|
+
|
|
25
|
+
export type GameCtx = ICtx<GameState, PuzzlePhysics>;
|
|
26
|
+
|
|
27
|
+
/** Where the three crates start. Move them and the puzzle changes; that is the intent. */
|
|
28
|
+
const CRATE_SPAWNS = [
|
|
29
|
+
// The first crate sits straight ahead of the claw's spawn, just outside grab range: walking
|
|
30
|
+
// forward and pressing grab is the first thing the room teaches, and `playtests/carry` is that
|
|
31
|
+
// exact walk. Move this and the scenario's hold has to move with it.
|
|
32
|
+
new Vector3(-5.5, 0.6, 6.2),
|
|
33
|
+
new Vector3(-1.6, 0.6, 4.4),
|
|
34
|
+
new Vector3(2.8, 0.6, 5.4),
|
|
35
|
+
] as const;
|
|
36
|
+
const GRAB_RANGE = 2.1;
|
|
37
|
+
|
|
38
|
+
export class Puzzle extends Scene<GameState, PuzzlePhysics> {
|
|
39
|
+
static override readonly initialState = INITIAL_STATE;
|
|
40
|
+
|
|
41
|
+
override enter(ctx: GameCtx): SceneFrame<GameState, PuzzlePhysics> {
|
|
42
|
+
setupSky(ctx.scene);
|
|
43
|
+
const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
|
|
44
|
+
// isMobile() arrives as an argument because src/render/ imports no framework package: the
|
|
45
|
+
// platform decision is made here, in portable game code.
|
|
46
|
+
setupPost(ctx.renderer, ctx.scene, ctx.camera, { godraysLight: sun, mobile: isMobile() });
|
|
47
|
+
const camera = ctx.camera as PerspectiveCamera;
|
|
48
|
+
setupCamera(camera);
|
|
49
|
+
ctx.add(camera);
|
|
50
|
+
const loading = createLoadingScreen(ctx);
|
|
51
|
+
|
|
52
|
+
const room = buildRoom();
|
|
53
|
+
ctx.add(room);
|
|
54
|
+
buildFloorTiles(room);
|
|
55
|
+
collideRoom(ctx, room);
|
|
56
|
+
const ring = goalRing();
|
|
57
|
+
ring.position.set(GOAL_POSITION.x, GOAL_POSITION.y, GOAL_POSITION.z);
|
|
58
|
+
ctx.add(ring);
|
|
59
|
+
|
|
60
|
+
const showTouchControls = isMobile() && isTouchscreenAvailable();
|
|
61
|
+
const touchControls = showTouchControls
|
|
62
|
+
? ctx.entities.add("touch-controls", new TouchControls(camera))
|
|
63
|
+
: undefined;
|
|
64
|
+
|
|
65
|
+
const gripper = new Gripper(ctx);
|
|
66
|
+
ctx.entities.add("player", gripper);
|
|
67
|
+
const ball = new Ball(ctx);
|
|
68
|
+
ctx.entities.add("ball", ball);
|
|
69
|
+
const pendulum = new Pendulum(ctx);
|
|
70
|
+
ctx.entities.add("pendulum", pendulum);
|
|
71
|
+
const crates = CRATE_SPAWNS.map((spawn, index) => {
|
|
72
|
+
const crate = new Crate(ctx, spawn, String(index));
|
|
73
|
+
ctx.entities.add(`crate.${index}`, crate);
|
|
74
|
+
return crate;
|
|
75
|
+
});
|
|
76
|
+
|
|
77
|
+
let held: Crate | undefined;
|
|
78
|
+
let cratesMoved = 0;
|
|
79
|
+
let elapsed = 0;
|
|
80
|
+
let status = INITIAL_STATE.status;
|
|
81
|
+
|
|
82
|
+
const nearest = (): Crate | undefined => {
|
|
83
|
+
let best: Crate | undefined;
|
|
84
|
+
let bestDistance = GRAB_RANGE * GRAB_RANGE;
|
|
85
|
+
for (const crate of crates) {
|
|
86
|
+
const distance = crate.mesh.position.distanceToSquared(gripper.mesh.position);
|
|
87
|
+
if (distance > bestDistance) continue;
|
|
88
|
+
best = crate;
|
|
89
|
+
bestDistance = distance;
|
|
90
|
+
}
|
|
91
|
+
return best;
|
|
92
|
+
};
|
|
93
|
+
const toggleGrab = (): void => {
|
|
94
|
+
if (held !== undefined) {
|
|
95
|
+
held.release();
|
|
96
|
+
held = undefined;
|
|
97
|
+
cratesMoved += 1;
|
|
98
|
+
return;
|
|
99
|
+
}
|
|
100
|
+
held = nearest();
|
|
101
|
+
held?.hold();
|
|
102
|
+
};
|
|
103
|
+
|
|
104
|
+
// The pointer is the other way in. `ctx.pointer` dispatches to the meshes the game
|
|
105
|
+
// registered, so a tap on a crate is a grab without a raycast written here.
|
|
106
|
+
for (const crate of crates) {
|
|
107
|
+
ctx.pointer?.on(crate.mesh, "tapped", () => {
|
|
108
|
+
if (held !== undefined) return;
|
|
109
|
+
held = crate;
|
|
110
|
+
crate.hold();
|
|
111
|
+
});
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
// The camera reads a body physics has already moved this frame, so it runs after the step
|
|
115
|
+
// rather than before it. Reading in the frame function instead is one step of lag, and on a
|
|
116
|
+
// swinging weight one step of lag is visible.
|
|
117
|
+
afterPhysics(ctx, (dt) => followGripper(camera, gripper.mesh.position, dt));
|
|
118
|
+
|
|
119
|
+
return (frameCtx, dt) => {
|
|
120
|
+
loading.update();
|
|
121
|
+
if (frameCtx.input.justPressed("restart")) {
|
|
122
|
+
frameCtx.state.set(INITIAL_STATE);
|
|
123
|
+
frameCtx.state.flush();
|
|
124
|
+
void frameCtx.goto("puzzle");
|
|
125
|
+
return;
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
const touch = touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size);
|
|
129
|
+
elapsed += dt;
|
|
130
|
+
gripper.update(frameCtx, dt, touch);
|
|
131
|
+
if (frameCtx.input.justPressed("grab") || touch?.grabPressed === true) toggleGrab();
|
|
132
|
+
if (frameCtx.input.justPressed("swing") || touch?.swingPressed === true) pendulum.swing();
|
|
133
|
+
held?.carry(gripper.mesh.position, dt);
|
|
134
|
+
if (ball.scored) status = "SOLVED";
|
|
135
|
+
// A ball that left the room is a level bug, not a loss: say so rather than waiting forever.
|
|
136
|
+
if (ball.mesh.position.y < FLOOR_FAIL_Y) ball.body.linearVelocity = { x: 0, y: 0, z: 0 };
|
|
137
|
+
|
|
138
|
+
const previous = frameCtx.state.getState();
|
|
139
|
+
const next: GameState = {
|
|
140
|
+
cratesMoved,
|
|
141
|
+
elapsed,
|
|
142
|
+
holding: held !== undefined,
|
|
143
|
+
paused: previous.paused,
|
|
144
|
+
status,
|
|
145
|
+
swings: pendulum.swings,
|
|
146
|
+
uiReady: previous.uiReady,
|
|
147
|
+
};
|
|
148
|
+
if (
|
|
149
|
+
next.cratesMoved !== previous.cratesMoved ||
|
|
150
|
+
next.holding !== previous.holding ||
|
|
151
|
+
next.status !== previous.status ||
|
|
152
|
+
next.swings !== previous.swings ||
|
|
153
|
+
Math.floor(next.elapsed) !== Math.floor(previous.elapsed)
|
|
154
|
+
)
|
|
155
|
+
frameCtx.state.set(next);
|
|
156
|
+
};
|
|
157
|
+
}
|
|
158
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
export type PuzzleStatus = "PLAYING" | "SOLVED";
|
|
2
|
+
|
|
3
|
+
/** How far the ball may drift below the floor before the run is treated as lost geometry. */
|
|
4
|
+
export const FLOOR_FAIL_Y = -6;
|
|
5
|
+
|
|
6
|
+
export type GameState = {
|
|
7
|
+
/** Set from the UI's pause and resume intents, and read back by the menu. */
|
|
8
|
+
paused: boolean;
|
|
9
|
+
/** True once the UI layer has rendered and published its interactive rectangles. */
|
|
10
|
+
uiReady: boolean;
|
|
11
|
+
/** How many crates the player has picked up and set down again. */
|
|
12
|
+
cratesMoved: number;
|
|
13
|
+
/** Seconds since the room opened. */
|
|
14
|
+
elapsed: number;
|
|
15
|
+
/** True while a crate is held by the pointer or by the grab key. */
|
|
16
|
+
holding: boolean;
|
|
17
|
+
/** How many times the hinged weight has been released. */
|
|
18
|
+
swings: number;
|
|
19
|
+
status: PuzzleStatus;
|
|
20
|
+
};
|
|
21
|
+
|
|
22
|
+
export const INITIAL_STATE: GameState = {
|
|
23
|
+
paused: false,
|
|
24
|
+
uiReady: false,
|
|
25
|
+
cratesMoved: 0,
|
|
26
|
+
elapsed: 0,
|
|
27
|
+
holding: false,
|
|
28
|
+
swings: 0,
|
|
29
|
+
status: "PLAYING",
|
|
30
|
+
};
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
@import "tailwindcss";
|
|
2
|
+
|
|
3
|
+
@source "../index.html";
|
|
4
|
+
@source "./";
|
|
5
|
+
|
|
6
|
+
@theme {
|
|
7
|
+
--color-ink: #07131d;
|
|
8
|
+
--color-panel: #0d2430;
|
|
9
|
+
--color-line: #1d4a58;
|
|
10
|
+
--color-lume: #f5c451;
|
|
11
|
+
--color-win: #79e0b2;
|
|
12
|
+
--color-danger: #ff7182;
|
|
13
|
+
--color-text: #c1dce2;
|
|
14
|
+
--color-muted: #6c9aa5;
|
|
15
|
+
--font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
html,
|
|
19
|
+
body,
|
|
20
|
+
#root {
|
|
21
|
+
width: 100%;
|
|
22
|
+
height: 100%;
|
|
23
|
+
margin: 0;
|
|
24
|
+
overflow: hidden;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
body {
|
|
28
|
+
color: var(--color-text);
|
|
29
|
+
font-family: var(--font-mono);
|
|
30
|
+
-webkit-font-smoothing: antialiased;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/*
|
|
34
|
+
* The page's backdrop belongs to the web document's own mount point, never to `body`.
|
|
35
|
+
* `src/ui/main.tsx` imports this same stylesheet, and on native that file is what the platform's
|
|
36
|
+
* transparent web view loads over the game: a `body` background there paints an opaque sheet over
|
|
37
|
+
* the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
|
|
38
|
+
* in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
|
|
39
|
+
*/
|
|
40
|
+
|
|
41
|
+
#root {
|
|
42
|
+
background: var(--color-ink);
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/* Boot failures are a page state, so the generated game owns their presentation. */
|
|
46
|
+
[data-threenative-canvas-error="true"] {
|
|
47
|
+
position: fixed;
|
|
48
|
+
inset: 0;
|
|
49
|
+
z-index: 1000;
|
|
50
|
+
display: grid;
|
|
51
|
+
place-items: center;
|
|
52
|
+
box-sizing: border-box;
|
|
53
|
+
padding: clamp(1.5rem, 8vw, 6rem);
|
|
54
|
+
overflow: auto;
|
|
55
|
+
background: #fff7ed;
|
|
56
|
+
color: var(--color-ink);
|
|
57
|
+
font-family: inherit;
|
|
58
|
+
font-size: clamp(1rem, 2vw, 1.5rem);
|
|
59
|
+
line-height: 1.5;
|
|
60
|
+
text-align: center;
|
|
61
|
+
white-space: pre-wrap;
|
|
62
|
+
overflow-wrap: anywhere;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/* The debug surface is framework plumbing; its default presentation is yours to change. */
|
|
66
|
+
[data-threenative-debug-overlay="true"] {
|
|
67
|
+
position: fixed;
|
|
68
|
+
top: 1rem;
|
|
69
|
+
right: 1rem;
|
|
70
|
+
z-index: 50;
|
|
71
|
+
max-width: 24rem;
|
|
72
|
+
padding: 0.75rem;
|
|
73
|
+
pointer-events: none;
|
|
74
|
+
background: rgb(2 6 23 / 90%);
|
|
75
|
+
box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
|
|
76
|
+
color: #cffafe;
|
|
77
|
+
font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
|
|
78
|
+
font-size: 12px;
|
|
79
|
+
line-height: 1.5;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
[data-threenative-debug-overlay="true"] table {
|
|
83
|
+
width: 100%;
|
|
84
|
+
table-layout: fixed;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
[data-threenative-debug-overlay="true"] th,
|
|
88
|
+
[data-threenative-debug-overlay="true"] td {
|
|
89
|
+
padding-right: 1rem;
|
|
90
|
+
text-align: left;
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
[data-threenative-debug-overlay="true"] td:last-child {
|
|
94
|
+
overflow-wrap: anywhere;
|
|
95
|
+
word-break: break-all;
|
|
96
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { IGame } from "@threenative/core";
|
|
2
|
+
import { DebugOverlay, GameCanvas } from "@threenative/ui";
|
|
3
|
+
import type { PuzzlePhysics } from "../physics.js";
|
|
4
|
+
import type { GameState } from "../state.js";
|
|
5
|
+
import { GameUi } from "./GameUi.js";
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* The web target's page: the canvas, then the same UI every other target renders.
|
|
9
|
+
*
|
|
10
|
+
* `GameCanvas` hosts the renderer and everything after it paints on top; keep the canvas first.
|
|
11
|
+
* The UI itself comes from `GameUi`, unchanged — this file exists only because the web build also
|
|
12
|
+
* has to put a canvas on the page.
|
|
13
|
+
*/
|
|
14
|
+
export function App({ game }: { game: IGame<GameState, PuzzlePhysics> }) {
|
|
15
|
+
return (
|
|
16
|
+
<main className="relative h-screen w-screen overflow-hidden bg-ink">
|
|
17
|
+
<GameCanvas className="absolute inset-0" game={game} />
|
|
18
|
+
<GameUi />
|
|
19
|
+
<DebugOverlay />
|
|
20
|
+
</main>
|
|
21
|
+
);
|
|
22
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { UiLayer } from "@threenative/ui";
|
|
2
|
+
import { Hud } from "./Hud.js";
|
|
3
|
+
import { Menu } from "./Menu.js";
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Everything the player sees that is not the scene.
|
|
7
|
+
*
|
|
8
|
+
* One component, mounted twice by two entries that differ only in what else is on the page:
|
|
9
|
+
* `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
|
|
10
|
+
* page the native web view loads. Keeping both entries pointed at this file is what makes "the
|
|
11
|
+
* same UI on every target" a fact rather than an intention.
|
|
12
|
+
*/
|
|
13
|
+
export function GameUi() {
|
|
14
|
+
return (
|
|
15
|
+
<UiLayer>
|
|
16
|
+
<Hud />
|
|
17
|
+
<Menu />
|
|
18
|
+
</UiLayer>
|
|
19
|
+
);
|
|
20
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { useUiState } from "@threenative/ui";
|
|
2
|
+
import type { GameState } from "../state.js";
|
|
3
|
+
|
|
4
|
+
export function Hud() {
|
|
5
|
+
const state = useUiState<GameState>();
|
|
6
|
+
// Nothing to draw until the game publishes its first snapshot, a few milliseconds in.
|
|
7
|
+
// Rendering zeroes instead would put wrong numbers on screen and then correct them.
|
|
8
|
+
if (state === undefined) return null;
|
|
9
|
+
const solved = state.status === "SOLVED";
|
|
10
|
+
return (
|
|
11
|
+
<div className="pointer-events-none absolute inset-0 p-6 text-[11px] uppercase tracking-[0.16em] text-text">
|
|
12
|
+
<div className="flex items-start justify-between">
|
|
13
|
+
<div>
|
|
14
|
+
<div className="text-[10px] text-muted">contraption room 01</div>
|
|
15
|
+
<div className="mt-2 flex items-baseline gap-5 text-[18px] text-white">
|
|
16
|
+
<span>
|
|
17
|
+
time <b id="elapsed">{Math.floor(state.elapsed)}</b>s
|
|
18
|
+
</span>
|
|
19
|
+
<span className={solved ? "text-win" : "text-lume"} id="status">
|
|
20
|
+
{state.status}
|
|
21
|
+
</span>
|
|
22
|
+
</div>
|
|
23
|
+
</div>
|
|
24
|
+
<div className="text-right">
|
|
25
|
+
<div className="text-[10px] text-muted">crates moved</div>
|
|
26
|
+
<div className="mt-2 text-[22px] text-white" id="crates">
|
|
27
|
+
{state.cratesMoved}
|
|
28
|
+
</div>
|
|
29
|
+
</div>
|
|
30
|
+
</div>
|
|
31
|
+
<div className="absolute bottom-6 left-6 flex items-end gap-8">
|
|
32
|
+
<div>
|
|
33
|
+
<div className="text-[10px] text-muted">swings</div>
|
|
34
|
+
<div className="mt-1 text-[26px] leading-none text-white" id="swings">
|
|
35
|
+
{state.swings}
|
|
36
|
+
</div>
|
|
37
|
+
</div>
|
|
38
|
+
<div>
|
|
39
|
+
<div className="text-[10px] text-muted">claw</div>
|
|
40
|
+
<div className="mt-1 text-[18px] leading-none text-white" id="holding">
|
|
41
|
+
{state.holding ? "holding" : "empty"}
|
|
42
|
+
</div>
|
|
43
|
+
</div>
|
|
44
|
+
<div className="text-[10px] leading-relaxed text-muted">
|
|
45
|
+
<div>wasd move · e grab · f swing</div>
|
|
46
|
+
<div>roll the ball into the ring</div>
|
|
47
|
+
</div>
|
|
48
|
+
</div>
|
|
49
|
+
{solved && (
|
|
50
|
+
<div className="absolute left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 border border-win/70 bg-win/10 px-8 py-5 text-center">
|
|
51
|
+
<div className="text-[28px] tracking-[0.28em] text-win">SOLVED</div>
|
|
52
|
+
<div className="mt-2 text-[10px] text-muted">press R to reset the room</div>
|
|
53
|
+
</div>
|
|
54
|
+
)}
|
|
55
|
+
</div>
|
|
56
|
+
);
|
|
57
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { createRoot } from "react-dom/client";
|
|
2
|
+
import { GameUi } from "./GameUi.js";
|
|
3
|
+
import "../style.css";
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* The UI entry the native web view loads.
|
|
7
|
+
*
|
|
8
|
+
* It mounts the UI and nothing else — no scene, no simulation, no renderer. The game runs beside
|
|
9
|
+
* it in the native runtime and reaches it only through published state and intents, which is why
|
|
10
|
+
* this file imports no game code at all.
|
|
11
|
+
*/
|
|
12
|
+
const root = document.getElementById("tn-ui");
|
|
13
|
+
if (root === null) throw new Error("Missing #tn-ui element.");
|
|
14
|
+
createRoot(root).render(<GameUi />);
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export default {};
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import type { IThreeNativeConfig } from "@threenative/core";
|
|
2
|
+
|
|
3
|
+
const config: IThreeNativeConfig = {
|
|
4
|
+
app: {
|
|
5
|
+
id: "com.threenative.__PROJECT_ID__",
|
|
6
|
+
name: "__PROJECT_NAME__",
|
|
7
|
+
version: "1.0.0",
|
|
8
|
+
build: 1,
|
|
9
|
+
icon: "public/icon.png",
|
|
10
|
+
icons: { web: { favicon: "public/favicon.svg" } },
|
|
11
|
+
},
|
|
12
|
+
display: {
|
|
13
|
+
orientation: "landscape",
|
|
14
|
+
fullscreen: true,
|
|
15
|
+
keepScreenOn: true,
|
|
16
|
+
maxFps: 60,
|
|
17
|
+
},
|
|
18
|
+
window: {
|
|
19
|
+
title: "__PROJECT_NAME__",
|
|
20
|
+
width: 1280,
|
|
21
|
+
height: 720,
|
|
22
|
+
maximized: false,
|
|
23
|
+
resizable: true,
|
|
24
|
+
},
|
|
25
|
+
bootSplash: {
|
|
26
|
+
backgroundColor: "#07131d",
|
|
27
|
+
},
|
|
28
|
+
nativeEntry: "src/game.ts",
|
|
29
|
+
renderer: {
|
|
30
|
+
preferWebGPU: true, // Use WebGPU when the host exposes it.
|
|
31
|
+
// The engine holds the `display.maxFps` budget by scaling the 3D drawing buffer, and reports
|
|
32
|
+
// the scale it settled on in every `TN_FRAME_BUDGET` window. Replace with a number in (0, 1]
|
|
33
|
+
// to pin it — the loop stops and the reporting does not. CSS, UI and camera framing never move.
|
|
34
|
+
resolutionScale: "auto",
|
|
35
|
+
// Multisampling resolves triangle edges. A cutout silhouette — foliage, a fence, hair — is
|
|
36
|
+
// carved inside the triangle by an alpha test, so it resolves through the coverage mask or
|
|
37
|
+
// not at all, which is what this spends the samples above on. It costs no target and no
|
|
38
|
+
// extra pass; set it false for a deliberately hard-edged look. `TN_ALPHA_ANTIALIASING`
|
|
39
|
+
// reports what it did, and says so when a single-sampled surface leaves it nothing to do.
|
|
40
|
+
alphaAntialiasing: true,
|
|
41
|
+
},
|
|
42
|
+
// One UI on every target: src/ui/ renders through the platform's own browser-class renderer,
|
|
43
|
+
// so the same React, Tailwind, CSS and SVG run on web, desktop, Android and iOS alike.
|
|
44
|
+
// Switch to "native" for a UI drawn as part of the rendered frame, with no web view and no
|
|
45
|
+
// extra process — and own the appearance difference that comes with it.
|
|
46
|
+
ui: { renderer: "web" },
|
|
47
|
+
};
|
|
48
|
+
|
|
49
|
+
export default config;
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"compilerOptions": {
|
|
3
|
+
"target": "ES2022",
|
|
4
|
+
"lib": ["ES2022", "DOM", "DOM.Iterable"],
|
|
5
|
+
"module": "ESNext",
|
|
6
|
+
"moduleResolution": "bundler",
|
|
7
|
+
"jsx": "react-jsx",
|
|
8
|
+
"types": ["vite/client"],
|
|
9
|
+
"strict": true,
|
|
10
|
+
"noUncheckedIndexedAccess": true,
|
|
11
|
+
"noEmit": true,
|
|
12
|
+
"skipLibCheck": true,
|
|
13
|
+
"verbatimModuleSyntax": true,
|
|
14
|
+
"isolatedModules": true
|
|
15
|
+
},
|
|
16
|
+
"include": ["src/**/*.ts", "src/**/*.tsx", "*.ts"]
|
|
17
|
+
}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import tailwindcss from "@tailwindcss/vite";
|
|
2
|
+
import { watchAssets } from "@threenative/assets";
|
|
3
|
+
import react from "@vitejs/plugin-react";
|
|
4
|
+
import { createEngineFreshnessPlugin, createWebBrandPlugin } from "create-threenative";
|
|
5
|
+
import { defineConfig } from "vite";
|
|
6
|
+
import type { Plugin } from "vite";
|
|
7
|
+
import config from "./threenative.config.js";
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Recompiles assets/ into public/ while the dev server runs, so editing a texture does not
|
|
11
|
+
* need a rebuild. Serve-only by declaration: builds compile through `threenative build`.
|
|
12
|
+
*/
|
|
13
|
+
function assetsWatchPlugin(): Plugin {
|
|
14
|
+
return {
|
|
15
|
+
name: "threenative-assets-watch",
|
|
16
|
+
apply: "serve",
|
|
17
|
+
configureServer(server) {
|
|
18
|
+
const handle = watchAssets({ config: config.assets, cwd: server.config.root });
|
|
19
|
+
server.httpServer?.once("close", () => handle.close());
|
|
20
|
+
},
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export default defineConfig({
|
|
25
|
+
plugins: [
|
|
26
|
+
createEngineFreshnessPlugin(),
|
|
27
|
+
createWebBrandPlugin(),
|
|
28
|
+
react(),
|
|
29
|
+
tailwindcss(),
|
|
30
|
+
assetsWatchPlugin(),
|
|
31
|
+
],
|
|
32
|
+
server: {
|
|
33
|
+
watch: {
|
|
34
|
+
ignored: ["**/artifacts/**", "**/screenshots/**", "**/playtests/**"],
|
|
35
|
+
usePolling: true,
|
|
36
|
+
},
|
|
37
|
+
},
|
|
38
|
+
});
|
|
@@ -13,3 +13,7 @@ args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
|
|
|
13
13
|
[mcp_servers.threenative-engine]
|
|
14
14
|
command = "node"
|
|
15
15
|
args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
|
|
16
|
+
|
|
17
|
+
[mcp_servers.threenative-blender]
|
|
18
|
+
command = "node"
|
|
19
|
+
args = ["./node_modules/@threenative/core/mcp/blender.mjs"]
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
{
|
|
2
|
+
"mcpServers": {
|
|
3
|
+
"threenative-assets": {
|
|
4
|
+
"command": "node",
|
|
5
|
+
"args": [
|
|
6
|
+
"./node_modules/@threenative/core/mcp/assets.mjs"
|
|
7
|
+
],
|
|
8
|
+
"env": {
|
|
9
|
+
"ASSET_DOWNLOAD_DIR": "./public/assets",
|
|
10
|
+
"AUDIO_DOWNLOAD_DIR": "./public/audio"
|
|
11
|
+
}
|
|
12
|
+
},
|
|
13
|
+
"threenative-sculpt": {
|
|
14
|
+
"command": "node",
|
|
15
|
+
"args": [
|
|
16
|
+
"./node_modules/@threenative/core/mcp/sculpt.mjs"
|
|
17
|
+
]
|
|
18
|
+
},
|
|
19
|
+
"threenative-engine": {
|
|
20
|
+
"command": "node",
|
|
21
|
+
"args": [
|
|
22
|
+
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
23
|
+
]
|
|
24
|
+
},
|
|
25
|
+
"threenative-blender": {
|
|
26
|
+
"command": "node",
|
|
27
|
+
"args": [
|
|
28
|
+
"./node_modules/@threenative/core/mcp/blender.mjs"
|
|
29
|
+
]
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
}
|