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,4 +1,11 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import {
|
|
2
|
+
GPUParticles3D,
|
|
3
|
+
type ICtx,
|
|
4
|
+
Scene,
|
|
5
|
+
type SceneFrame,
|
|
6
|
+
isMobile,
|
|
7
|
+
isTouchscreenAvailable,
|
|
8
|
+
} from "@threenative/core";
|
|
2
9
|
import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
|
|
3
10
|
import { type Object3D, type PerspectiveCamera, Vector3 } from "three";
|
|
4
11
|
import { Ability } from "../abilities/Ability.js";
|
|
@@ -6,7 +13,6 @@ import { Enemy } from "../entities/Enemy.js";
|
|
|
6
13
|
import { HOSTILE_LAYER, PLAYER_LAYER, Player, WORLD_LAYER } from "../entities/Player.js";
|
|
7
14
|
import { ITEMS, Inventory, type ItemId, type ItemStack } from "../items/Inventory.js";
|
|
8
15
|
import { describeDrops, rollDrops } from "../loot/drops.js";
|
|
9
|
-
import { directSpaceState } from "../physics.js";
|
|
10
16
|
import { emitPlaytestEvent } from "../playtest-events.js";
|
|
11
17
|
import { loadProgress, saveProgress } from "../progress.js";
|
|
12
18
|
import { createDungeonCamera } from "../render/camera.js";
|
|
@@ -16,6 +22,8 @@ import { createMaterials } from "../render/materials.js";
|
|
|
16
22
|
import { setupPost } from "../render/postprocessing.js";
|
|
17
23
|
import { createDungeon, createLootVisual } from "../render/shapes.js";
|
|
18
24
|
import { setupSky } from "../render/sky.js";
|
|
25
|
+
import { TouchControls } from "../render/touch-controls.js";
|
|
26
|
+
import { createArcaneSurge, createAttackArc, createHitBurst } from "../render/vfx.js";
|
|
19
27
|
import type { GameState } from "../state.js";
|
|
20
28
|
import { StatBlock } from "../stats/StatBlock.js";
|
|
21
29
|
|
|
@@ -33,8 +41,14 @@ function itemId(value: string): value is ItemId {
|
|
|
33
41
|
return Object.values(ITEMS).some((item) => item.id === value);
|
|
34
42
|
}
|
|
35
43
|
|
|
44
|
+
function quantize(value: number, scale: number): number {
|
|
45
|
+
return Math.round(value * scale) / scale;
|
|
46
|
+
}
|
|
47
|
+
|
|
36
48
|
export class Play extends Scene<GameState, IPhysicsContext> {
|
|
37
49
|
static override readonly initialState: GameState = {
|
|
50
|
+
paused: false,
|
|
51
|
+
uiReady: false,
|
|
38
52
|
abilityCooldown: 0,
|
|
39
53
|
abilityUses: 0,
|
|
40
54
|
baseDamage: 12,
|
|
@@ -76,12 +90,18 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
76
90
|
const camera = ctx.camera as PerspectiveCamera;
|
|
77
91
|
const materials = createMaterials();
|
|
78
92
|
setupSky(ctx.scene);
|
|
79
|
-
setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
|
|
80
|
-
|
|
93
|
+
const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
|
|
94
|
+
// isMobile() arrives as an argument because src/render/ imports no framework package: the
|
|
95
|
+
// platform decision is made here, in portable game code, exactly like createRandom.
|
|
96
|
+
setupPost(ctx.renderer, ctx.scene, camera, { godraysLight: sun, mobile: isMobile() });
|
|
81
97
|
const loading = createLoadingScreen(ctx);
|
|
82
98
|
ctx.add(camera);
|
|
83
99
|
const cameraRig = createDungeonCamera(camera);
|
|
84
100
|
ctx.viewport.resize();
|
|
101
|
+
const showTouchControls = isMobile() && isTouchscreenAvailable();
|
|
102
|
+
const touchControls = showTouchControls
|
|
103
|
+
? ctx.entities.add("touch-controls", new TouchControls(camera))
|
|
104
|
+
: undefined;
|
|
85
105
|
|
|
86
106
|
const dungeon = createDungeon(materials);
|
|
87
107
|
ctx.add(dungeon.group);
|
|
@@ -144,6 +164,26 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
144
164
|
player.equippedItem = inventory.equipped?.itemId ?? "";
|
|
145
165
|
ctx.entities.add("player", player);
|
|
146
166
|
|
|
167
|
+
const attackVfx = ctx.add(new GPUParticles3D(createAttackArc()));
|
|
168
|
+
const hitVfx = ctx.add(new GPUParticles3D(createHitBurst()));
|
|
169
|
+
const surgeVfx = ctx.add(new GPUParticles3D(createArcaneSurge()));
|
|
170
|
+
attackVfx.visible = false;
|
|
171
|
+
hitVfx.visible = false;
|
|
172
|
+
surgeVfx.visible = false;
|
|
173
|
+
const burst = (
|
|
174
|
+
particles: GPUParticles3D,
|
|
175
|
+
position: { readonly x: number; readonly y: number; readonly z: number },
|
|
176
|
+
name: string,
|
|
177
|
+
): void => {
|
|
178
|
+
particles.position.copy(position);
|
|
179
|
+
particles.visible = true;
|
|
180
|
+
particles.restart();
|
|
181
|
+
ctx.after(0.45, () => {
|
|
182
|
+
particles.visible = false;
|
|
183
|
+
});
|
|
184
|
+
emitPlaytestEvent({ entity: "player", name });
|
|
185
|
+
};
|
|
186
|
+
|
|
147
187
|
const enemies = new Map<number, Enemy>();
|
|
148
188
|
const enemyIds = new Map<number, string>();
|
|
149
189
|
const damageStats = new StatBlock(Play.initialState.baseDamage);
|
|
@@ -297,7 +337,8 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
297
337
|
const boss = addEnemy("boss", new Vector3(16, 0.78, 0), { boss: true, health: 64 });
|
|
298
338
|
|
|
299
339
|
const strike = (amount: number): void => {
|
|
300
|
-
|
|
340
|
+
burst(attackVfx, player.attackOrigin(), "vfx-attack");
|
|
341
|
+
const hits = ctx.physics.directSpaceState.intersectShape({
|
|
301
342
|
collisionMask: HOSTILE_LAYER,
|
|
302
343
|
maxResults: 16,
|
|
303
344
|
position: player.attackOrigin(),
|
|
@@ -308,6 +349,7 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
308
349
|
const enemy = enemies.get(hit.body.id);
|
|
309
350
|
if (enemy === undefined) continue;
|
|
310
351
|
enemy.takeDamage(amount);
|
|
352
|
+
if (hit.position !== undefined) burst(hitVfx, hit.position, "vfx-hit");
|
|
311
353
|
hitCount += 1;
|
|
312
354
|
}
|
|
313
355
|
const state = ctx.state.getState();
|
|
@@ -327,6 +369,7 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
327
369
|
emitPlaytestEvent({ entity: "player", name: "ability-expired" });
|
|
328
370
|
},
|
|
329
371
|
onStart: () => {
|
|
372
|
+
burst(surgeVfx, player.mesh.position, "vfx-surge");
|
|
330
373
|
damageStats.apply({ add: 6, duration: 1, source: "arcane-surge" }, elapsed);
|
|
331
374
|
ctx.state.set({ abilityUses: ctx.state.getState().abilityUses + 1, modifierActive: 1 });
|
|
332
375
|
strike(20);
|
|
@@ -380,6 +423,7 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
380
423
|
|
|
381
424
|
cameraRig.snap(player.mesh.position);
|
|
382
425
|
let lastSavedRoom = currentRoom;
|
|
426
|
+
const frameState: Partial<GameState> = {};
|
|
383
427
|
return (frameCtx, dt) => {
|
|
384
428
|
loading.update();
|
|
385
429
|
elapsed += dt;
|
|
@@ -389,8 +433,10 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
389
433
|
}
|
|
390
434
|
if (frameCtx.input.justPressed("lethal")) player.takeDamage(player.health + 1);
|
|
391
435
|
if (frameCtx.input.justPressed("damage")) player.takeDamage(18);
|
|
392
|
-
|
|
393
|
-
if (frameCtx.input.justPressed("
|
|
436
|
+
const touch = touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size);
|
|
437
|
+
if (frameCtx.input.justPressed("attack") || touch?.attackPressed === true)
|
|
438
|
+
strike(Math.round(damageStats.value(elapsed)));
|
|
439
|
+
if (frameCtx.input.justPressed("ability") || touch?.abilityPressed === true) ability.cast();
|
|
394
440
|
if (frameCtx.input.justPressed("equip")) {
|
|
395
441
|
if (inventory.equip("ember-blade")) {
|
|
396
442
|
syncEquipmentStat();
|
|
@@ -410,26 +456,47 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
410
456
|
if (frameCtx.input.justPressed("dropProbe")) proveDrops();
|
|
411
457
|
if (frameCtx.input.justPressed("save")) saveRequested = true;
|
|
412
458
|
|
|
413
|
-
player.update(frameCtx, dt);
|
|
459
|
+
player.update(frameCtx, dt, touch);
|
|
414
460
|
ability.update(dt);
|
|
415
|
-
|
|
461
|
+
// Enemies act only once first-use compilation has settled. They damage the player, and the
|
|
462
|
+
// combat scenario asserts an exact health at a labelled step — so stepping them during the
|
|
463
|
+
// launch makes that number a function of how long the launch took. Measured as 90 on a
|
|
464
|
+
// software rasteriser against 95 on a real GPU from the same build, which is the comment
|
|
465
|
+
// core carries in playtest.ts for the same reason.
|
|
466
|
+
if (frameCtx.startup.compileSettled) {
|
|
467
|
+
for (const enemy of enemies.values()) enemy.update(frameCtx, dt, player.mesh.position);
|
|
468
|
+
}
|
|
416
469
|
|
|
417
470
|
currentRoom = roomFor(player.mesh.position.x);
|
|
418
|
-
frameCtx.state.
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
471
|
+
const previous = frameCtx.state.getState();
|
|
472
|
+
frameState.abilityCooldown = quantize(ability.cooldownRemaining, 1000);
|
|
473
|
+
frameState.baseDamage = damageStats.base;
|
|
474
|
+
frameState.damage = Math.round(damageStats.value(elapsed));
|
|
475
|
+
frameState.health = player.health;
|
|
476
|
+
frameState.lineOfSightBlocked = wallEnemy.lineOfSightBlocked ? 1 : 0;
|
|
477
|
+
frameState.modifierActive = ability.active ? 1 : 0;
|
|
478
|
+
frameState.playerX = quantize(player.mesh.position.x, 1000);
|
|
479
|
+
frameState.playerY = quantize(player.mesh.position.y, 1000);
|
|
480
|
+
frameState.playerZ = quantize(player.mesh.position.z, 1000);
|
|
481
|
+
frameState.room = currentRoom;
|
|
482
|
+
frameState.visibleEnemyAggro =
|
|
483
|
+
visibleEnemy.state === "aggro" || visibleEnemy.state === "attack" ? 1 : 0;
|
|
484
|
+
frameState.wallEnemyAggro =
|
|
485
|
+
wallEnemy.state === "aggro" || wallEnemy.state === "attack" ? 1 : 0;
|
|
486
|
+
const changed =
|
|
487
|
+
frameState.abilityCooldown !== previous.abilityCooldown ||
|
|
488
|
+
frameState.baseDamage !== previous.baseDamage ||
|
|
489
|
+
frameState.damage !== previous.damage ||
|
|
490
|
+
frameState.health !== previous.health ||
|
|
491
|
+
frameState.lineOfSightBlocked !== previous.lineOfSightBlocked ||
|
|
492
|
+
frameState.modifierActive !== previous.modifierActive ||
|
|
493
|
+
frameState.playerX !== previous.playerX ||
|
|
494
|
+
frameState.playerY !== previous.playerY ||
|
|
495
|
+
frameState.playerZ !== previous.playerZ ||
|
|
496
|
+
frameState.room !== previous.room ||
|
|
497
|
+
frameState.visibleEnemyAggro !== previous.visibleEnemyAggro ||
|
|
498
|
+
frameState.wallEnemyAggro !== previous.wallEnemyAggro;
|
|
499
|
+
if (changed) frameCtx.state.set(frameState);
|
|
433
500
|
if (currentRoom !== lastSavedRoom) {
|
|
434
501
|
lastSavedRoom = currentRoom;
|
|
435
502
|
saveRequested = true;
|
|
@@ -6,6 +6,10 @@ export type InventoryProjection = {
|
|
|
6
6
|
};
|
|
7
7
|
|
|
8
8
|
export type GameState = {
|
|
9
|
+
/** Set from the UI\'s pause and resume intents, and read back by the menu. */
|
|
10
|
+
paused: boolean;
|
|
11
|
+
/** True once the UI layer has rendered and published its interactive rectangles. */
|
|
12
|
+
uiReady: boolean;
|
|
9
13
|
abilityCooldown: number;
|
|
10
14
|
abilityUses: number;
|
|
11
15
|
baseDamage: number;
|
|
@@ -25,8 +25,72 @@ body,
|
|
|
25
25
|
}
|
|
26
26
|
|
|
27
27
|
body {
|
|
28
|
-
background: var(--color-void);
|
|
29
28
|
color: var(--color-text);
|
|
30
29
|
font-family: var(--font-mono);
|
|
31
30
|
-webkit-font-smoothing: antialiased;
|
|
32
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-void);
|
|
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: #fff1f2;
|
|
56
|
+
color: var(--color-void);
|
|
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
|
+
}
|
|
@@ -1,12 +1,14 @@
|
|
|
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 AbilityBar(
|
|
7
|
-
const
|
|
8
|
-
|
|
9
|
-
|
|
4
|
+
export function AbilityBar() {
|
|
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 cooldown = state.abilityCooldown;
|
|
10
|
+
const active = state.modifierActive;
|
|
11
|
+
const uses = state.abilityUses;
|
|
10
12
|
const ready = cooldown <= 0;
|
|
11
13
|
return (
|
|
12
14
|
<footer className="pointer-events-none absolute bottom-6 left-6 w-72 border border-line bg-panel/90 p-3 text-[10px] uppercase tracking-[0.14em]">
|
|
@@ -2,19 +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 { CharacterPanel } from "./CharacterPanel.js";
|
|
7
|
-
import { Hud } from "./Hud.js";
|
|
8
|
-
import { InventoryPanel } from "./InventoryPanel.js";
|
|
5
|
+
import { GameUi } from "./GameUi.js";
|
|
9
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
|
+
*/
|
|
10
14
|
export function App({ game }: { game: IGame<GameState, IPhysicsContext> }) {
|
|
11
15
|
return (
|
|
12
16
|
<main className="relative h-screen w-screen overflow-hidden bg-void">
|
|
13
17
|
<GameCanvas className="absolute inset-0" game={game} />
|
|
14
|
-
<
|
|
15
|
-
<CharacterPanel game={game} />
|
|
16
|
-
<InventoryPanel game={game} />
|
|
17
|
-
<AbilityBar game={game} />
|
|
18
|
+
<GameUi />
|
|
18
19
|
<DebugOverlay />
|
|
19
20
|
</main>
|
|
20
21
|
);
|
|
@@ -1,13 +1,15 @@
|
|
|
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 CharacterPanel(
|
|
7
|
-
const
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
4
|
+
export function CharacterPanel() {
|
|
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 health = state.health;
|
|
10
|
+
const damage = state.damage;
|
|
11
|
+
const equipped = state.equippedItem;
|
|
12
|
+
const lastDamage = state.lastDamage;
|
|
11
13
|
return (
|
|
12
14
|
<aside className="pointer-events-none absolute right-6 top-5 w-52 border border-line bg-panel/90 p-3 text-[10px] uppercase tracking-[0.14em]">
|
|
13
15
|
<div className="text-amber">character</div>
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { UiLayer } from "@threenative/ui";
|
|
2
|
+
import { AbilityBar } from "./AbilityBar.js";
|
|
3
|
+
import { CharacterPanel } from "./CharacterPanel.js";
|
|
4
|
+
import { Hud } from "./Hud.js";
|
|
5
|
+
import { InventoryPanel } from "./InventoryPanel.js";
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Everything the player sees that is not the scene.
|
|
9
|
+
*
|
|
10
|
+
* One component, mounted twice by two entries that differ only in what else is on the page:
|
|
11
|
+
* `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
|
|
12
|
+
* page the native web view loads. Keeping both entries pointed at this file is what makes "the
|
|
13
|
+
* same UI on every target" a fact rather than an intention.
|
|
14
|
+
*/
|
|
15
|
+
export function GameUi() {
|
|
16
|
+
return (
|
|
17
|
+
<UiLayer>
|
|
18
|
+
<Hud />
|
|
19
|
+
<CharacterPanel />
|
|
20
|
+
<InventoryPanel />
|
|
21
|
+
<AbilityBar />
|
|
22
|
+
</UiLayer>
|
|
23
|
+
);
|
|
24
|
+
}
|
|
@@ -1,13 +1,15 @@
|
|
|
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
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
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 room = state.room;
|
|
10
|
+
const phase = state.phase;
|
|
11
|
+
const enemies = state.enemiesDefeated;
|
|
12
|
+
const blocked = state.lineOfSightBlocked;
|
|
11
13
|
return (
|
|
12
14
|
<section className="pointer-events-none absolute left-6 top-5 w-72 text-[10px] uppercase tracking-[0.16em]">
|
|
13
15
|
<div className="text-dim">dungeon / action rpg</div>
|
|
@@ -1,12 +1,14 @@
|
|
|
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 InventoryPanel(
|
|
7
|
-
const
|
|
8
|
-
|
|
9
|
-
|
|
4
|
+
export function InventoryPanel() {
|
|
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 items = state.inventory;
|
|
10
|
+
const refused = state.inventoryFullRefused;
|
|
11
|
+
const pending = state.pendingLoot;
|
|
10
12
|
const seen = new Map<string, number>();
|
|
11
13
|
return (
|
|
12
14
|
<aside className="pointer-events-none absolute bottom-6 right-6 w-64 border border-line bg-panel/90 p-3 text-[10px] uppercase tracking-[0.14em]">
|
|
@@ -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,29 +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
|
+
icon: "public/icon.png",
|
|
10
|
+
icons: { web: { favicon: "public/favicon.svg" } },
|
|
9
11
|
},
|
|
10
12
|
display: {
|
|
11
13
|
orientation: "landscape",
|
|
12
14
|
fullscreen: true,
|
|
13
15
|
keepScreenOn: true,
|
|
16
|
+
maxFps: 60,
|
|
14
17
|
},
|
|
15
18
|
window: {
|
|
16
19
|
title: "__PROJECT_NAME__",
|
|
17
20
|
width: 1280,
|
|
18
21
|
height: 720,
|
|
22
|
+
maximized: false,
|
|
19
23
|
resizable: true,
|
|
20
24
|
},
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
trackColor: "#182231",
|
|
24
|
-
progressColor: "#e8b86a",
|
|
25
|
-
showProgressBar: true,
|
|
25
|
+
bootSplash: {
|
|
26
|
+
backgroundColor: "#080b12",
|
|
26
27
|
},
|
|
27
28
|
nativeEntry: "src/game.ts",
|
|
28
|
-
renderer: {
|
|
29
|
-
|
|
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,8 +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";
|
|
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
|
+
}
|
|
4
23
|
|
|
5
24
|
export default defineConfig({
|
|
6
|
-
plugins: [
|
|
7
|
-
|
|
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
|
+
},
|
|
8
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
|
+
}
|