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
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
// Generated source. This stage is ordinary Three.js TSL; the engine only orders and measures it.
|
|
2
|
+
|
|
3
|
+
import {
|
|
4
|
+
cameraFar,
|
|
5
|
+
cameraNear,
|
|
6
|
+
color,
|
|
7
|
+
luminance,
|
|
8
|
+
mix,
|
|
9
|
+
perspectiveDepthToViewZ,
|
|
10
|
+
screenSize,
|
|
11
|
+
screenUV,
|
|
12
|
+
texture,
|
|
13
|
+
vec2,
|
|
14
|
+
vec4,
|
|
15
|
+
} from "three/tsl";
|
|
16
|
+
import type { Node } from "three/webgpu";
|
|
17
|
+
import { createTextureScope } from "./textureLifetime.js";
|
|
18
|
+
|
|
19
|
+
export interface IOutlineStageOptions {
|
|
20
|
+
/** The depth attachment written by the scene pass. */
|
|
21
|
+
readonly depthNode: Node;
|
|
22
|
+
/** Ink colour and thresholds are this game's look decisions. */
|
|
23
|
+
readonly inkColor?: number;
|
|
24
|
+
readonly strength?: number;
|
|
25
|
+
readonly threshold?: number;
|
|
26
|
+
readonly softness?: number;
|
|
27
|
+
readonly depthWeight?: number;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export interface IOutlineStage {
|
|
31
|
+
readonly after: "bloom";
|
|
32
|
+
readonly build: (input: unknown) => unknown;
|
|
33
|
+
readonly dispose: () => void;
|
|
34
|
+
readonly name: "outline";
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* Eight-tap Sobel edge ink, normalised to the physical framebuffer pixel size.
|
|
39
|
+
*
|
|
40
|
+
* Colour edges catch the painted prop boundaries while linearised depth catches silhouettes
|
|
41
|
+
* whose two sides happen to have similar colours. The stage samples the original chain input
|
|
42
|
+
* and never owns a material, palette or renderer fallback.
|
|
43
|
+
*/
|
|
44
|
+
export function createOutlineStage(options: IOutlineStageOptions): IOutlineStage {
|
|
45
|
+
if (!isNode(options.depthNode)) throw new Error("outline depth source is missing");
|
|
46
|
+
const strength = finiteNonNegative(options.strength ?? 0.8, "outline strength");
|
|
47
|
+
const threshold = finiteNonNegative(options.threshold ?? 0.12, "outline threshold");
|
|
48
|
+
const softness = finitePositive(options.softness ?? 0.16, "outline softness");
|
|
49
|
+
const depthWeight = finiteUnit(options.depthWeight ?? 0.65, "outline depthWeight");
|
|
50
|
+
const colourWeight = 1 - depthWeight;
|
|
51
|
+
const ink = color(options.inkColor ?? 0x142331);
|
|
52
|
+
const textureScope = createTextureScope();
|
|
53
|
+
|
|
54
|
+
return {
|
|
55
|
+
after: "bloom",
|
|
56
|
+
build: (input) => {
|
|
57
|
+
textureScope.dispose();
|
|
58
|
+
if (!isNode(input)) throw new Error("outline input is missing");
|
|
59
|
+
if (strength === 0) return input;
|
|
60
|
+
const source = textureScope.texture(input) as unknown as ITextureNode;
|
|
61
|
+
const depthSource = texture(options.depthNode as never);
|
|
62
|
+
const texel = screenSize.reciprocal();
|
|
63
|
+
const sampleUv = (x: number, y: number): Node<"vec2"> =>
|
|
64
|
+
screenUV.add(texel.mul(vec2(x, y))).clamp(0, 1) as Node<"vec2">;
|
|
65
|
+
const sampleColour = (x: number, y: number): Node<"float"> =>
|
|
66
|
+
luminance(source.sample(sampleUv(x, y)).rgb);
|
|
67
|
+
const sampleDepth = (x: number, y: number): Node<"float"> =>
|
|
68
|
+
perspectiveDepthToViewZ(depthSource.sample(sampleUv(x, y)).r, cameraNear, cameraFar);
|
|
69
|
+
|
|
70
|
+
// Sobel's eight neighbours use physical-pixel offsets, so a resize does not change the
|
|
71
|
+
// apparent line width. This is the same eight-tap neighbourhood for colour and depth.
|
|
72
|
+
const colourX = sampleColour(-1, -1)
|
|
73
|
+
.negate()
|
|
74
|
+
.add(sampleColour(-1, 0).mul(-2))
|
|
75
|
+
.add(sampleColour(-1, 1).negate())
|
|
76
|
+
.add(sampleColour(1, -1))
|
|
77
|
+
.add(sampleColour(1, 0).mul(2))
|
|
78
|
+
.add(sampleColour(1, 1));
|
|
79
|
+
const colourY = sampleColour(-1, -1)
|
|
80
|
+
.negate()
|
|
81
|
+
.add(sampleColour(0, -1).mul(-2))
|
|
82
|
+
.add(sampleColour(1, -1).negate())
|
|
83
|
+
.add(sampleColour(-1, 1))
|
|
84
|
+
.add(sampleColour(0, 1).mul(2))
|
|
85
|
+
.add(sampleColour(1, 1));
|
|
86
|
+
const depthX = sampleDepth(-1, -1)
|
|
87
|
+
.negate()
|
|
88
|
+
.add(sampleDepth(-1, 0).mul(-2))
|
|
89
|
+
.add(sampleDepth(-1, 1).negate())
|
|
90
|
+
.add(sampleDepth(1, -1))
|
|
91
|
+
.add(sampleDepth(1, 0).mul(2))
|
|
92
|
+
.add(sampleDepth(1, 1));
|
|
93
|
+
const depthY = sampleDepth(-1, -1)
|
|
94
|
+
.negate()
|
|
95
|
+
.add(sampleDepth(0, -1).mul(-2))
|
|
96
|
+
.add(sampleDepth(1, -1).negate())
|
|
97
|
+
.add(sampleDepth(-1, 1))
|
|
98
|
+
.add(sampleDepth(0, 1).mul(2))
|
|
99
|
+
.add(sampleDepth(1, 1));
|
|
100
|
+
const centreDepth = sampleDepth(0, 0).abs().max(1);
|
|
101
|
+
const colourEdge = colourX.mul(colourX).add(colourY.mul(colourY)).sqrt();
|
|
102
|
+
const depthEdge = depthX.mul(depthX).add(depthY.mul(depthY)).sqrt().div(centreDepth);
|
|
103
|
+
const edge = colourEdge.mul(colourWeight).add(depthEdge.mul(depthWeight));
|
|
104
|
+
const mask = edge
|
|
105
|
+
.smoothstep(threshold, threshold + softness)
|
|
106
|
+
.mul(strength)
|
|
107
|
+
.clamp(0, 1);
|
|
108
|
+
const base = source.sample(screenUV);
|
|
109
|
+
return mix(base, vec4(ink, base.a), mask);
|
|
110
|
+
},
|
|
111
|
+
dispose: textureScope.dispose,
|
|
112
|
+
name: "outline",
|
|
113
|
+
};
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
interface ITextureNode extends Node<"vec4"> {
|
|
117
|
+
sample(uv: Node<"vec2">): Node<"vec4">;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
function isNode(value: unknown): value is Node {
|
|
121
|
+
return (
|
|
122
|
+
typeof value === "object" && value !== null && (value as { isNode?: boolean }).isNode === true
|
|
123
|
+
);
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
function finiteNonNegative(value: number, name: string): number {
|
|
127
|
+
if (!Number.isFinite(value) || value < 0)
|
|
128
|
+
throw new Error(`${name} must be finite and non-negative`);
|
|
129
|
+
return value;
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
function finitePositive(value: number, name: string): number {
|
|
133
|
+
if (!Number.isFinite(value) || value <= 0) throw new Error(`${name} must be finite and positive`);
|
|
134
|
+
return value;
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
function finiteUnit(value: number, name: string): number {
|
|
138
|
+
if (!Number.isFinite(value) || value < 0 || value > 1)
|
|
139
|
+
throw new Error(`${name} must be finite and between 0 and 1`);
|
|
140
|
+
return value;
|
|
141
|
+
}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
// The starter's painterly look: an ink outline, a Kuwahara smear, and a watercolour wash.
|
|
2
|
+
//
|
|
3
|
+
// This file exists because `worldEnvironment.ts` may not contain it. That file is the render-chain
|
|
4
|
+
// plumbing every kit copies verbatim, and `shared-render-sources.spec.ts` fails when one kit's copy
|
|
5
|
+
// stops matching the others — which is exactly what happens when a kit's own art direction is
|
|
6
|
+
// written into it. Bloom and vignette live in there because they are grading primitives every kit
|
|
7
|
+
// wants; kuwahara, outline and watercolour are one kit's aesthetic, and an aesthetic shipped into
|
|
8
|
+
// ten kits so that one can use it is the preset system the charter closed with evidence.
|
|
9
|
+
//
|
|
10
|
+
// So the plumbing exposes a seam — `authoredStageNames` and `authoredStages` — and this is what the
|
|
11
|
+
// starter passes through it.
|
|
12
|
+
|
|
13
|
+
import { createKuwaharaStage } from "./kuwahara.js";
|
|
14
|
+
import { createOutlineStage } from "./outline.js";
|
|
15
|
+
import { createWatercolorStage } from "./watercolor.js";
|
|
16
|
+
import type { ChainStage, IWorldEnvironmentStageContext } from "./worldEnvironment.js";
|
|
17
|
+
|
|
18
|
+
/** The knobs the quality presets set. Every one is this kit's, not the framework's. */
|
|
19
|
+
export interface IPainterlyOptions {
|
|
20
|
+
readonly outlineEnabled?: boolean;
|
|
21
|
+
readonly outlineInkColor?: number;
|
|
22
|
+
readonly outlineStrength?: number;
|
|
23
|
+
readonly outlineThreshold?: number;
|
|
24
|
+
readonly outlineSoftness?: number;
|
|
25
|
+
readonly outlineDepthWeight?: number;
|
|
26
|
+
readonly kuwaharaEnabled?: boolean;
|
|
27
|
+
readonly kuwaharaRadius?: number;
|
|
28
|
+
readonly kuwaharaResolutionScale?: number;
|
|
29
|
+
readonly kuwaharaAnisotropy?: number;
|
|
30
|
+
readonly kuwaharaStrength?: number;
|
|
31
|
+
readonly watercolorEnabled?: boolean;
|
|
32
|
+
readonly watercolorLevels?: number;
|
|
33
|
+
readonly watercolorPaperStrength?: number;
|
|
34
|
+
readonly watercolorShadowStrength?: number;
|
|
35
|
+
readonly watercolorShadowTint?: number;
|
|
36
|
+
readonly watercolorStrength?: number;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* Which stages run, in chain order.
|
|
41
|
+
*
|
|
42
|
+
* The chain reads this before the scene pass exists — with nothing requested it sets an exposure
|
|
43
|
+
* and never builds a pass at all — so it has to be answerable from the options alone.
|
|
44
|
+
*/
|
|
45
|
+
export function painterlyStageNames(options: IPainterlyOptions): readonly string[] {
|
|
46
|
+
const names: string[] = [];
|
|
47
|
+
if (options.outlineEnabled === true) names.push("outline");
|
|
48
|
+
if (options.kuwaharaEnabled === true) names.push("kuwahara");
|
|
49
|
+
if (options.watercolorEnabled === true) names.push("watercolor");
|
|
50
|
+
return names;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* The complete authored graph, dormant stages included.
|
|
55
|
+
*
|
|
56
|
+
* All three are always defined even when only one is requested, because `watercolor after
|
|
57
|
+
* kuwahara` and `kuwahara after outline` are anchors that must keep naming a stage that exists —
|
|
58
|
+
* otherwise enabling one stage on its own resolves against a name the chain never heard of.
|
|
59
|
+
*/
|
|
60
|
+
export function painterlyStages(
|
|
61
|
+
options: IPainterlyOptions,
|
|
62
|
+
): (context: IWorldEnvironmentStageContext) => readonly ChainStage[] {
|
|
63
|
+
return ({ depthNode }) => [
|
|
64
|
+
createOutlineStage({
|
|
65
|
+
depthNode,
|
|
66
|
+
depthWeight: options.outlineDepthWeight ?? 0.65,
|
|
67
|
+
inkColor: options.outlineInkColor ?? 0x142331,
|
|
68
|
+
softness: options.outlineSoftness ?? 0.16,
|
|
69
|
+
strength: options.outlineStrength ?? 0.8,
|
|
70
|
+
threshold: options.outlineThreshold ?? 0.12,
|
|
71
|
+
}),
|
|
72
|
+
createKuwaharaStage({
|
|
73
|
+
anisotropy: options.kuwaharaAnisotropy ?? 0.72,
|
|
74
|
+
radius: options.kuwaharaRadius ?? 5,
|
|
75
|
+
resolutionScale: options.kuwaharaResolutionScale ?? 0.5,
|
|
76
|
+
strength: options.kuwaharaStrength ?? 0.82,
|
|
77
|
+
}),
|
|
78
|
+
createWatercolorStage({
|
|
79
|
+
levels: options.watercolorLevels ?? 8,
|
|
80
|
+
paperStrength: options.watercolorPaperStrength ?? 0.2,
|
|
81
|
+
shadowStrength: options.watercolorShadowStrength ?? 0.16,
|
|
82
|
+
shadowTint: options.watercolorShadowTint ?? 0x6d5a52,
|
|
83
|
+
strength: options.watercolorStrength ?? 0.72,
|
|
84
|
+
}),
|
|
85
|
+
];
|
|
86
|
+
}
|
|
@@ -1,9 +1,18 @@
|
|
|
1
1
|
// Generated for you. Keep the six palette roles coherent when you change the look.
|
|
2
2
|
export const palette = {
|
|
3
|
-
skyHigh:
|
|
4
|
-
skyLow:
|
|
5
|
-
floor:
|
|
6
|
-
player:
|
|
7
|
-
crate:
|
|
8
|
-
accent:
|
|
3
|
+
skyHigh: 0x8fd5cf,
|
|
4
|
+
skyLow: 0x28556a,
|
|
5
|
+
floor: 0x67c878,
|
|
6
|
+
player: 0xfff0b0,
|
|
7
|
+
crate: 0xd86f55,
|
|
8
|
+
accent: 0xe6c58d,
|
|
9
9
|
} as const;
|
|
10
|
+
|
|
11
|
+
export const COAST_WAVES = [
|
|
12
|
+
{ amplitude: 0.12, direction: [1, 0.2] as const, speed: 0.52, wavelength: 7.2 },
|
|
13
|
+
{ amplitude: 0.055, detail: true, direction: [-0.35, 1] as const, speed: 0.3, wavelength: 3.3 },
|
|
14
|
+
] as const;
|
|
15
|
+
|
|
16
|
+
export const COAST_DOMAIN_WARP = [
|
|
17
|
+
{ amplitude: 0.12, direction: [0.65, -0.35] as const, speed: 0.18, wavelength: 11 },
|
|
18
|
+
] as const;
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js geometry — edit or delete it freely.
|
|
2
|
+
import { BufferGeometry, Float32BufferAttribute, Vector2, Vector3 } from "three";
|
|
3
|
+
|
|
4
|
+
const DIVISIONS = 8;
|
|
5
|
+
|
|
6
|
+
/** Preserve an authored triangle's silhouette and UVs while giving cloth enough vertices to bend. */
|
|
7
|
+
export function tessellatePennant(source: BufferGeometry): BufferGeometry {
|
|
8
|
+
const position = source.getAttribute("position");
|
|
9
|
+
const uv = source.getAttribute("uv");
|
|
10
|
+
if (position === undefined || position.count !== 3)
|
|
11
|
+
throw new Error("Starter pennant must be one authored triangle.");
|
|
12
|
+
if (uv === undefined || uv.count !== 3) throw new Error("Starter pennant must have three UVs.");
|
|
13
|
+
const corners = [0, 1, 2].map(
|
|
14
|
+
(index) => new Vector3(position.getX(index), position.getY(index), position.getZ(index)),
|
|
15
|
+
);
|
|
16
|
+
const texels = [0, 1, 2].map((index) => new Vector2(uv.getX(index), uv.getY(index)));
|
|
17
|
+
const positions: number[] = [];
|
|
18
|
+
const uvs: number[] = [];
|
|
19
|
+
const emit = (row: number, column: number): void => {
|
|
20
|
+
const alongB = row / DIVISIONS;
|
|
21
|
+
const alongC = column / DIVISIONS;
|
|
22
|
+
const alongA = 1 - alongB - alongC;
|
|
23
|
+
const a = corners[0] as Vector3;
|
|
24
|
+
const b = corners[1] as Vector3;
|
|
25
|
+
const c = corners[2] as Vector3;
|
|
26
|
+
const uvA = texels[0] as Vector2;
|
|
27
|
+
const uvB = texels[1] as Vector2;
|
|
28
|
+
const uvC = texels[2] as Vector2;
|
|
29
|
+
positions.push(
|
|
30
|
+
a.x * alongA + b.x * alongB + c.x * alongC,
|
|
31
|
+
a.y * alongA + b.y * alongB + c.y * alongC,
|
|
32
|
+
a.z * alongA + b.z * alongB + c.z * alongC,
|
|
33
|
+
);
|
|
34
|
+
uvs.push(
|
|
35
|
+
uvA.x * alongA + uvB.x * alongB + uvC.x * alongC,
|
|
36
|
+
uvA.y * alongA + uvB.y * alongB + uvC.y * alongC,
|
|
37
|
+
);
|
|
38
|
+
};
|
|
39
|
+
for (let row = 0; row < DIVISIONS; row += 1) {
|
|
40
|
+
for (let column = 0; column < DIVISIONS - row; column += 1) {
|
|
41
|
+
emit(row, column);
|
|
42
|
+
emit(row + 1, column);
|
|
43
|
+
emit(row, column + 1);
|
|
44
|
+
if (row + column >= DIVISIONS - 1) continue;
|
|
45
|
+
emit(row + 1, column);
|
|
46
|
+
emit(row + 1, column + 1);
|
|
47
|
+
emit(row, column + 1);
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
const geometry = new BufferGeometry();
|
|
51
|
+
geometry.setAttribute("position", new Float32BufferAttribute(positions, 3));
|
|
52
|
+
geometry.setAttribute("uv", new Float32BufferAttribute(uvs, 2));
|
|
53
|
+
return geometry;
|
|
54
|
+
}
|
|
@@ -1,18 +1,100 @@
|
|
|
1
1
|
// Generated for you: ordinary Three.js; ThreeNative does not read this file.
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
2
|
+
//
|
|
3
|
+
// This file wires two things together and decides nothing itself. `quality.ts`, in this folder,
|
|
4
|
+
// owns which stages run at which tier and records what each one measured. `WorldEnvironment`,
|
|
5
|
+
// also in this folder, builds them and prints `TN_WORLD_ENVIRONMENT` naming every stage as
|
|
6
|
+
// applied or refused **with a reason**, so a stage that silently no-op'd is never mistaken for
|
|
7
|
+
// one you turned off.
|
|
8
|
+
//
|
|
9
|
+
// To make the game cheaper or prettier everywhere, edit `quality.ts`. To force one tier for one
|
|
10
|
+
// run — a desktop that is dropping frames, a capture you want to compare — pass it:
|
|
11
|
+
// `setupPost(renderer, scene, camera, { tier: "low" })`. Overriding does not silence the report:
|
|
12
|
+
// `TN_QUALITY_TIER` names the tier that ran either way.
|
|
13
|
+
import type { Camera, DirectionalLight, Scene } from "three";
|
|
14
|
+
import {
|
|
15
|
+
type IAdaptiveQualityOptions,
|
|
16
|
+
type IQualityWindow,
|
|
17
|
+
createAdaptiveQuality,
|
|
18
|
+
formatQualityAdaptation,
|
|
19
|
+
} from "./adaptiveQuality.js";
|
|
20
|
+
import { painterlyStageNames, painterlyStages } from "./painterly.js";
|
|
21
|
+
import { type QualityTier, qualityPreset } from "./quality.js";
|
|
22
|
+
import { type OutputRenderer, WorldEnvironment } from "./worldEnvironment.js";
|
|
10
23
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
24
|
+
interface IPostController {
|
|
25
|
+
debug(): Record<string, unknown>;
|
|
26
|
+
observe(window: IQualityWindow): void;
|
|
27
|
+
dispose(): void;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
let active: IPostController | undefined;
|
|
31
|
+
|
|
32
|
+
/** The starter's game.ts connects its existing completed frame-window callback here. */
|
|
33
|
+
export function observeQualityWindow(window: IQualityWindow): void {
|
|
34
|
+
active?.observe(window);
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
export function setupPost(
|
|
38
|
+
renderer: OutputRenderer,
|
|
39
|
+
scene: Scene,
|
|
40
|
+
camera: Camera,
|
|
41
|
+
environment: IAdaptiveQualityOptions & {
|
|
42
|
+
godraysLight?: DirectionalLight;
|
|
43
|
+
mobile?: boolean;
|
|
44
|
+
/** Forces a tier while keeping its costs observed. Unknown names throw. */
|
|
45
|
+
tier?: QualityTier;
|
|
46
|
+
} = {},
|
|
47
|
+
): IPostController {
|
|
48
|
+
const policy = createAdaptiveQuality(environment, environment);
|
|
49
|
+
active?.dispose();
|
|
50
|
+
let disposed = false;
|
|
51
|
+
let disposeGraph: (() => void) | undefined;
|
|
52
|
+
let observation: Record<string, unknown> = {
|
|
53
|
+
tier: policy.tier,
|
|
54
|
+
source: policy.pinned ? "pinned" : "auto",
|
|
55
|
+
};
|
|
56
|
+
function apply(): void {
|
|
57
|
+
// Replacement is serialized: no old graph or subscription remains alive beside the new one.
|
|
58
|
+
disposeGraph?.();
|
|
59
|
+
const settings = qualityPreset(policy.tier);
|
|
60
|
+
const world = new WorldEnvironment({
|
|
61
|
+
...settings,
|
|
62
|
+
authoredStageNames: painterlyStageNames(settings),
|
|
63
|
+
authoredStages: painterlyStages(settings),
|
|
64
|
+
});
|
|
65
|
+
const applied = world.apply(renderer, scene, camera, {
|
|
66
|
+
godraysLight: environment.godraysLight,
|
|
67
|
+
});
|
|
68
|
+
disposeGraph = applied.dispose;
|
|
69
|
+
observation = { ...observation, stages: applied.stages, dropped: applied.dropped };
|
|
70
|
+
}
|
|
71
|
+
apply();
|
|
72
|
+
const source = environment.tier === undefined ? "platform" : "override";
|
|
73
|
+
console.info(
|
|
74
|
+
`TN_QUALITY_TIER ${policy.tier} mobile=${environment.mobile === true} source=${source}`,
|
|
75
|
+
);
|
|
76
|
+
const controller = {
|
|
77
|
+
debug: () => observation,
|
|
78
|
+
observe(window: IQualityWindow): void {
|
|
79
|
+
if (disposed) return;
|
|
80
|
+
const decision = policy.observe(window);
|
|
81
|
+
if (decision.changed) apply();
|
|
82
|
+
observation = {
|
|
83
|
+
stages: observation.stages,
|
|
84
|
+
dropped: observation.dropped,
|
|
85
|
+
...decision,
|
|
86
|
+
...(Number.isInteger(window.window) ? { window: window.window } : {}),
|
|
87
|
+
};
|
|
88
|
+
console.info(formatQualityAdaptation(decision));
|
|
89
|
+
},
|
|
90
|
+
dispose(): void {
|
|
91
|
+
if (disposed) return;
|
|
92
|
+
disposed = true;
|
|
93
|
+
disposeGraph?.();
|
|
94
|
+
disposeGraph = undefined;
|
|
95
|
+
if (active === controller) active = undefined;
|
|
96
|
+
},
|
|
97
|
+
};
|
|
98
|
+
active = controller;
|
|
99
|
+
return controller;
|
|
18
100
|
}
|
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
// Generated for you: ordinary Three.js; ThreeNative does not read this file. Delete or rewrite
|
|
2
|
+
// it freely — the tiers below are a starting point, not a framework look.
|
|
3
|
+
//
|
|
4
|
+
// This is the one place this game decides how expensive it looks. `postprocessing.ts` reads
|
|
5
|
+
// `qualityPreset(resolveQualityTier(...))` and nothing else, so "make it run on a phone" is one
|
|
6
|
+
// file to edit rather than a hunt through anonymous literals.
|
|
7
|
+
//
|
|
8
|
+
// **Where the numbers come from.** Every millisecond below is GPU time from the per-stage
|
|
9
|
+
// ablation recorded in the engine repository's `docs/verification/runtime-perf-state.md`: Chrome
|
|
10
|
+
// on an RTX 2080, 1600x900, static build, `gpuMs` read from three's `timestamp-query`. In that
|
|
11
|
+
// scene the whole five-stage chain costs **12.5 ms of a 14.7 ms GPU frame**, and the same frame
|
|
12
|
+
// with every stage off costs **2.2 ms**. The per-stage figures oversum — removing SSGI also
|
|
13
|
+
// removes the denoise passes the later stages sample — so read each as *what turning this one off
|
|
14
|
+
// gave back*, not as a share of a partition. A stage nobody has ablated on its own says
|
|
15
|
+
// `unmeasured` rather than guessing, and your scene is not that scene: read `TN_FRAME_BUDGET`
|
|
16
|
+
// back after you change a tier.
|
|
17
|
+
//
|
|
18
|
+
// One cost that is **not** a stage here and outweighs most of them: the prefiltered reflection
|
|
19
|
+
// probe on `scene.environment`, measured at **~6.3 ms of an 18-19 ms Pixel 8 frame**. It is set
|
|
20
|
+
// in `sky.ts`, not in this file.
|
|
21
|
+
//
|
|
22
|
+
import type { IPainterlyOptions } from "./painterly.js";
|
|
23
|
+
import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* A preset is the framework's chain options plus this kit's own painterly knobs. The two are
|
|
27
|
+
* separate types because they belong to different layers: `worldEnvironment.ts` is shared with
|
|
28
|
+
* every other kit and must not know what a watercolour is.
|
|
29
|
+
*/
|
|
30
|
+
type QualitySettings = IWorldEnvironmentOptions & IPainterlyOptions;
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* The three names this game's look comes in.
|
|
34
|
+
*
|
|
35
|
+
* `low` is what a phone gets and `high` what a desktop gets — those two are this template's
|
|
36
|
+
* shipped looks, unchanged. `medium` is the rung in between for a machine that is neither: a
|
|
37
|
+
* laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
|
|
38
|
+
* what any of them mean.
|
|
39
|
+
*/
|
|
40
|
+
export type QualityTier = "low" | "medium" | "high";
|
|
41
|
+
|
|
42
|
+
const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
|
|
46
|
+
* `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
|
|
47
|
+
*/
|
|
48
|
+
function isQualityTier(value: string): value is QualityTier {
|
|
49
|
+
return (QUALITY_TIERS as readonly string[]).includes(value);
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
|
|
54
|
+
*
|
|
55
|
+
* Fails closed. An unrecognised tier name throws with the value it was handed rather than
|
|
56
|
+
* quietly rendering the default, because a silent fallback here looks exactly like a tier that
|
|
57
|
+
* turned out to have no effect.
|
|
58
|
+
*/
|
|
59
|
+
export function resolveQualityTier(
|
|
60
|
+
request: { readonly mobile?: boolean; readonly tier?: string } = {},
|
|
61
|
+
): QualityTier {
|
|
62
|
+
const requested = request.tier;
|
|
63
|
+
if (requested !== undefined) {
|
|
64
|
+
if (!isQualityTier(requested)) {
|
|
65
|
+
throw new Error(
|
|
66
|
+
`Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
67
|
+
);
|
|
68
|
+
}
|
|
69
|
+
return requested;
|
|
70
|
+
}
|
|
71
|
+
return request.mobile === true ? "low" : "high";
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* What a desktop gets: a clean coastal look with restrained painterly treatment. The expensive
|
|
76
|
+
* screen-space gathers are deliberately off here: on a small water scene they muddy the grass and
|
|
77
|
+
* turn the water glint into a halo instead of adding useful depth.
|
|
78
|
+
*/
|
|
79
|
+
const high: QualitySettings = {
|
|
80
|
+
// Bloom cost: unmeasured for this authored scene; the low strength keeps water glints alive
|
|
81
|
+
// without washing the scene in orange.
|
|
82
|
+
bloomEnabled: true,
|
|
83
|
+
bloomRadius: 0.34,
|
|
84
|
+
bloomStrength: 0.26,
|
|
85
|
+
bloomThreshold: 0.64,
|
|
86
|
+
denoiseEnabled: false,
|
|
87
|
+
exposure: 1.04,
|
|
88
|
+
ssgiEnabled: false,
|
|
89
|
+
ssrEnabled: false,
|
|
90
|
+
sharpenEnabled: false,
|
|
91
|
+
// Outline cost: unmeasured; it is intentionally a soft blue-green edge, not a black
|
|
92
|
+
// comic-book stroke.
|
|
93
|
+
outlineEnabled: true,
|
|
94
|
+
outlineDepthWeight: 0.32,
|
|
95
|
+
outlineInkColor: 0x173c4a,
|
|
96
|
+
outlineSoftness: 0.08,
|
|
97
|
+
outlineStrength: 0.3,
|
|
98
|
+
outlineThreshold: 0.2,
|
|
99
|
+
// Kuwahara cost: unmeasured; the half-resolution scratch and restrained strength preserve
|
|
100
|
+
// readable grass silhouettes.
|
|
101
|
+
kuwaharaEnabled: true,
|
|
102
|
+
kuwaharaRadius: 5,
|
|
103
|
+
kuwaharaResolutionScale: 0.5,
|
|
104
|
+
kuwaharaStrength: 0.2,
|
|
105
|
+
// Watercolour cost: unmeasured; the low mix keeps the paper grouping from flattening the coast.
|
|
106
|
+
watercolorEnabled: true,
|
|
107
|
+
watercolorPaperStrength: 0.05,
|
|
108
|
+
watercolorShadowStrength: 0.04,
|
|
109
|
+
watercolorShadowTint: 0x7d6b62,
|
|
110
|
+
watercolorStrength: 0.26,
|
|
111
|
+
renderChainTier: "high",
|
|
112
|
+
tonemapMode: "aces",
|
|
113
|
+
};
|
|
114
|
+
|
|
115
|
+
/**
|
|
116
|
+
* Medium keeps the same readable coast, with a smaller paint radius and a little less colour
|
|
117
|
+
* grouping for machines that need a cheaper frame.
|
|
118
|
+
*/
|
|
119
|
+
const medium: QualitySettings = {
|
|
120
|
+
// Bloom cost: unmeasured for this authored scene; keep only a small highlight lift.
|
|
121
|
+
bloomEnabled: true,
|
|
122
|
+
bloomRadius: 0.3,
|
|
123
|
+
bloomStrength: 0.22,
|
|
124
|
+
bloomThreshold: 0.68,
|
|
125
|
+
denoiseEnabled: false,
|
|
126
|
+
exposure: 1.03,
|
|
127
|
+
ssgiEnabled: false,
|
|
128
|
+
ssrEnabled: false,
|
|
129
|
+
sharpenEnabled: false,
|
|
130
|
+
// Outline cost: unmeasured; keep its edge narrow on the cheaper tier.
|
|
131
|
+
outlineEnabled: true,
|
|
132
|
+
outlineDepthWeight: 0.28,
|
|
133
|
+
outlineInkColor: 0x173c4a,
|
|
134
|
+
outlineSoftness: 0.08,
|
|
135
|
+
outlineStrength: 0.26,
|
|
136
|
+
outlineThreshold: 0.22,
|
|
137
|
+
// Kuwahara cost: unmeasured; radius three keeps the water and grass readable.
|
|
138
|
+
kuwaharaEnabled: true,
|
|
139
|
+
kuwaharaRadius: 3,
|
|
140
|
+
kuwaharaResolutionScale: 0.5,
|
|
141
|
+
kuwaharaStrength: 0.16,
|
|
142
|
+
// Watercolour cost: unmeasured; fewer bands and a low mix preserve the coast's value steps.
|
|
143
|
+
watercolorEnabled: true,
|
|
144
|
+
watercolorLevels: 6,
|
|
145
|
+
watercolorPaperStrength: 0.04,
|
|
146
|
+
watercolorShadowStrength: 0.03,
|
|
147
|
+
watercolorShadowTint: 0x7d6b62,
|
|
148
|
+
watercolorStrength: 0.22,
|
|
149
|
+
renderChainTier: "medium",
|
|
150
|
+
tonemapMode: "aces",
|
|
151
|
+
};
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* What a phone gets: the cleanest version of the coastal look. Authored paint is omitted to keep
|
|
155
|
+
* the water mesh and touch controls responsive.
|
|
156
|
+
*/
|
|
157
|
+
const low: QualitySettings = {
|
|
158
|
+
// Bloom cost: unmeasured for this authored scene; this is the phone-safe highlight lift.
|
|
159
|
+
bloomEnabled: true,
|
|
160
|
+
bloomRadius: 0.28,
|
|
161
|
+
bloomStrength: 0.18,
|
|
162
|
+
bloomThreshold: 0.72,
|
|
163
|
+
exposure: 1.02,
|
|
164
|
+
sharpenEnabled: false,
|
|
165
|
+
// The low tier omits authored paint by name: no outline, scratch target, or paper graph is
|
|
166
|
+
// built on the phone path.
|
|
167
|
+
outlineEnabled: false,
|
|
168
|
+
kuwaharaEnabled: false,
|
|
169
|
+
watercolorEnabled: false,
|
|
170
|
+
renderChainTier: "low",
|
|
171
|
+
tonemapMode: "aces",
|
|
172
|
+
};
|
|
173
|
+
|
|
174
|
+
const QUALITY_PRESETS: Record<QualityTier, QualitySettings> = { high, low, medium };
|
|
175
|
+
|
|
176
|
+
/** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
|
|
177
|
+
export function qualityPreset(tier: string): QualitySettings {
|
|
178
|
+
const preset = QUALITY_PRESETS[tier as QualityTier];
|
|
179
|
+
if (preset === undefined) {
|
|
180
|
+
throw new Error(
|
|
181
|
+
`Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
182
|
+
);
|
|
183
|
+
}
|
|
184
|
+
return preset;
|
|
185
|
+
}
|