create-threenative 0.2.2 → 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/LICENSE +21 -0
- package/README.md +61 -2
- package/agent-docs/references/assertion-reference.md +819 -0
- package/agent-docs/references/capability-reference.md +4483 -0
- package/agent-docs/references/capture-the-frame.md +60 -0
- package/agent-docs/references/creating-creatures.md +215 -0
- package/agent-docs/references/ctx-cookbook.md +120 -0
- package/agent-docs/references/debug-surface.md +68 -0
- package/agent-docs/references/dream-loop.md +150 -0
- package/agent-docs/references/finding-assets.md +215 -0
- package/agent-docs/references/gameplay-recipes.md +54 -0
- package/agent-docs/references/menu-screens.md +69 -0
- package/agent-docs/references/mobile-memory-budget.md +87 -0
- package/agent-docs/references/sculpt-from-a-reference.md +40 -0
- package/agent-docs/references/trace-a-slow-frame.md +99 -0
- package/agent-docs/references/visual-baseline.md +174 -0
- package/agent-docs/references/webview-ui.md +113 -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 +7 -0
- 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 +7 -0
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
- package/agent-files/.claude/agents/threenative-builder.md +7 -0
- package/agent-files/.claude/agents/threenative-verifier.md +7 -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/.threenative/agents/builder.md +32 -0
- package/agent-files/.threenative/agents/verifier.md +31 -0
- package/agent-files/AGENT-ROLES.md +26 -0
- package/agent-files/scripts/reference.mjs +705 -0
- package/agent-files/scripts/visual-loop.mjs +382 -0
- package/capabilities.json +5292 -0
- package/dist/index.d.ts +224 -3
- package/dist/index.js +1972 -73
- package/dist/threenative.d.ts +9 -2
- package/dist/threenative.js +2570 -176
- package/package.json +55 -6
- package/template-assets/icon.png +0 -0
- package/template-assets/loading.ts +325 -0
- package/template-assets/patches/three@0.185.1.patch +522 -0
- package/template-assets/worldEnvironment.ts +758 -0
- package/templates/action-rpg/.codex/config.toml +19 -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 +18 -2
- package/templates/action-rpg/.vscode/mcp.json +36 -0
- package/templates/action-rpg/.zed/settings.json +36 -0
- package/templates/action-rpg/AGENTS.md +84 -29
- package/templates/action-rpg/CLAUDE.md +84 -29
- package/templates/action-rpg/index.html +0 -1
- package/templates/action-rpg/opencode.json +41 -0
- package/templates/action-rpg/package.json +15 -11
- package/templates/action-rpg/playtests/combat.playtest.json +32 -9
- package/templates/action-rpg/playtests/fail.playtest.json +3 -3
- package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
- package/templates/action-rpg/playtests/performance.playtest.json +39 -0
- package/templates/action-rpg/playtests/progress.playtest.json +18 -13
- 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/playtests/win.playtest.json +10 -4
- package/templates/action-rpg/src/conventions.ts +35 -0
- package/templates/action-rpg/src/entities/Enemy.ts +16 -7
- package/templates/action-rpg/src/entities/Player.ts +20 -3
- package/templates/action-rpg/src/game.ts +21 -0
- package/templates/action-rpg/src/render/camera.ts +7 -2
- package/templates/action-rpg/src/render/lighting.ts +11 -4
- package/templates/action-rpg/src/render/loading.ts +278 -43
- 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 +32 -16
- 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 +758 -0
- package/templates/action-rpg/src/scenes/Play.ts +91 -24
- package/templates/action-rpg/src/state.ts +4 -0
- package/templates/action-rpg/src/style.css +65 -1
- package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
- package/templates/action-rpg/src/ui/App.tsx +9 -8
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
- package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
- package/templates/action-rpg/src/ui/Hud.tsx +10 -8
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
- package/templates/action-rpg/src/ui/main.tsx +14 -0
- package/templates/action-rpg/threenative.config.ts +28 -8
- package/templates/action-rpg/vite.config.ts +32 -2
- package/templates/defense/.codex/config.toml +19 -0
- package/templates/defense/.cursor/mcp.json +32 -0
- package/templates/defense/.gemini/settings.json +32 -0
- package/templates/defense/.mcp.json +18 -2
- package/templates/defense/.vscode/mcp.json +36 -0
- package/templates/defense/.zed/settings.json +36 -0
- package/templates/defense/AGENTS.md +81 -41
- package/templates/defense/CLAUDE.md +81 -41
- package/templates/defense/README.md +2 -1
- package/templates/defense/index.html +0 -1
- package/templates/defense/opencode.json +41 -0
- package/templates/defense/package.json +16 -12
- package/templates/defense/playtests/leak.playtest.json +9 -4
- package/templates/defense/playtests/performance.playtest.json +39 -0
- package/templates/defense/playtests/placement.playtest.json +5 -5
- package/templates/defense/playtests/pointer-placement.playtest.json +156 -0
- package/templates/defense/playtests/scan.playtest.json +4 -4
- package/templates/defense/playtests/survive.playtest.json +25 -6
- package/templates/defense/src/attackers/Attacker.ts +32 -16
- 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 +25 -4
- 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/lighting.ts +6 -1
- package/templates/defense/src/render/loading.ts +274 -38
- 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 +32 -12
- package/templates/defense/src/render/quality.ts +170 -0
- package/templates/defense/src/render/shapes.ts +180 -23
- package/templates/defense/src/render/sky.ts +2 -2
- package/templates/defense/src/render/worldEnvironment.ts +758 -0
- package/templates/defense/src/scenes/Boot.ts +2 -2
- package/templates/defense/src/scenes/Defense.ts +122 -56
- package/templates/defense/src/state.ts +6 -0
- package/templates/defense/src/style.css +65 -1
- 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 +11 -6
- package/templates/defense/src/ui/GameUi.tsx +20 -0
- package/templates/defense/src/ui/Hud.tsx +6 -5
- package/templates/defense/src/ui/main.tsx +14 -0
- package/templates/defense/threenative.config.ts +28 -8
- package/templates/defense/vite.config.ts +34 -1
- package/templates/minimal/.codex/config.toml +19 -0
- package/templates/minimal/.cursor/mcp.json +32 -0
- package/templates/minimal/.gemini/settings.json +32 -0
- package/templates/minimal/.mcp.json +18 -2
- package/templates/minimal/.vscode/mcp.json +36 -0
- package/templates/minimal/.zed/settings.json +36 -0
- package/templates/minimal/AGENTS.md +78 -382
- package/templates/minimal/CLAUDE.md +78 -382
- package/templates/minimal/index.html +0 -1
- package/templates/minimal/opencode.json +41 -0
- package/templates/minimal/package.json +14 -11
- package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
- package/templates/minimal/playtests/play.playtest.json +18 -5
- 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/game.ts +1 -0
- package/templates/minimal/src/main.ts +14 -4
- package/templates/minimal/src/render/camera.ts +1 -1
- package/templates/minimal/src/render/hud.ts +24 -8
- package/templates/minimal/src/render/lighting.ts +23 -2
- package/templates/minimal/src/render/loading.ts +23 -103
- 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 +55 -16
- package/templates/minimal/src/render/quality.ts +162 -0
- package/templates/minimal/src/render/sky.ts +51 -32
- package/templates/minimal/src/render/touch-controls.ts +165 -0
- package/templates/minimal/src/render/worldEnvironment.ts +758 -0
- package/templates/minimal/src/scenes/Play.ts +128 -14
- package/templates/minimal/src/state.ts +8 -1
- package/templates/minimal/src/style.css +20 -0
- package/templates/minimal/threenative.config.ts +22 -10
- package/templates/minimal/vite.config.ts +28 -1
- package/templates/platformer/.codex/config.toml +19 -0
- package/templates/platformer/.cursor/mcp.json +32 -0
- package/templates/platformer/.gemini/settings.json +32 -0
- package/templates/platformer/.mcp.json +18 -2
- package/templates/platformer/.vscode/mcp.json +36 -0
- package/templates/platformer/.zed/settings.json +36 -0
- package/templates/platformer/AGENTS.md +81 -186
- package/templates/platformer/CLAUDE.md +81 -186
- package/templates/platformer/index.html +0 -1
- package/templates/platformer/opencode.json +41 -0
- package/templates/platformer/package.json +17 -14
- package/templates/platformer/playtests/avoidance.playtest.json +6 -1
- package/templates/platformer/playtests/branding.playtest.json +29 -0
- package/templates/platformer/playtests/buffer.playtest.json +1 -1
- package/templates/platformer/playtests/collect.playtest.json +1 -1
- package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
- package/templates/platformer/playtests/coyote.playtest.json +42 -8
- package/templates/platformer/playtests/damage.playtest.json +4 -1
- package/templates/platformer/playtests/dash.playtest.json +2 -2
- package/templates/platformer/playtests/jump.playtest.json +2 -3
- package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
- package/templates/platformer/playtests/oneway.playtest.json +30 -3
- package/templates/platformer/playtests/performance.playtest.json +7 -5
- package/templates/platformer/playtests/respawn.playtest.json +2 -2
- package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
- package/templates/platformer/playtests/stomp.playtest.json +11 -3
- package/templates/platformer/playtests/survives.playtest.json +31 -0
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +16 -4
- package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
- package/templates/platformer/playtests/touch-controls-web.playtest.json +57 -0
- package/templates/platformer/src/conventions.ts +18 -0
- package/templates/platformer/src/entities/Character.ts +79 -11
- package/templates/platformer/src/entities/Patrol.ts +5 -0
- package/templates/platformer/src/game.ts +27 -2
- package/templates/platformer/src/level/Platform.ts +13 -1
- package/templates/platformer/src/render/lighting.ts +13 -5
- package/templates/platformer/src/render/loading.ts +281 -62
- package/templates/platformer/src/render/palette.ts +4 -1
- package/templates/platformer/src/render/postprocessing.ts +42 -14
- package/templates/platformer/src/render/quality.ts +170 -0
- package/templates/platformer/src/render/touch-controls.ts +54 -36
- package/templates/platformer/src/render/worldEnvironment.ts +758 -0
- package/templates/platformer/src/scenes/Level.ts +97 -32
- package/templates/platformer/src/state.ts +4 -0
- package/templates/platformer/src/style.css +65 -1
- package/templates/platformer/src/ui/App.tsx +9 -4
- package/templates/platformer/src/ui/GameUi.tsx +20 -0
- package/templates/platformer/src/ui/Hud.tsx +6 -5
- package/templates/platformer/src/ui/main.tsx +14 -0
- package/templates/platformer/threenative.config.ts +27 -10
- package/templates/platformer/vite.config.ts +34 -1
- 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 +19 -0
- package/templates/racing/.cursor/mcp.json +32 -0
- package/templates/racing/.gemini/settings.json +32 -0
- package/templates/racing/.mcp.json +18 -2
- package/templates/racing/.vscode/mcp.json +36 -0
- package/templates/racing/.zed/settings.json +36 -0
- package/templates/racing/AGENTS.md +84 -36
- package/templates/racing/CLAUDE.md +84 -36
- package/templates/racing/index.html +0 -1
- package/templates/racing/native-playtests/survives.playtest.json +43 -0
- package/templates/racing/opencode.json +41 -0
- package/templates/racing/package.json +17 -12
- package/templates/racing/playtests/boost.playtest.json +5 -5
- package/templates/racing/playtests/outcome.playtest.json +14 -4
- package/templates/racing/playtests/performance.playtest.json +39 -0
- package/templates/racing/playtests/ranking.playtest.json +2 -2
- package/templates/racing/playtests/rescue.playtest.json +12 -6
- package/templates/racing/playtests/reverse.playtest.json +3 -3
- package/templates/racing/playtests/shortcut.playtest.json +3 -3
- 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/game.ts +24 -1
- package/templates/racing/src/render/camera.ts +15 -8
- package/templates/racing/src/render/lighting.ts +28 -14
- package/templates/racing/src/render/loading.ts +302 -35
- 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 +32 -12
- 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 +758 -0
- package/templates/racing/src/scenes/Race.ts +84 -37
- package/templates/racing/src/state.ts +4 -0
- package/templates/racing/src/style.css +65 -1
- package/templates/racing/src/track/Lap.ts +20 -9
- package/templates/racing/src/track/Ranking.ts +53 -14
- package/templates/racing/src/track/Track.ts +284 -32
- package/templates/racing/src/track/TrackSector.ts +14 -4
- package/templates/racing/src/ui/App.tsx +9 -4
- package/templates/racing/src/ui/GameUi.tsx +20 -0
- package/templates/racing/src/ui/Hud.tsx +6 -5
- package/templates/racing/src/ui/main.tsx +14 -0
- package/templates/racing/threenative.config.ts +28 -8
- package/templates/racing/vite.config.ts +34 -1
- 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 +19 -0
- package/templates/sailing/.cursor/mcp.json +32 -0
- package/templates/sailing/.gemini/settings.json +32 -0
- package/templates/sailing/.mcp.json +32 -0
- package/templates/sailing/.vscode/mcp.json +36 -0
- package/templates/sailing/.zed/settings.json +36 -0
- package/templates/sailing/AGENTS.md +95 -0
- package/templates/sailing/CLAUDE.md +97 -0
- package/templates/sailing/README.md +28 -0
- package/templates/sailing/index.html +12 -0
- package/templates/sailing/kit.json +7 -0
- package/templates/sailing/native-playtests/float.playtest.json +55 -0
- package/templates/sailing/native-playtests/survives.playtest.json +38 -0
- package/templates/sailing/opencode.json +41 -0
- package/templates/sailing/package.json +52 -0
- package/templates/sailing/playtests/fail.playtest.json +24 -0
- 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 +36 -0
- package/templates/sailing/playtests/survives.playtest.json +46 -0
- package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
- package/templates/sailing/playtests/win.playtest.json +31 -0
- package/templates/sailing/public/favicon.svg +5 -0
- package/templates/sailing/src/conventions.ts +8 -0
- package/templates/sailing/src/entities/Ship.ts +233 -0
- package/templates/sailing/src/game.ts +40 -0
- package/templates/sailing/src/main.ts +15 -0
- package/templates/sailing/src/render/camera.ts +28 -0
- package/templates/sailing/src/render/lighting.ts +41 -0
- package/templates/sailing/src/render/loading.ts +325 -0
- package/templates/sailing/src/render/materials.ts +44 -0
- package/templates/sailing/src/render/ocean.ts +179 -0
- package/templates/sailing/src/render/palette.ts +17 -0
- package/templates/sailing/src/render/postprocessing.ts +34 -0
- package/templates/sailing/src/render/props.ts +602 -0
- package/templates/sailing/src/render/quality.ts +140 -0
- package/templates/sailing/src/render/sky.ts +37 -0
- package/templates/sailing/src/render/touch-controls.ts +142 -0
- package/templates/sailing/src/render/worldEnvironment.ts +758 -0
- package/templates/sailing/src/scenes/Boot.ts +12 -0
- package/templates/sailing/src/scenes/Sailing.ts +133 -0
- package/templates/sailing/src/state.ts +10 -0
- package/templates/sailing/src/style.css +81 -0
- package/templates/sailing/src/ui/App.tsx +15 -0
- package/templates/sailing/src/ui/GameUi.tsx +12 -0
- package/templates/sailing/src/ui/Hud.tsx +55 -0
- package/templates/sailing/src/ui/Menu.tsx +30 -0
- package/templates/sailing/src/ui/main.tsx +7 -0
- package/templates/sailing/tailwind.config.ts +2 -0
- package/templates/sailing/threenative.config.ts +40 -0
- package/templates/sailing/tsconfig.json +17 -0
- package/templates/sailing/vite.config.ts +34 -0
- package/templates/shooter/.codex/config.toml +19 -0
- package/templates/shooter/.cursor/mcp.json +32 -0
- package/templates/shooter/.gemini/settings.json +32 -0
- package/templates/shooter/.mcp.json +18 -2
- package/templates/shooter/.vscode/mcp.json +36 -0
- package/templates/shooter/.zed/settings.json +36 -0
- package/templates/shooter/AGENTS.md +81 -54
- package/templates/shooter/CLAUDE.md +81 -54
- package/templates/shooter/index.html +0 -1
- package/templates/shooter/kit.json +2 -2
- package/templates/shooter/opencode.json +41 -0
- package/templates/shooter/package.json +16 -11
- package/templates/shooter/playtests/combat.playtest.json +48 -0
- package/templates/shooter/playtests/fail.playtest.json +5 -4
- package/templates/shooter/playtests/input-control.playtest.json +261 -0
- package/templates/shooter/playtests/per-item.playtest.json +59 -0
- package/templates/shooter/playtests/performance.playtest.json +39 -0
- package/templates/shooter/playtests/shooter.playtest.json +31 -21
- package/templates/shooter/playtests/survives.playtest.json +28 -1
- package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
- package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
- package/templates/shooter/public/favicon.svg +1 -1
- 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 +35 -3
- package/templates/shooter/src/main.ts +3 -13
- package/templates/shooter/src/render/camera.ts +78 -18
- package/templates/shooter/src/render/decals.ts +211 -0
- package/templates/shooter/src/render/lighting.ts +13 -4
- package/templates/shooter/src/render/loading.ts +274 -35
- 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 +32 -17
- 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 +519 -60
- 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 +119 -1
- 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 +758 -0
- package/templates/shooter/src/scenes/Play.ts +385 -97
- package/templates/shooter/src/state.ts +18 -0
- package/templates/shooter/src/style.css +46 -0
- package/templates/shooter/src/ui/App.tsx +10 -12
- package/templates/shooter/src/ui/Crosshair.tsx +25 -0
- package/templates/shooter/src/ui/GameUi.tsx +22 -0
- package/templates/shooter/src/ui/Hud.tsx +14 -10
- package/templates/shooter/src/ui/Menu.tsx +24 -9
- package/templates/shooter/src/ui/main.tsx +15 -0
- package/templates/shooter/src/weapons/Hitscan.ts +3 -4
- package/templates/shooter/src/weapons/Projectile.ts +29 -13
- package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
- package/templates/shooter/threenative.config.ts +28 -8
- package/templates/shooter/vite.config.ts +32 -2
- package/templates/starter/.codex/config.toml +19 -0
- package/templates/starter/.cursor/mcp.json +32 -0
- package/templates/starter/.gemini/settings.json +32 -0
- package/templates/starter/.mcp.json +18 -2
- package/templates/starter/.vscode/mcp.json +36 -0
- package/templates/starter/.zed/settings.json +36 -0
- package/templates/starter/AGENTS.md +72 -426
- package/templates/starter/CLAUDE.md +72 -426
- package/templates/starter/assets/pickup.wav +0 -0
- package/templates/starter/gitignore +4 -0
- package/templates/starter/index.html +0 -1
- package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +81 -0
- package/templates/starter/opencode.json +41 -0
- package/templates/starter/package.json +16 -12
- package/templates/starter/playtests/assets.playtest.json +65 -0
- package/templates/starter/playtests/boot-failure.playtest.json +45 -0
- package/templates/starter/playtests/buffer.playtest.json +59 -9
- package/templates/starter/playtests/cloth.playtest.json +113 -0
- package/templates/starter/playtests/coyote.playtest.json +60 -8
- package/templates/starter/playtests/forward.playtest.json +29 -4
- package/templates/starter/playtests/gameover.playtest.json +66 -0
- package/templates/starter/playtests/goal.playtest.json +67 -0
- package/templates/starter/playtests/hot-reload.playtest.json +48 -8
- package/templates/starter/playtests/look.playtest.json +142 -10
- package/templates/starter/playtests/models-baseline.png +0 -0
- package/templates/starter/playtests/models.playtest.json +74 -0
- package/templates/starter/playtests/monitoring.playtest.json +38 -7
- package/templates/starter/playtests/odometer.playtest.json +54 -0
- package/templates/starter/playtests/pause.playtest.json +27 -4
- package/templates/starter/playtests/play.playtest.json +44 -7
- package/templates/starter/playtests/respawn.playtest.json +46 -6
- package/templates/starter/playtests/restart.playtest.json +65 -10
- package/templates/starter/playtests/seed.playtest.json +44 -8
- package/templates/starter/playtests/survives.playtest.json +48 -4
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +74 -0
- package/templates/starter/playtests/touch-controls.playtest.json +42 -0
- package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
- package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
- package/templates/starter/src/conventions.ts +18 -0
- package/templates/starter/src/entities/Goal.ts +137 -0
- package/templates/starter/src/entities/Player.ts +111 -10
- package/templates/starter/src/game.ts +27 -0
- package/templates/starter/src/render/adaptiveQuality.ts +195 -0
- package/templates/starter/src/render/camera.ts +31 -5
- package/templates/starter/src/render/coast.ts +199 -0
- package/templates/starter/src/render/easing.ts +5 -0
- package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
- package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
- package/templates/starter/src/render/effects/sparkle.ts +49 -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 +10 -5
- package/templates/starter/src/render/loading.ts +325 -0
- package/templates/starter/src/render/materials.ts +39 -4
- 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/pennant.ts +54 -0
- package/templates/starter/src/render/postprocessing.ts +97 -15
- 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 +40 -0
- package/templates/starter/src/render/shapes.ts +9 -21
- 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 +758 -0
- package/templates/starter/src/scenes/Play.ts +243 -46
- package/templates/starter/src/state.ts +12 -0
- package/templates/starter/src/style.css +72 -8
- package/templates/starter/src/ui/App.tsx +9 -6
- package/templates/starter/src/ui/GameUi.tsx +20 -0
- package/templates/starter/src/ui/Hud.tsx +52 -29
- package/templates/starter/src/ui/Menu.tsx +25 -23
- package/templates/starter/src/ui/main.tsx +14 -0
- package/templates/starter/threenative.config.ts +27 -9
- package/templates/starter/tools/look.mjs +109 -0
- package/templates/starter/vite.config.ts +32 -2
- package/templates/action-rpg/src/physics.ts +0 -40
- package/templates/minimal/assets/.gitkeep +0 -0
- package/templates/minimal/public/.gitkeep +0 -0
- package/templates/minimal/public/icon.png +0 -0
- package/templates/platformer/assets/.gitkeep +0 -0
- package/templates/platformer/public/.gitkeep +0 -0
- package/templates/platformer/public/icon.png +0 -0
- package/templates/shooter/src/physics.ts +0 -49
- package/templates/starter/assets/.gitkeep +0 -0
- package/templates/starter/public/.gitkeep +0 -0
- package/templates/starter/public/icon.png +0 -0
- package/templates/starter/public/pickup.ogg +0 -0
- /package/templates/starter/{public → assets}/native-proof.glb +0 -0
- /package/templates/starter/{public → assets}/native-proof.png +0 -0
|
@@ -1,13 +1,19 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import {
|
|
2
|
+
type ICtx,
|
|
3
|
+
Scene,
|
|
4
|
+
type SceneFrame,
|
|
5
|
+
isMobile,
|
|
6
|
+
isTouchscreenAvailable,
|
|
7
|
+
} from "@threenative/core";
|
|
2
8
|
import { CollisionShape3D, RigidBody3D } from "@threenative/physics";
|
|
3
9
|
import type { IPhysicsContext } from "@threenative/physics";
|
|
4
|
-
import { BoxGeometry, Mesh, type PerspectiveCamera, Vector3 } from "three";
|
|
10
|
+
import { BoxGeometry, Group, Mesh, type PerspectiveCamera, Vector3 } from "three";
|
|
5
11
|
import { Character, PLATFORMER_FEEL } from "../entities/Character.js";
|
|
6
12
|
import { Chaser } from "../entities/Chaser.js";
|
|
7
13
|
import { Patrol } from "../entities/Patrol.js";
|
|
8
14
|
import { Pickup, coinArc } from "../entities/Pickup.js";
|
|
9
15
|
import { Checkpoints } from "../level/Checkpoints.js";
|
|
10
|
-
import { createPlatform } from "../level/Platform.js";
|
|
16
|
+
import { type IPlatform, createPlatform } from "../level/Platform.js";
|
|
11
17
|
import { emitPlaytestEvent } from "../playtest-events.js";
|
|
12
18
|
import { setupCamera } from "../render/camera.js";
|
|
13
19
|
import { setupLighting } from "../render/lighting.js";
|
|
@@ -20,10 +26,14 @@ import { TouchControls } from "../render/touch-controls.js";
|
|
|
20
26
|
import { type GameState, TERMINAL, type TerminalState } from "../state.js";
|
|
21
27
|
export type GameCtx = ICtx<GameState, IPhysicsContext>;
|
|
22
28
|
const SPAWN = new Vector3(0, 0.75, 0);
|
|
29
|
+
const PATROL_FROM = new Vector3(5.2, 0.66, 0);
|
|
30
|
+
const PATROL_TO = new Vector3(7.4, 0.66, 0);
|
|
23
31
|
const KILL_PLANE = -8;
|
|
24
32
|
const GOAL_X = 21.5;
|
|
25
33
|
export class Level extends Scene<GameState, IPhysicsContext> {
|
|
26
34
|
static override readonly initialState = {
|
|
35
|
+
paused: false,
|
|
36
|
+
uiReady: false,
|
|
27
37
|
checkpoint: 0,
|
|
28
38
|
coins: 0,
|
|
29
39
|
coyoteJumps: 0,
|
|
@@ -38,20 +48,45 @@ export class Level extends Scene<GameState, IPhysicsContext> {
|
|
|
38
48
|
terminal: TERMINAL.playing,
|
|
39
49
|
topSpeed: 0,
|
|
40
50
|
};
|
|
51
|
+
|
|
52
|
+
override load(ctx: GameCtx): void {
|
|
53
|
+
// A runner applies setup after load() but before enter(). Keep a transform-bearing placeholder
|
|
54
|
+
// for the patrol so a setup can position/freeze it before Patrol creates its authoritative
|
|
55
|
+
// trigger in enter(). The placeholder is never rendered or stepped.
|
|
56
|
+
const patrol = new Group();
|
|
57
|
+
patrol.position.copy(PATROL_FROM);
|
|
58
|
+
ctx.entities.add("patrol", patrol);
|
|
59
|
+
}
|
|
60
|
+
|
|
41
61
|
override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
|
|
42
62
|
setupSky(ctx.scene);
|
|
43
|
-
setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
|
|
44
|
-
|
|
63
|
+
const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
|
|
64
|
+
// isMobile() arrives as an argument because src/render/ imports no framework package: the
|
|
65
|
+
// platform decision is made here, in portable game code, exactly like createRandom.
|
|
66
|
+
setupPost(ctx.renderer, ctx.scene, ctx.camera, { godraysLight: sun, mobile: isMobile() });
|
|
45
67
|
const camera = ctx.camera as PerspectiveCamera;
|
|
46
68
|
setupCamera(camera);
|
|
47
69
|
const loading = createLoadingScreen(ctx);
|
|
48
70
|
ctx.add(camera);
|
|
49
|
-
const
|
|
71
|
+
const showTouchControls = isMobile() && isTouchscreenAvailable();
|
|
72
|
+
const touchControls = showTouchControls
|
|
73
|
+
? ctx.entities.add("touch-controls", new TouchControls(camera))
|
|
74
|
+
: undefined;
|
|
50
75
|
ctx.viewport.resize();
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
76
|
+
const platforms: IPlatform[] = [
|
|
77
|
+
createPlatform(ctx, new Vector3(0, 0, 0), 18, { depth: 7, seed: 3 }),
|
|
78
|
+
createPlatform(ctx, new Vector3(14, 0, 0), 10, { depth: 7, seed: 7 }),
|
|
79
|
+
createPlatform(ctx, new Vector3(25, 0, 0), 8, { depth: 7, seed: 11 }),
|
|
80
|
+
createPlatform(ctx, new Vector3(0, 2.6, 0), 6, { depth: 5, oneWay: true, seed: 17 }),
|
|
81
|
+
];
|
|
82
|
+
const supportSurfaceY = (position: Pick<Vector3, "x" | "y" | "z">): number | undefined => {
|
|
83
|
+
let surfaceY: number | undefined;
|
|
84
|
+
for (const platform of platforms) {
|
|
85
|
+
if (!platform.contains(position) || platform.surfaceY > position.y) continue;
|
|
86
|
+
if (surfaceY === undefined || platform.surfaceY > surfaceY) surfaceY = platform.surfaceY;
|
|
87
|
+
}
|
|
88
|
+
return surfaceY;
|
|
89
|
+
};
|
|
55
90
|
const crate = crateMesh();
|
|
56
91
|
crate.position.set(-3, 1, 0);
|
|
57
92
|
crate.castShadow = crate.receiveShadow = true;
|
|
@@ -94,26 +129,44 @@ export class Level extends Scene<GameState, IPhysicsContext> {
|
|
|
94
129
|
ctx.entities.add(id, pickup);
|
|
95
130
|
};
|
|
96
131
|
const followCamera = (target: Vector3, dt: number): void => {
|
|
97
|
-
|
|
132
|
+
// The eye stays **below** the one-way platform, which sits at y = 2.6 directly over the
|
|
133
|
+
// spawn because `oneway.playtest.json` jumps straight up from there and lands on it. At the
|
|
134
|
+
// old +4.4 the camera looked down onto that slab and the character it is standing under, so
|
|
135
|
+
// the opening frame was a green rectangle with the player hidden behind it; raising the
|
|
136
|
+
// camera further only made it worse. Under the slab, the level reads and the platform
|
|
137
|
+
// overhead reads as an overhang, which is what it is.
|
|
138
|
+
const desired = cameraAnchor.set(target.x + 1.4, target.y + 1.75, target.z + 10.6);
|
|
98
139
|
if (dt >= 1) camera.position.copy(desired);
|
|
99
140
|
else camera.position.lerp(desired, 1 - Math.exp(-dt / 0.18));
|
|
100
|
-
camera.lookAt(target.x, target.y + 0.
|
|
141
|
+
camera.lookAt(target.x + 2.2, target.y + 0.35, target.z - 0.4);
|
|
101
142
|
};
|
|
102
143
|
addPickup(new Vector3(2, 1.05, 0));
|
|
103
144
|
addPickup(new Vector3(3.2, 1.05, 0));
|
|
104
145
|
addPickup(new Vector3(4.4, 1.05, 0));
|
|
105
146
|
for (const point of coinArc(new Vector3(11, 1.05, 0), 4, 3.6, 1.4)) addPickup(point);
|
|
147
|
+
const patrolSetup = ctx.entities.get<Group>("patrol");
|
|
148
|
+
const patrolPosition = patrolSetup?.position.clone() ?? PATROL_FROM.clone();
|
|
149
|
+
const patrolQuaternion = patrolSetup?.quaternion.clone();
|
|
150
|
+
const patrolScale = patrolSetup?.scale.clone();
|
|
151
|
+
const patrolUserData = patrolSetup === undefined ? undefined : { ...patrolSetup.userData };
|
|
152
|
+
if (patrolSetup !== undefined) ctx.entities.remove("patrol");
|
|
106
153
|
const patrol = new Patrol(
|
|
107
154
|
ctx,
|
|
108
155
|
character,
|
|
109
|
-
|
|
110
|
-
|
|
156
|
+
PATROL_FROM,
|
|
157
|
+
PATROL_TO,
|
|
111
158
|
() => {
|
|
112
159
|
defeated += 1;
|
|
113
160
|
},
|
|
114
161
|
(fromX) => checkpoints.hurt(character, fromX),
|
|
115
162
|
PLATFORMER_FEEL,
|
|
116
163
|
);
|
|
164
|
+
patrol.mesh.position.copy(patrolPosition);
|
|
165
|
+
if (patrolQuaternion !== undefined) patrol.mesh.quaternion.copy(patrolQuaternion);
|
|
166
|
+
if (patrolScale !== undefined) patrol.mesh.scale.copy(patrolScale);
|
|
167
|
+
if (patrolUserData !== undefined) Object.assign(patrol.mesh.userData, patrolUserData);
|
|
168
|
+
patrol.mesh.updateMatrix();
|
|
169
|
+
patrol.area.setPosition(patrol.mesh.position);
|
|
117
170
|
ctx.entities.add("patrol", patrol);
|
|
118
171
|
const chaser = new Chaser(ctx, new Vector3(7.5, 0.66, 0));
|
|
119
172
|
const avoidanceChaser = new Chaser(ctx, new Vector3(8.2, 0.66, 0.7));
|
|
@@ -124,6 +177,7 @@ export class Level extends Scene<GameState, IPhysicsContext> {
|
|
|
124
177
|
followCamera(spawn, 1);
|
|
125
178
|
let elapsed = 0;
|
|
126
179
|
let terminal: TerminalState = TERMINAL.playing;
|
|
180
|
+
const statePatch: Partial<GameState> = {};
|
|
127
181
|
const finish = (next: TerminalState): void => {
|
|
128
182
|
if (terminal !== TERMINAL.playing) return;
|
|
129
183
|
terminal = next;
|
|
@@ -134,10 +188,22 @@ export class Level extends Scene<GameState, IPhysicsContext> {
|
|
|
134
188
|
character.update(
|
|
135
189
|
frameCtx,
|
|
136
190
|
dt,
|
|
137
|
-
touchControls
|
|
191
|
+
touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size),
|
|
192
|
+
supportSurfaceY,
|
|
138
193
|
);
|
|
139
|
-
|
|
140
|
-
|
|
194
|
+
// The chasers walk a measured route, and `pathLength` assertions read how much of it was
|
|
195
|
+
// walked while a runner was watching. Stepping them before the world reports startup ready
|
|
196
|
+
// spends part of the route where nothing can observe it, so the measurement becomes a
|
|
197
|
+
// function of how long startup took — it passed on a workstation and failed in CI at
|
|
198
|
+
// `4.43 of a required 6`, with `routeComplete` already true before the scenario began.
|
|
199
|
+
// Everything else in this frame keeps running: only the measured routes wait.
|
|
200
|
+
// `compileSettled`, not `phase === "ready"`: readiness additionally waits for a sustained
|
|
201
|
+
// in-budget frame window, which a software rasteriser never meets, so gating on it froze
|
|
202
|
+
// these routes for the whole scenario and measured a path length of 0.
|
|
203
|
+
if (frameCtx.startup.compileSettled) {
|
|
204
|
+
chaser.update(dt);
|
|
205
|
+
avoidanceChaser.update(dt);
|
|
206
|
+
}
|
|
141
207
|
patrol.update(dt);
|
|
142
208
|
checkpoints.pass(character.mesh.position);
|
|
143
209
|
checkpoints.update(dt, character);
|
|
@@ -155,21 +221,20 @@ export class Level extends Scene<GameState, IPhysicsContext> {
|
|
|
155
221
|
const rise = Math.max(0, character.mesh.position.y - SPAWN.y);
|
|
156
222
|
const speed = Math.hypot(character.body.velocity.x, character.body.velocity.z);
|
|
157
223
|
const previous = frameCtx.state.getState();
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
} as Partial<GameState>);
|
|
224
|
+
statePatch.checkpoint = checkpoints.currentIndex;
|
|
225
|
+
statePatch.coins = coins;
|
|
226
|
+
statePatch.coyoteJumps = character.coyoteJumps;
|
|
227
|
+
statePatch.defeated = defeated;
|
|
228
|
+
statePatch.dashes = character.dashes;
|
|
229
|
+
statePatch.hearts = checkpoints.hearts;
|
|
230
|
+
statePatch.jumps = character.jumps;
|
|
231
|
+
statePatch.peakRise = Math.max(previous.peakRise, rise);
|
|
232
|
+
statePatch.playerX = character.mesh.position.x;
|
|
233
|
+
statePatch.grounded = character.body.grounded;
|
|
234
|
+
statePatch.respawns = checkpoints.respawns;
|
|
235
|
+
statePatch.terminal = terminal;
|
|
236
|
+
statePatch.topSpeed = Math.max(previous.topSpeed, speed);
|
|
237
|
+
frameCtx.state.set(statePatch);
|
|
173
238
|
followCamera(character.mesh.position, dt);
|
|
174
239
|
};
|
|
175
240
|
}
|
|
@@ -7,6 +7,10 @@ export const TERMINAL = {
|
|
|
7
7
|
export type TerminalState = (typeof TERMINAL)[keyof typeof TERMINAL];
|
|
8
8
|
|
|
9
9
|
export type GameState = {
|
|
10
|
+
/** Set from the UI\'s pause and resume intents, and read back by the menu. */
|
|
11
|
+
paused: boolean;
|
|
12
|
+
/** True once the UI layer has rendered and published its interactive rectangles. */
|
|
13
|
+
uiReady: boolean;
|
|
10
14
|
checkpoint: number;
|
|
11
15
|
coins: number;
|
|
12
16
|
coyoteJumps: number;
|
|
@@ -24,8 +24,72 @@ body,
|
|
|
24
24
|
}
|
|
25
25
|
|
|
26
26
|
body {
|
|
27
|
-
background: var(--color-ink);
|
|
28
27
|
color: var(--color-text);
|
|
29
28
|
font-family: var(--font-mono);
|
|
30
29
|
-webkit-font-smoothing: antialiased;
|
|
31
30
|
}
|
|
31
|
+
|
|
32
|
+
/*
|
|
33
|
+
* The page's backdrop belongs to the web document's own mount point, never to `body`.
|
|
34
|
+
* `src/ui/main.tsx` imports this same stylesheet, and on native that file is what the platform's
|
|
35
|
+
* transparent web view loads over the game: a `body` background there paints an opaque sheet over
|
|
36
|
+
* the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
|
|
37
|
+
* in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
|
|
38
|
+
*/
|
|
39
|
+
|
|
40
|
+
#root {
|
|
41
|
+
background: var(--color-ink);
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/* Boot failures are a page state, so the generated game owns their presentation. */
|
|
45
|
+
[data-threenative-canvas-error="true"] {
|
|
46
|
+
position: fixed;
|
|
47
|
+
inset: 0;
|
|
48
|
+
z-index: 1000;
|
|
49
|
+
display: grid;
|
|
50
|
+
place-items: center;
|
|
51
|
+
box-sizing: border-box;
|
|
52
|
+
padding: clamp(1.5rem, 8vw, 6rem);
|
|
53
|
+
overflow: auto;
|
|
54
|
+
background: #fff7ed;
|
|
55
|
+
color: var(--color-ink);
|
|
56
|
+
font-family: inherit;
|
|
57
|
+
font-size: clamp(1rem, 2vw, 1.5rem);
|
|
58
|
+
line-height: 1.5;
|
|
59
|
+
text-align: center;
|
|
60
|
+
white-space: pre-wrap;
|
|
61
|
+
overflow-wrap: anywhere;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/* The debug surface is framework plumbing; its default presentation is yours to change. */
|
|
65
|
+
[data-threenative-debug-overlay="true"] {
|
|
66
|
+
position: fixed;
|
|
67
|
+
top: 1rem;
|
|
68
|
+
right: 1rem;
|
|
69
|
+
z-index: 50;
|
|
70
|
+
max-width: 24rem;
|
|
71
|
+
padding: 0.75rem;
|
|
72
|
+
pointer-events: none;
|
|
73
|
+
background: rgb(2 6 23 / 90%);
|
|
74
|
+
box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
|
|
75
|
+
color: #cffafe;
|
|
76
|
+
font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
|
|
77
|
+
font-size: 12px;
|
|
78
|
+
line-height: 1.5;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
[data-threenative-debug-overlay="true"] table {
|
|
82
|
+
width: 100%;
|
|
83
|
+
table-layout: fixed;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
[data-threenative-debug-overlay="true"] th,
|
|
87
|
+
[data-threenative-debug-overlay="true"] td {
|
|
88
|
+
padding-right: 1rem;
|
|
89
|
+
text-align: left;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
[data-threenative-debug-overlay="true"] td:last-child {
|
|
93
|
+
overflow-wrap: anywhere;
|
|
94
|
+
word-break: break-all;
|
|
95
|
+
}
|
|
@@ -2,15 +2,20 @@ import type { IGame } from "@threenative/core";
|
|
|
2
2
|
import type { IPhysicsContext } from "@threenative/physics";
|
|
3
3
|
import { DebugOverlay, GameCanvas } from "@threenative/ui";
|
|
4
4
|
import type { GameState } from "../state.js";
|
|
5
|
-
import {
|
|
6
|
-
import { Menu } from "./Menu.js";
|
|
5
|
+
import { GameUi } from "./GameUi.js";
|
|
7
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
|
+
*/
|
|
8
14
|
export function App({ game }: { game: IGame<GameState, IPhysicsContext> }) {
|
|
9
15
|
return (
|
|
10
16
|
<main className="relative h-screen w-screen overflow-hidden bg-ink">
|
|
11
17
|
<GameCanvas className="absolute inset-0" game={game} />
|
|
12
|
-
<
|
|
13
|
-
<Menu />
|
|
18
|
+
<GameUi />
|
|
14
19
|
<DebugOverlay />
|
|
15
20
|
</main>
|
|
16
21
|
);
|
|
@@ -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
|
+
}
|
|
@@ -1,10 +1,11 @@
|
|
|
1
|
-
import
|
|
2
|
-
import type { IPhysicsContext } from "@threenative/physics";
|
|
3
|
-
import { useGameState } from "@threenative/ui";
|
|
1
|
+
import { useUiState } from "@threenative/ui";
|
|
4
2
|
import type { GameState } from "../state.js";
|
|
5
3
|
|
|
6
|
-
export function Hud(
|
|
7
|
-
const state =
|
|
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;
|
|
8
9
|
return (
|
|
9
10
|
<div className="pointer-events-none absolute inset-0 p-6 text-[11px] uppercase tracking-[0.14em] text-text">
|
|
10
11
|
<div className="flex gap-5">
|
|
@@ -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 />);
|
|
@@ -1,32 +1,49 @@
|
|
|
1
1
|
import type { IThreeNativeConfig } from "@threenative/core";
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
const config: IThreeNativeConfig = {
|
|
4
4
|
app: {
|
|
5
5
|
id: "com.threenative.__PROJECT_ID__",
|
|
6
6
|
name: "__PROJECT_NAME__",
|
|
7
7
|
version: "1.0.0",
|
|
8
8
|
build: 1,
|
|
9
9
|
icon: "public/icon.png",
|
|
10
|
+
icons: { web: { favicon: "public/favicon.svg" } },
|
|
10
11
|
},
|
|
11
12
|
display: {
|
|
12
13
|
orientation: "landscape", // Mobile viewport orientation.
|
|
13
14
|
fullscreen: true, // Keep the game surface edge to edge.
|
|
14
15
|
keepScreenOn: true, // Do not dim during a play session.
|
|
16
|
+
maxFps: 60, // Set 120 to opt into a supported high-refresh display mode.
|
|
15
17
|
},
|
|
16
18
|
window: {
|
|
17
19
|
title: "__PROJECT_NAME__", // Desktop window title.
|
|
18
20
|
width: 1280,
|
|
19
21
|
height: 720,
|
|
22
|
+
maximized: false,
|
|
20
23
|
resizable: true,
|
|
21
24
|
},
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
backdropColor: "#0d1b2a",
|
|
25
|
-
trackColor: "#274060",
|
|
26
|
-
progressColor: "#8fd694",
|
|
27
|
-
showProgressBar: true,
|
|
28
|
-
// image: "public/logo.png", // drawn centred above the bar
|
|
25
|
+
bootSplash: {
|
|
26
|
+
backgroundColor: "#0d1b2a",
|
|
29
27
|
},
|
|
30
28
|
nativeEntry: "src/game.ts",
|
|
31
|
-
renderer: {
|
|
32
|
-
|
|
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;
|
|
@@ -1,5 +1,38 @@
|
|
|
1
1
|
import tailwindcss from "@tailwindcss/vite";
|
|
2
|
+
import { watchAssets } from "@threenative/assets";
|
|
2
3
|
import react from "@vitejs/plugin-react";
|
|
4
|
+
import { createEngineFreshnessPlugin, createWebBrandPlugin } from "create-threenative";
|
|
3
5
|
import { defineConfig } from "vite";
|
|
6
|
+
import type { Plugin } from "vite";
|
|
7
|
+
import config from "./threenative.config.js";
|
|
4
8
|
|
|
5
|
-
|
|
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
|
+
});
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
[mcp_servers.threenative-assets]
|
|
2
|
+
command = "node"
|
|
3
|
+
args = ["./node_modules/@threenative/core/mcp/assets.mjs"]
|
|
4
|
+
|
|
5
|
+
[mcp_servers.threenative-assets.env]
|
|
6
|
+
ASSET_DOWNLOAD_DIR = "./public/assets"
|
|
7
|
+
AUDIO_DOWNLOAD_DIR = "./public/audio"
|
|
8
|
+
|
|
9
|
+
[mcp_servers.threenative-sculpt]
|
|
10
|
+
command = "node"
|
|
11
|
+
args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
|
|
12
|
+
|
|
13
|
+
[mcp_servers.threenative-engine]
|
|
14
|
+
command = "node"
|
|
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
|
+
}
|
|
@@ -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
|
+
}
|
|
@@ -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
|
+
}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
{
|
|
2
|
+
"servers": {
|
|
3
|
+
"threenative-assets": {
|
|
4
|
+
"type": "stdio",
|
|
5
|
+
"command": "node",
|
|
6
|
+
"args": [
|
|
7
|
+
"./node_modules/@threenative/core/mcp/assets.mjs"
|
|
8
|
+
],
|
|
9
|
+
"env": {
|
|
10
|
+
"ASSET_DOWNLOAD_DIR": "./public/assets",
|
|
11
|
+
"AUDIO_DOWNLOAD_DIR": "./public/audio"
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
"threenative-sculpt": {
|
|
15
|
+
"type": "stdio",
|
|
16
|
+
"command": "node",
|
|
17
|
+
"args": [
|
|
18
|
+
"./node_modules/@threenative/core/mcp/sculpt.mjs"
|
|
19
|
+
]
|
|
20
|
+
},
|
|
21
|
+
"threenative-engine": {
|
|
22
|
+
"type": "stdio",
|
|
23
|
+
"command": "node",
|
|
24
|
+
"args": [
|
|
25
|
+
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
26
|
+
]
|
|
27
|
+
},
|
|
28
|
+
"threenative-blender": {
|
|
29
|
+
"type": "stdio",
|
|
30
|
+
"command": "node",
|
|
31
|
+
"args": [
|
|
32
|
+
"./node_modules/@threenative/core/mcp/blender.mjs"
|
|
33
|
+
]
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
}
|