create-threenative 0.2.3 → 0.2.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +53 -2
- package/agent-docs/references/assertion-reference.md +173 -6
- package/agent-docs/references/capability-reference.md +1303 -99
- package/agent-docs/references/capture-the-frame.md +7 -0
- package/agent-docs/references/creating-creatures.md +215 -0
- package/agent-docs/references/ctx-cookbook.md +69 -0
- package/agent-docs/references/debug-surface.md +8 -3
- package/agent-docs/references/dream-loop.md +150 -0
- package/agent-docs/references/finding-assets.md +70 -2
- package/agent-docs/references/sculpt-from-a-reference.md +3 -2
- package/agent-docs/references/trace-a-slow-frame.md +99 -0
- package/agent-docs/references/visual-baseline.md +41 -0
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
- package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
- package/agent-files/.agents/skills/threenative-builder/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
- package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
- package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
- package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
- package/agent-files/.agents/skills/threenative-verifier/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
- package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
- package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
- package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
- package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
- package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
- package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
- package/agent-files/scripts/reference.mjs +705 -0
- package/agent-files/scripts/visual-loop.mjs +382 -0
- package/capabilities.json +1881 -131
- package/dist/index.d.ts +39 -6
- package/dist/index.js +297 -32
- package/dist/threenative.js +822 -105
- package/package.json +30 -5
- package/template-assets/loading.ts +12 -2
- package/template-assets/patches/three@0.185.1.patch +249 -14
- package/template-assets/worldEnvironment.ts +758 -0
- package/templates/action-rpg/.codex/config.toml +4 -0
- package/templates/action-rpg/.cursor/mcp.json +32 -0
- package/templates/action-rpg/.gemini/settings.json +32 -0
- package/templates/action-rpg/.mcp.json +15 -3
- package/templates/action-rpg/.vscode/mcp.json +36 -0
- package/templates/action-rpg/.zed/settings.json +36 -0
- package/templates/action-rpg/AGENTS.md +69 -378
- package/templates/action-rpg/CLAUDE.md +69 -378
- package/templates/action-rpg/opencode.json +41 -0
- package/templates/action-rpg/package.json +7 -7
- package/templates/action-rpg/playtests/combat.playtest.json +9 -0
- package/templates/action-rpg/playtests/performance.playtest.json +24 -7
- package/templates/action-rpg/playtests/survives.playtest.json +27 -0
- package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
- package/templates/action-rpg/src/conventions.ts +35 -0
- package/templates/action-rpg/src/entities/Enemy.ts +2 -3
- package/templates/action-rpg/src/entities/Player.ts +20 -3
- package/templates/action-rpg/src/render/camera.ts +7 -2
- package/templates/action-rpg/src/render/lighting.ts +5 -3
- package/templates/action-rpg/src/render/loading.ts +12 -2
- package/templates/action-rpg/src/render/materials.ts +11 -0
- package/templates/action-rpg/src/render/palette.ts +10 -3
- package/templates/action-rpg/src/render/postprocessing.ts +21 -58
- package/templates/action-rpg/src/render/quality.ts +170 -0
- package/templates/action-rpg/src/render/shapes.ts +185 -26
- package/templates/action-rpg/src/render/touch-controls.ts +185 -0
- package/templates/action-rpg/src/render/vfx.ts +257 -0
- package/templates/action-rpg/src/render/worldEnvironment.ts +208 -33
- package/templates/action-rpg/src/scenes/Play.ts +43 -6
- package/templates/action-rpg/src/style.css +20 -0
- package/templates/action-rpg/threenative.config.ts +7 -0
- package/templates/defense/.codex/config.toml +4 -0
- package/templates/defense/.cursor/mcp.json +32 -0
- package/templates/defense/.gemini/settings.json +32 -0
- package/templates/defense/.mcp.json +15 -3
- package/templates/defense/.vscode/mcp.json +36 -0
- package/templates/defense/.zed/settings.json +36 -0
- package/templates/defense/AGENTS.md +62 -385
- package/templates/defense/CLAUDE.md +62 -385
- package/templates/defense/opencode.json +41 -0
- package/templates/defense/package.json +7 -7
- package/templates/defense/playtests/performance.playtest.json +24 -7
- package/templates/defense/playtests/pointer-placement.playtest.json +87 -20
- package/templates/defense/playtests/scan.playtest.json +1 -1
- package/templates/defense/playtests/survive.playtest.json +14 -0
- package/templates/defense/src/attackers/Attacker.ts +4 -4
- package/templates/defense/src/board/Route.ts +22 -8
- package/templates/defense/src/conventions.ts +18 -0
- package/templates/defense/src/entities/Player.ts +11 -3
- package/templates/defense/src/game.ts +2 -3
- package/templates/defense/src/physics.ts +9 -39
- package/templates/defense/src/placement/Buildable.ts +4 -4
- package/templates/defense/src/render/camera.ts +9 -3
- package/templates/defense/src/render/loading.ts +12 -2
- package/templates/defense/src/render/materials.ts +9 -0
- package/templates/defense/src/render/palette.ts +12 -5
- package/templates/defense/src/render/postprocessing.ts +21 -58
- package/templates/defense/src/render/quality.ts +170 -0
- package/templates/defense/src/render/shapes.ts +142 -23
- package/templates/defense/src/render/sky.ts +2 -2
- package/templates/defense/src/render/worldEnvironment.ts +208 -33
- package/templates/defense/src/scenes/Boot.ts +2 -2
- package/templates/defense/src/scenes/Defense.ts +13 -6
- package/templates/defense/src/style.css +20 -0
- package/templates/defense/src/towers/Tower.ts +11 -12
- package/templates/defense/src/towers/targeting.ts +1 -1
- package/templates/defense/src/ui/App.tsx +2 -2
- package/templates/defense/threenative.config.ts +7 -0
- package/templates/minimal/.codex/config.toml +4 -0
- package/templates/minimal/.cursor/mcp.json +32 -0
- package/templates/minimal/.gemini/settings.json +32 -0
- package/templates/minimal/.mcp.json +15 -3
- package/templates/minimal/.vscode/mcp.json +36 -0
- package/templates/minimal/.zed/settings.json +36 -0
- package/templates/minimal/AGENTS.md +76 -485
- package/templates/minimal/CLAUDE.md +76 -485
- package/templates/minimal/opencode.json +41 -0
- package/templates/minimal/package.json +6 -6
- package/templates/minimal/playtests/play.playtest.json +2 -1
- package/templates/minimal/playtests/survives.playtest.json +48 -4
- package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
- package/templates/minimal/src/conventions.ts +18 -0
- package/templates/minimal/src/entities/Player.ts +39 -6
- package/templates/minimal/src/main.ts +14 -4
- package/templates/minimal/src/render/materials.ts +7 -0
- package/templates/minimal/src/render/palette.ts +3 -3
- package/templates/minimal/src/render/postprocessing.ts +17 -56
- package/templates/minimal/src/render/quality.ts +162 -0
- package/templates/minimal/src/render/sky.ts +23 -9
- package/templates/minimal/src/render/touch-controls.ts +165 -0
- package/templates/minimal/src/render/worldEnvironment.ts +208 -33
- package/templates/minimal/src/scenes/Play.ts +47 -11
- package/templates/minimal/src/style.css +20 -0
- package/templates/minimal/threenative.config.ts +7 -0
- package/templates/platformer/.codex/config.toml +4 -0
- package/templates/platformer/.cursor/mcp.json +32 -0
- package/templates/platformer/.gemini/settings.json +32 -0
- package/templates/platformer/.mcp.json +15 -3
- package/templates/platformer/.vscode/mcp.json +36 -0
- package/templates/platformer/.zed/settings.json +36 -0
- package/templates/platformer/AGENTS.md +70 -430
- package/templates/platformer/CLAUDE.md +70 -430
- package/templates/platformer/opencode.json +41 -0
- package/templates/platformer/package.json +7 -7
- package/templates/platformer/playtests/oneway.playtest.json +29 -2
- package/templates/platformer/playtests/performance.playtest.json +2 -1
- package/templates/platformer/playtests/survives.playtest.json +31 -0
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +3 -0
- package/templates/platformer/playtests/touch-controls-web.playtest.json +15 -4
- package/templates/platformer/src/conventions.ts +18 -0
- package/templates/platformer/src/entities/Character.ts +63 -1
- package/templates/platformer/src/game.ts +3 -1
- package/templates/platformer/src/level/Platform.ts +13 -1
- package/templates/platformer/src/render/lighting.ts +7 -4
- package/templates/platformer/src/render/loading.ts +12 -2
- package/templates/platformer/src/render/palette.ts +4 -1
- package/templates/platformer/src/render/postprocessing.ts +32 -57
- package/templates/platformer/src/render/quality.ts +170 -0
- package/templates/platformer/src/render/worldEnvironment.ts +208 -33
- package/templates/platformer/src/scenes/Level.ts +52 -12
- package/templates/platformer/src/style.css +20 -0
- package/templates/platformer/threenative.config.ts +7 -0
- package/templates/puzzle/.codex/config.toml +19 -0
- package/templates/puzzle/.cursor/mcp.json +32 -0
- package/templates/puzzle/.gemini/settings.json +32 -0
- package/templates/puzzle/.mcp.json +32 -0
- package/templates/puzzle/.vscode/mcp.json +36 -0
- package/templates/puzzle/.zed/settings.json +36 -0
- package/templates/puzzle/AGENTS.md +96 -0
- package/templates/puzzle/CLAUDE.md +98 -0
- package/templates/puzzle/README.md +43 -0
- package/templates/puzzle/index.html +12 -0
- package/templates/puzzle/kit.json +7 -0
- package/templates/puzzle/opencode.json +41 -0
- package/templates/puzzle/package.json +50 -0
- package/templates/puzzle/playtests/carry.playtest.json +71 -0
- package/templates/puzzle/playtests/performance.playtest.json +23 -0
- package/templates/puzzle/playtests/survives.playtest.json +51 -0
- package/templates/puzzle/playtests/swing.playtest.json +38 -0
- package/templates/puzzle/public/favicon.svg +5 -0
- package/templates/puzzle/src/conventions.ts +25 -0
- package/templates/puzzle/src/entities/Ball.ts +70 -0
- package/templates/puzzle/src/entities/Crate.ts +76 -0
- package/templates/puzzle/src/entities/Gripper.ts +69 -0
- package/templates/puzzle/src/entities/Pendulum.ts +89 -0
- package/templates/puzzle/src/game.ts +48 -0
- package/templates/puzzle/src/main.ts +15 -0
- package/templates/puzzle/src/physics.ts +19 -0
- package/templates/puzzle/src/render/camera.ts +37 -0
- package/templates/puzzle/src/render/lighting.ts +55 -0
- package/templates/puzzle/src/render/loading.ts +325 -0
- package/templates/puzzle/src/render/materials.ts +28 -0
- package/templates/puzzle/src/render/palette.ts +31 -0
- package/templates/puzzle/src/render/postprocessing.ts +34 -0
- package/templates/puzzle/src/render/quality.ts +170 -0
- package/templates/puzzle/src/render/shapes.ts +134 -0
- package/templates/puzzle/src/render/sky.ts +16 -0
- package/templates/puzzle/src/render/touch-controls.ts +185 -0
- package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
- package/templates/puzzle/src/room.ts +83 -0
- package/templates/puzzle/src/scenes/Boot.ts +12 -0
- package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
- package/templates/puzzle/src/state.ts +30 -0
- package/templates/puzzle/src/style.css +96 -0
- package/templates/puzzle/src/ui/App.tsx +22 -0
- package/templates/puzzle/src/ui/GameUi.tsx +20 -0
- package/templates/puzzle/src/ui/Hud.tsx +57 -0
- package/templates/puzzle/src/ui/Menu.tsx +7 -0
- package/templates/puzzle/src/ui/main.tsx +14 -0
- package/templates/puzzle/tailwind.config.ts +1 -0
- package/templates/puzzle/threenative.config.ts +49 -0
- package/templates/puzzle/tsconfig.json +17 -0
- package/templates/puzzle/vite.config.ts +38 -0
- package/templates/racing/.codex/config.toml +4 -0
- package/templates/racing/.cursor/mcp.json +32 -0
- package/templates/racing/.gemini/settings.json +32 -0
- package/templates/racing/.mcp.json +15 -3
- package/templates/racing/.vscode/mcp.json +36 -0
- package/templates/racing/.zed/settings.json +36 -0
- package/templates/racing/AGENTS.md +63 -379
- package/templates/racing/CLAUDE.md +63 -379
- package/templates/racing/native-playtests/survives.playtest.json +43 -0
- package/templates/racing/opencode.json +41 -0
- package/templates/racing/package.json +8 -7
- package/templates/racing/playtests/performance.playtest.json +24 -7
- package/templates/racing/playtests/survives.playtest.json +36 -4
- package/templates/racing/playtests/touch-controls.playtest.json +41 -0
- package/templates/racing/src/conventions.ts +6 -0
- package/templates/racing/src/entities/RacingCar.ts +16 -4
- package/templates/racing/src/entities/Rival.ts +5 -2
- package/templates/racing/src/render/camera.ts +7 -4
- package/templates/racing/src/render/lighting.ts +22 -13
- package/templates/racing/src/render/loading.ts +12 -2
- package/templates/racing/src/render/materials.ts +54 -4
- package/templates/racing/src/render/palette.ts +23 -6
- package/templates/racing/src/render/postprocessing.ts +21 -58
- package/templates/racing/src/render/quality.ts +170 -0
- package/templates/racing/src/render/shapes.ts +537 -26
- package/templates/racing/src/render/sky.ts +5 -2
- package/templates/racing/src/render/touch-controls.ts +185 -0
- package/templates/racing/src/render/worldEnvironment.ts +208 -33
- package/templates/racing/src/scenes/Race.ts +17 -2
- package/templates/racing/src/style.css +20 -0
- package/templates/racing/src/track/Track.ts +270 -31
- package/templates/racing/threenative.config.ts +7 -0
- package/templates/runner/.codex/config.toml +19 -0
- package/templates/runner/.cursor/mcp.json +32 -0
- package/templates/runner/.gemini/settings.json +32 -0
- package/templates/runner/.mcp.json +32 -0
- package/templates/runner/.vscode/mcp.json +36 -0
- package/templates/runner/.zed/settings.json +36 -0
- package/templates/runner/AGENTS.md +96 -0
- package/templates/runner/CLAUDE.md +98 -0
- package/templates/runner/README.md +43 -0
- package/templates/runner/index.html +12 -0
- package/templates/runner/kit.json +7 -0
- package/templates/runner/opencode.json +41 -0
- package/templates/runner/package.json +50 -0
- package/templates/runner/playtests/performance.playtest.json +23 -0
- package/templates/runner/playtests/streams.playtest.json +38 -0
- package/templates/runner/playtests/survives.playtest.json +51 -0
- package/templates/runner/public/favicon.svg +5 -0
- package/templates/runner/src/conventions.ts +24 -0
- package/templates/runner/src/entities/Runner.ts +135 -0
- package/templates/runner/src/game.ts +50 -0
- package/templates/runner/src/main.ts +15 -0
- package/templates/runner/src/physics.ts +13 -0
- package/templates/runner/src/render/camera.ts +39 -0
- package/templates/runner/src/render/dust.ts +131 -0
- package/templates/runner/src/render/lighting.ts +57 -0
- package/templates/runner/src/render/loading.ts +325 -0
- package/templates/runner/src/render/materials.ts +27 -0
- package/templates/runner/src/render/palette.ts +30 -0
- package/templates/runner/src/render/postprocessing.ts +34 -0
- package/templates/runner/src/render/quality.ts +170 -0
- package/templates/runner/src/render/shapes.ts +68 -0
- package/templates/runner/src/render/sky.ts +51 -0
- package/templates/runner/src/render/touch-controls.ts +185 -0
- package/templates/runner/src/render/worldEnvironment.ts +758 -0
- package/templates/runner/src/scenes/Boot.ts +12 -0
- package/templates/runner/src/scenes/Run.ts +142 -0
- package/templates/runner/src/state.ts +29 -0
- package/templates/runner/src/style.css +96 -0
- package/templates/runner/src/track.ts +176 -0
- package/templates/runner/src/ui/App.tsx +22 -0
- package/templates/runner/src/ui/GameUi.tsx +20 -0
- package/templates/runner/src/ui/Hud.tsx +55 -0
- package/templates/runner/src/ui/Menu.tsx +7 -0
- package/templates/runner/src/ui/main.tsx +14 -0
- package/templates/runner/tailwind.config.ts +1 -0
- package/templates/runner/threenative.config.ts +49 -0
- package/templates/runner/tsconfig.json +17 -0
- package/templates/runner/vite.config.ts +38 -0
- package/templates/sailing/.codex/config.toml +4 -0
- package/templates/sailing/.cursor/mcp.json +32 -0
- package/templates/sailing/.gemini/settings.json +32 -0
- package/templates/sailing/.mcp.json +15 -3
- package/templates/sailing/.vscode/mcp.json +36 -0
- package/templates/sailing/.zed/settings.json +36 -0
- package/templates/sailing/AGENTS.md +62 -355
- package/templates/sailing/CLAUDE.md +62 -355
- package/templates/sailing/README.md +12 -9
- package/templates/sailing/native-playtests/float.playtest.json +55 -0
- package/templates/sailing/native-playtests/survives.playtest.json +20 -3
- package/templates/sailing/opencode.json +41 -0
- package/templates/sailing/package.json +8 -8
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
- package/templates/sailing/playtests/float.playtest.json +59 -0
- package/templates/sailing/playtests/performance.playtest.json +21 -6
- package/templates/sailing/playtests/survives.playtest.json +8 -0
- package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
- package/templates/sailing/src/conventions.ts +8 -0
- package/templates/sailing/src/entities/Ship.ts +150 -13
- package/templates/sailing/src/render/camera.ts +15 -8
- package/templates/sailing/src/render/lighting.ts +10 -5
- package/templates/sailing/src/render/loading.ts +12 -2
- package/templates/sailing/src/render/materials.ts +24 -8
- package/templates/sailing/src/render/ocean.ts +179 -0
- package/templates/sailing/src/render/palette.ts +14 -21
- package/templates/sailing/src/render/postprocessing.ts +23 -22
- package/templates/sailing/src/render/props.ts +584 -34
- package/templates/sailing/src/render/quality.ts +140 -0
- package/templates/sailing/src/render/sky.ts +8 -3
- package/templates/sailing/src/render/touch-controls.ts +142 -0
- package/templates/sailing/src/render/worldEnvironment.ts +206 -38
- package/templates/sailing/src/scenes/Sailing.ts +43 -16
- package/templates/sailing/src/style.css +20 -0
- package/templates/sailing/threenative.config.ts +7 -1
- package/templates/shooter/.codex/config.toml +4 -0
- package/templates/shooter/.cursor/mcp.json +32 -0
- package/templates/shooter/.gemini/settings.json +32 -0
- package/templates/shooter/.mcp.json +15 -3
- package/templates/shooter/.vscode/mcp.json +36 -0
- package/templates/shooter/.zed/settings.json +36 -0
- package/templates/shooter/AGENTS.md +76 -415
- package/templates/shooter/CLAUDE.md +76 -415
- package/templates/shooter/kit.json +2 -2
- package/templates/shooter/opencode.json +41 -0
- package/templates/shooter/package.json +7 -7
- package/templates/shooter/playtests/combat.playtest.json +48 -0
- package/templates/shooter/playtests/input-control.playtest.json +165 -35
- package/templates/shooter/playtests/per-item.playtest.json +3 -3
- package/templates/shooter/playtests/performance.playtest.json +24 -7
- package/templates/shooter/playtests/shooter.playtest.json +13 -7
- package/templates/shooter/playtests/survives.playtest.json +27 -0
- package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
- package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
- package/templates/shooter/src/combat/damage.ts +1 -2
- package/templates/shooter/src/conventions.ts +51 -0
- package/templates/shooter/src/entities/Player.ts +235 -18
- package/templates/shooter/src/entities/Target.ts +2 -2
- package/templates/shooter/src/game.ts +13 -4
- package/templates/shooter/src/render/camera.ts +49 -39
- package/templates/shooter/src/render/decals.ts +211 -0
- package/templates/shooter/src/render/lighting.ts +7 -3
- package/templates/shooter/src/render/loading.ts +12 -2
- package/templates/shooter/src/render/materials.ts +56 -3
- package/templates/shooter/src/render/palette.ts +6 -3
- package/templates/shooter/src/render/postprocessing.ts +21 -58
- package/templates/shooter/src/render/quality.ts +170 -0
- package/templates/shooter/src/render/scale.ts +22 -0
- package/templates/shooter/src/render/shapes.ts +343 -62
- package/templates/shooter/src/render/sky.ts +5 -1
- package/templates/shooter/src/render/touch-controls.ts +305 -0
- package/templates/shooter/src/render/ui.css +85 -0
- package/templates/shooter/src/render/ui.ts +19 -3
- package/templates/shooter/src/render/vfx.ts +215 -0
- package/templates/shooter/src/render/worldEnvironment.ts +208 -33
- package/templates/shooter/src/scenes/Play.ts +171 -56
- package/templates/shooter/src/state.ts +5 -0
- package/templates/shooter/src/style.css +20 -0
- package/templates/shooter/src/ui/Crosshair.tsx +25 -0
- package/templates/shooter/src/ui/GameUi.tsx +2 -0
- package/templates/shooter/src/ui/Hud.tsx +7 -1
- package/templates/shooter/src/weapons/Hitscan.ts +3 -4
- package/templates/shooter/src/weapons/Projectile.ts +8 -3
- package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
- package/templates/shooter/threenative.config.ts +7 -0
- package/templates/starter/.codex/config.toml +4 -0
- package/templates/starter/.cursor/mcp.json +32 -0
- package/templates/starter/.gemini/settings.json +32 -0
- package/templates/starter/.mcp.json +15 -3
- package/templates/starter/.vscode/mcp.json +36 -0
- package/templates/starter/.zed/settings.json +36 -0
- package/templates/starter/AGENTS.md +70 -527
- package/templates/starter/CLAUDE.md +70 -527
- package/templates/starter/native-playtests/render-chain.playtest.json +73 -4
- package/templates/starter/opencode.json +41 -0
- package/templates/starter/package.json +7 -7
- package/templates/starter/playtests/boot-failure.playtest.json +45 -0
- package/templates/starter/playtests/look.playtest.json +110 -6
- package/templates/starter/playtests/play.playtest.json +3 -2
- package/templates/starter/playtests/survives.playtest.json +21 -0
- package/templates/starter/playtests/touch-controls.playtest.json +42 -0
- package/templates/starter/src/conventions.ts +18 -0
- package/templates/starter/src/entities/Goal.ts +18 -3
- package/templates/starter/src/entities/Player.ts +72 -9
- package/templates/starter/src/game.ts +2 -0
- package/templates/starter/src/render/adaptiveQuality.ts +195 -0
- package/templates/starter/src/render/camera.ts +1 -1
- package/templates/starter/src/render/coast.ts +199 -0
- package/templates/starter/src/render/hero.ts +88 -0
- package/templates/starter/src/render/implicitSurface.ts +199 -0
- package/templates/starter/src/render/kuwahara.ts +174 -0
- package/templates/starter/src/render/lighting.ts +4 -4
- package/templates/starter/src/render/loading.ts +12 -2
- package/templates/starter/src/render/materials.ts +25 -6
- package/templates/starter/src/render/outline.ts +141 -0
- package/templates/starter/src/render/painterly.ts +86 -0
- package/templates/starter/src/render/palette.ts +15 -6
- package/templates/starter/src/render/postprocessing.ts +87 -36
- package/templates/starter/src/render/quality.ts +185 -0
- package/templates/starter/src/render/rockRidge.ts +198 -0
- package/templates/starter/src/render/rockRidge.worker.ts +77 -0
- package/templates/starter/src/render/scenery.ts +16 -59
- package/templates/starter/src/render/textureLifetime.ts +53 -0
- package/templates/starter/src/render/touch-controls.ts +165 -0
- package/templates/starter/src/render/water.ts +38 -0
- package/templates/starter/src/render/watercolor.ts +85 -0
- package/templates/starter/src/render/worldEnvironment.ts +208 -33
- package/templates/starter/src/scenes/Play.ts +103 -16
- package/templates/starter/src/style.css +27 -7
- package/templates/starter/threenative.config.ts +7 -7
- package/agent-docs/asset-mcp-loop.md +0 -33
- package/agent-docs/ctx-surface.md +0 -69
- package/agent-docs/engine-capabilities.md +0 -4
- package/agent-docs/framework-blocks-you.md +0 -60
- package/agent-docs/look-at-it-and-budget-the-look.md +0 -27
- package/agent-docs/performance-default.md +0 -42
- package/agent-docs/pixel-budget.md +0 -20
- package/agent-docs/playtest-fail-closed.md +0 -23
- package/agent-docs/sculpt-loop.md +0 -16
- package/templates/action-rpg/src/physics.ts +0 -40
- package/templates/defense/public/icon.png +0 -0
- package/templates/minimal/public/icon.png +0 -0
- package/templates/platformer/public/icon.png +0 -0
- package/templates/racing/public/icon.png +0 -0
- package/templates/sailing/public/icon.png +0 -0
- package/templates/sailing/src/render/water-material.ts +0 -14
- package/templates/sailing/src/render/water-shaders.ts +0 -12
- package/templates/sailing/src/render/wave-nodes.ts +0 -10
- package/templates/shooter/public/icon.png +0 -0
- package/templates/shooter/src/physics.ts +0 -49
- package/templates/starter/public/icon.png +0 -0
- /package/{templates/action-rpg/public → template-assets}/icon.png +0 -0
|
@@ -16,7 +16,34 @@
|
|
|
16
16
|
"noRuntimeDiagnostics": true,
|
|
17
17
|
"runtimeReady": true
|
|
18
18
|
},
|
|
19
|
+
"components": [
|
|
20
|
+
{
|
|
21
|
+
"allowTrivial": "GroundSnap settles the player before this movement observation; the finite near-zero clearance is the generated call-site proof.",
|
|
22
|
+
"component": "groundClearance",
|
|
23
|
+
"entity": "player",
|
|
24
|
+
"lte": 0.01
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"allowTrivial": "The action RPG blade has an authored non-unit size; this retained factor proves normaliseToMetres ran in the generated player.",
|
|
28
|
+
"component": "normaliseFactor",
|
|
29
|
+
"entity": "player",
|
|
30
|
+
"gte": 1.01
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
"allowTrivial": "Weapon attachment is construction-time; the resolved RightHand parent proves attachToBone ran in the generated player.",
|
|
34
|
+
"component": "weaponBone",
|
|
35
|
+
"entity": "player",
|
|
36
|
+
"equals": "RightHand"
|
|
37
|
+
}
|
|
38
|
+
],
|
|
19
39
|
"movement": { "entity": "player", "minDistance": 0.5 },
|
|
40
|
+
"visibility": [
|
|
41
|
+
{
|
|
42
|
+
"entity": "touch-controls",
|
|
43
|
+
"present": false,
|
|
44
|
+
"allowTrivial": "Desktop keyboard lanes intentionally omit touch controls while movement proves the scene is active."
|
|
45
|
+
}
|
|
46
|
+
],
|
|
20
47
|
"visual": [
|
|
21
48
|
{
|
|
22
49
|
"region": {
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "action-rpg-touch-controls",
|
|
3
|
+
"schemaVersion": 1,
|
|
4
|
+
"target": "web",
|
|
5
|
+
"viewport": { "width": 1280, "height": 720 },
|
|
6
|
+
"warmupFrames": 10,
|
|
7
|
+
"subject": "player",
|
|
8
|
+
"steps": [
|
|
9
|
+
{
|
|
10
|
+
"kind": "input",
|
|
11
|
+
"label": "movement-anchor",
|
|
12
|
+
"pointers": [{ "id": 7, "x": 0.18, "y": 0.75 }],
|
|
13
|
+
"holdTicks": 2,
|
|
14
|
+
"release": false
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"kind": "input",
|
|
18
|
+
"label": "move-and-attack",
|
|
19
|
+
"pointers": [{ "id": 7, "x": 0.32, "y": 0.75 }, { "id": 3, "x": 0.927, "y": 0.869 }],
|
|
20
|
+
"holdTicks": 45,
|
|
21
|
+
"release": true
|
|
22
|
+
},
|
|
23
|
+
{ "kind": "wait", "label": "settled", "waitTicks": 10, "release": true }
|
|
24
|
+
],
|
|
25
|
+
"assert": {
|
|
26
|
+
"diagnostics": {
|
|
27
|
+
"noConsoleErrors": true,
|
|
28
|
+
"noNetworkErrors": true,
|
|
29
|
+
"noRuntimeDiagnostics": true,
|
|
30
|
+
"runtimeReady": true
|
|
31
|
+
},
|
|
32
|
+
"movement": { "entity": "player", "minDistance": 0.1 },
|
|
33
|
+
"resources": [{ "id": "state", "path": "playerX", "changed": true }],
|
|
34
|
+
"visibility": [
|
|
35
|
+
{
|
|
36
|
+
"entity": "touch-controls",
|
|
37
|
+
"present": true,
|
|
38
|
+
"allowTrivial": "Touch-primary lanes keep the authored controls visible while state assertions prove they are live."
|
|
39
|
+
}
|
|
40
|
+
]
|
|
41
|
+
}
|
|
42
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { GroundSnap, attachToBone, normaliseToMetres, skeletonBones } from "@threenative/core";
|
|
2
|
+
import { Bone, type Group } from "three";
|
|
3
|
+
|
|
4
|
+
export interface IActionRpgConventions {
|
|
5
|
+
readonly applyGrounding: (surfaceY: number, dt: number) => void;
|
|
6
|
+
readonly attachedBone: string;
|
|
7
|
+
readonly boneNames: readonly string[];
|
|
8
|
+
readonly groundSnap: GroundSnap;
|
|
9
|
+
readonly normaliseFactor: number;
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
export function preparePlayerConventions(model: Group): IActionRpgConventions {
|
|
13
|
+
const weapon = model.getObjectByName("held-blade");
|
|
14
|
+
if (weapon === undefined) throw new Error("Action RPG player is missing its held blade.");
|
|
15
|
+
|
|
16
|
+
const normaliseFactor = normaliseToMetres(weapon, { axis: "longest", metres: 0.9 });
|
|
17
|
+
const hand = new Bone();
|
|
18
|
+
hand.name = "RightHand";
|
|
19
|
+
hand.position.copy(weapon.position);
|
|
20
|
+
hand.rotation.copy(weapon.rotation);
|
|
21
|
+
model.add(hand);
|
|
22
|
+
weapon.position.set(0, 0, 0);
|
|
23
|
+
weapon.rotation.set(0, 0, 0);
|
|
24
|
+
|
|
25
|
+
const boneNames = skeletonBones(model);
|
|
26
|
+
attachToBone(model, "RightHand", weapon);
|
|
27
|
+
const groundSnap = new GroundSnap(model);
|
|
28
|
+
return {
|
|
29
|
+
applyGrounding: (surfaceY, dt) => groundSnap.apply(model, surfaceY, dt),
|
|
30
|
+
attachedBone: weapon.parent?.name ?? "",
|
|
31
|
+
boneNames,
|
|
32
|
+
groundSnap,
|
|
33
|
+
normaliseFactor,
|
|
34
|
+
};
|
|
35
|
+
}
|
|
@@ -6,7 +6,6 @@ import {
|
|
|
6
6
|
type IPhysicsContext,
|
|
7
7
|
} from "@threenative/physics";
|
|
8
8
|
import { type Group, Vector3 } from "three";
|
|
9
|
-
import { directSpaceState } from "../physics.js";
|
|
10
9
|
import { type RpgMaterials, createEnemyVisual } from "../render/shapes.js";
|
|
11
10
|
import type { GameState } from "../state.js";
|
|
12
11
|
import { HOSTILE_LAYER, PLAYER_LAYER, WORLD_LAYER } from "./Player.js";
|
|
@@ -68,7 +67,7 @@ export class Enemy {
|
|
|
68
67
|
|
|
69
68
|
update(ctx: GameCtx, dt: number, playerPosition: Vector3): void {
|
|
70
69
|
if (!this.alive) return;
|
|
71
|
-
const rangeHits =
|
|
70
|
+
const rangeHits = ctx.physics.directSpaceState.intersectShape({
|
|
72
71
|
collisionMask: PLAYER_LAYER,
|
|
73
72
|
maxResults: 4,
|
|
74
73
|
position: this.mesh.position,
|
|
@@ -87,7 +86,7 @@ export class Enemy {
|
|
|
87
86
|
from.y += this.boss ? 0.9 : 0.5;
|
|
88
87
|
const to = this.#to.copy(playerPosition);
|
|
89
88
|
to.y += 0.5;
|
|
90
|
-
const ray =
|
|
89
|
+
const ray = ctx.physics.directSpaceState.intersectRay({
|
|
91
90
|
collisionMask: WORLD_LAYER | PLAYER_LAYER,
|
|
92
91
|
from,
|
|
93
92
|
to,
|
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
import type { ICtx } from "@threenative/core";
|
|
2
2
|
import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
|
|
3
|
-
import {
|
|
3
|
+
import { Group, Vector3 } from "three";
|
|
4
|
+
import { type IActionRpgConventions, preparePlayerConventions } from "../conventions.js";
|
|
4
5
|
import { createPlayerVisual } from "../render/shapes.js";
|
|
5
6
|
import type { RpgMaterials } from "../render/shapes.js";
|
|
7
|
+
import type { ITouchInput } from "../render/touch-controls.js";
|
|
6
8
|
import type { GameState } from "../state.js";
|
|
7
9
|
|
|
8
10
|
export const WORLD_LAYER = 1;
|
|
@@ -15,11 +17,13 @@ export class Player {
|
|
|
15
17
|
readonly body: CharacterBody3D;
|
|
16
18
|
readonly maxHealth = 100;
|
|
17
19
|
readonly mesh: Group;
|
|
20
|
+
readonly visual: Group;
|
|
18
21
|
health: number;
|
|
19
22
|
dead = false;
|
|
20
23
|
equippedItem = "";
|
|
21
24
|
#onDamage: (amount: number) => void;
|
|
22
25
|
#onDeath: () => void;
|
|
26
|
+
#conventions: IActionRpgConventions;
|
|
23
27
|
|
|
24
28
|
constructor(
|
|
25
29
|
ctx: GameCtx,
|
|
@@ -32,8 +36,11 @@ export class Player {
|
|
|
32
36
|
this.#onDamage = onDamage;
|
|
33
37
|
this.#onDeath = onDeath;
|
|
34
38
|
this.health = Math.max(0, Math.min(this.maxHealth, health));
|
|
35
|
-
this.mesh =
|
|
39
|
+
this.mesh = new Group();
|
|
40
|
+
this.visual = createPlayerVisual(materials);
|
|
41
|
+
this.mesh.add(this.visual);
|
|
36
42
|
this.mesh.position.copy(spawn);
|
|
43
|
+
this.#conventions = preparePlayerConventions(this.visual);
|
|
37
44
|
ctx.add(this.mesh);
|
|
38
45
|
this.body = new CharacterBody3D({
|
|
39
46
|
collisionLayer: PLAYER_LAYER,
|
|
@@ -45,11 +52,17 @@ export class Player {
|
|
|
45
52
|
});
|
|
46
53
|
}
|
|
47
54
|
|
|
48
|
-
update(ctx: GameCtx, dt: number): void {
|
|
55
|
+
update(ctx: GameCtx, dt: number, touch?: ITouchInput): void {
|
|
49
56
|
if (this.dead) return;
|
|
50
57
|
const move = ctx.input.vector("move");
|
|
58
|
+
if (touch !== undefined) {
|
|
59
|
+
move.x += touch.move.x;
|
|
60
|
+
move.y += touch.move.y;
|
|
61
|
+
move.clampLength(0, 1);
|
|
62
|
+
}
|
|
51
63
|
this.body.velocity.set(move.x * 4.8, 0, -move.y * 4.8);
|
|
52
64
|
this.body.moveAndSlide(dt);
|
|
65
|
+
this.#conventions.applyGrounding(0, dt);
|
|
53
66
|
}
|
|
54
67
|
|
|
55
68
|
takeDamage(amount: number): void {
|
|
@@ -71,8 +84,12 @@ export class Player {
|
|
|
71
84
|
return {
|
|
72
85
|
dead: this.dead,
|
|
73
86
|
equippedItem: this.equippedItem,
|
|
87
|
+
groundClearance: this.#conventions.groundSnap.clearance,
|
|
74
88
|
health: this.health,
|
|
89
|
+
normaliseFactor: this.#conventions.normaliseFactor,
|
|
75
90
|
position: this.mesh.position.toArray(),
|
|
91
|
+
skeletonBones: this.#conventions.boneNames,
|
|
92
|
+
weaponBone: this.#conventions.attachedBone,
|
|
76
93
|
};
|
|
77
94
|
}
|
|
78
95
|
|
|
@@ -7,8 +7,13 @@ export interface ICameraRig {
|
|
|
7
7
|
}
|
|
8
8
|
|
|
9
9
|
export function createDungeonCamera(camera: PerspectiveCamera): ICameraRig {
|
|
10
|
-
|
|
11
|
-
|
|
10
|
+
// The rig has to clear the **south wall**, which stands at z = +6 and is now 5.2 m tall with a
|
|
11
|
+
// cap on it. At 6.6/7.4 the eye sat outside that wall and below its top, so the lower half of
|
|
12
|
+
// the frame was the wall's outer face and the room was hidden behind it. From 10.2/9.2 the
|
|
13
|
+
// sightline passes over the cap with room to spare, and the far wall closes the top of the shot
|
|
14
|
+
// instead of the empty sky the old 2.8 m walls left there.
|
|
15
|
+
const offset = new Vec3(0, 10.2, 9.2);
|
|
16
|
+
const lookAhead = new Vec3(0, 0.4, -1.8);
|
|
12
17
|
const desired = new Vec3();
|
|
13
18
|
const aim = new Vec3();
|
|
14
19
|
const pose = (target: Vector3): void => {
|
|
@@ -10,7 +10,9 @@ export function setupLighting(scene: Scene, renderer: ShadowRenderer): Direction
|
|
|
10
10
|
renderer.shadowMap.enabled = true;
|
|
11
11
|
renderer.shadowMap.type = PCFSoftShadowMap;
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
// Warm, but not the accent itself: keyed with the trim colour, the stone, the hero and the loot
|
|
14
|
+
// all took the same gold cast and the dungeon lost every distinction between them.
|
|
15
|
+
const key = new DirectionalLight(0xffe0b0, 2.6);
|
|
14
16
|
key.name = "key-light";
|
|
15
17
|
key.position.set(-8, 12, 6);
|
|
16
18
|
key.castShadow = true;
|
|
@@ -25,11 +27,11 @@ export function setupLighting(scene: Scene, renderer: ShadowRenderer): Direction
|
|
|
25
27
|
key.shadow.normalBias = 0.04;
|
|
26
28
|
scene.add(key);
|
|
27
29
|
|
|
28
|
-
const rim = new DirectionalLight(palette.player,
|
|
30
|
+
const rim = new DirectionalLight(palette.player, 0.9);
|
|
29
31
|
rim.name = "rim-light";
|
|
30
32
|
rim.position.set(12, 6, -12);
|
|
31
33
|
scene.add(rim);
|
|
32
|
-
scene.add(new AmbientLight(
|
|
34
|
+
scene.add(new AmbientLight(0x6a5a48, 1.5));
|
|
33
35
|
|
|
34
36
|
return key;
|
|
35
37
|
}
|
|
@@ -36,7 +36,11 @@ interface ILoadingHost {
|
|
|
36
36
|
};
|
|
37
37
|
readonly renderer: { compileAsync(scene: Scene, camera: Camera): Promise<void> };
|
|
38
38
|
readonly scene: Scene;
|
|
39
|
-
readonly startup: {
|
|
39
|
+
readonly startup: {
|
|
40
|
+
readonly progress: number;
|
|
41
|
+
readonly warmup?: { readonly status: "complete" | "incomplete" | "unavailable" };
|
|
42
|
+
whenReady(): Promise<void>;
|
|
43
|
+
};
|
|
40
44
|
readonly viewport?: {
|
|
41
45
|
readonly safeArea: { height: number; width: number; x: number; y: number };
|
|
42
46
|
};
|
|
@@ -231,7 +235,13 @@ export function createLoadingScreen(host: ILoadingHost): ILoadingController {
|
|
|
231
235
|
};
|
|
232
236
|
|
|
233
237
|
const updateProgress = (value: number): void => {
|
|
234
|
-
|
|
238
|
+
const bounded = Number.isFinite(value) ? Math.max(0, Math.min(1, value)) : 0;
|
|
239
|
+
// A missing or incomplete backend observation cannot prove that all first-use work is done.
|
|
240
|
+
// Keep the bar visibly indeterminate until readiness removes the cover; never turn unknown
|
|
241
|
+
// coverage into a false 100% claim.
|
|
242
|
+
const observationUnknown =
|
|
243
|
+
host.startup.warmup !== undefined && host.startup.warmup.status !== "complete";
|
|
244
|
+
progress = observationUnknown ? Math.min(0.9, bounded) : bounded;
|
|
235
245
|
setFillUv(fill.geometry, progress, fillBaseU);
|
|
236
246
|
status?.update(progress);
|
|
237
247
|
layout();
|
|
@@ -29,6 +29,17 @@ export function createMaterials() {
|
|
|
29
29
|
metalness: 0.26,
|
|
30
30
|
roughness: 0.72,
|
|
31
31
|
}),
|
|
32
|
+
stoneDark: new MeshStandardMaterial({
|
|
33
|
+
color: 0x333d4c,
|
|
34
|
+
metalness: 0.24,
|
|
35
|
+
roughness: 0.78,
|
|
36
|
+
}),
|
|
37
|
+
flame: new MeshStandardMaterial({
|
|
38
|
+
color: 0xffb552,
|
|
39
|
+
emissive: 0xffb552,
|
|
40
|
+
emissiveIntensity: 2.2,
|
|
41
|
+
roughness: 0.9,
|
|
42
|
+
}),
|
|
32
43
|
trim: new MeshStandardMaterial({
|
|
33
44
|
color: palette.accent,
|
|
34
45
|
emissive: palette.accent,
|
|
@@ -1,9 +1,16 @@
|
|
|
1
1
|
// Generated for you. Repaint the dungeon by keeping these six roles coherent.
|
|
2
|
+
// A torchlit dungeon. `stone` was 0x27303b under a 0x080b12 sky, and the first frame showed a
|
|
3
|
+
// black void filling half the picture with a dark tilted floor cutting across it: the walls were
|
|
4
|
+
// too low for the camera height, so the shot was mostly the nothing above them.
|
|
2
5
|
export const palette = {
|
|
3
6
|
accent: 0xe8b86a,
|
|
4
7
|
hostile: 0xd96572,
|
|
5
8
|
player: 0x71d1c4,
|
|
6
|
-
skyHigh:
|
|
7
|
-
skyLow:
|
|
8
|
-
|
|
9
|
+
skyHigh: 0x2c3050,
|
|
10
|
+
skyLow: 0x121728,
|
|
11
|
+
/** Wall and floor masonry. Mid, so a figure standing on it has something to read against. */
|
|
12
|
+
stone: 0x4a5566,
|
|
9
13
|
} as const;
|
|
14
|
+
|
|
15
|
+
// The darker masonry course and the torch flame are shades of these six rather than roles of their
|
|
16
|
+
// own; `materials.ts` owns them, next to the surfaces that use them.
|
|
@@ -1,71 +1,34 @@
|
|
|
1
|
-
// Generated for you
|
|
2
|
-
// ThreeNative does not read this file.
|
|
1
|
+
// Generated for you: ordinary Three.js; ThreeNative does not read this file.
|
|
3
2
|
//
|
|
4
|
-
//
|
|
5
|
-
//
|
|
6
|
-
//
|
|
7
|
-
//
|
|
8
|
-
//
|
|
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.
|
|
9
8
|
//
|
|
10
|
-
//
|
|
11
|
-
//
|
|
12
|
-
// `
|
|
13
|
-
//
|
|
14
|
-
// vignette), is in `agent-docs/visual-baseline.md`.
|
|
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.
|
|
15
13
|
import type { Camera, DirectionalLight, Scene } from "three";
|
|
14
|
+
import { type QualityTier, qualityPreset, resolveQualityTier } from "./quality.js";
|
|
16
15
|
import type { OutputRenderer } from "./worldEnvironment.js";
|
|
17
16
|
import { WorldEnvironment } from "./worldEnvironment.js";
|
|
18
17
|
|
|
19
|
-
// Scene-referred exposure: multiplied into the pass before the tone curve, so the gather, the
|
|
20
|
-
// reflections and the bloom threshold all see the same exposed image.
|
|
21
|
-
const exposure = 1.08;
|
|
22
|
-
|
|
23
|
-
// Unchanged from this template's previous chain — strength, radius and threshold are a look
|
|
24
|
-
// decision that was already tuned to this scene's palette.
|
|
25
|
-
const glow = {
|
|
26
|
-
bloomEnabled: true,
|
|
27
|
-
bloomRadius: 0.42,
|
|
28
|
-
bloomStrength: 0.72,
|
|
29
|
-
bloomThreshold: 0.18,
|
|
30
|
-
} as const;
|
|
31
|
-
|
|
32
|
-
const desktopPreset = {
|
|
33
|
-
...glow,
|
|
34
|
-
denoiseEnabled: true,
|
|
35
|
-
exposure,
|
|
36
|
-
ssgiEnabled: true,
|
|
37
|
-
// Room scale, not contact scale: about two thirds of the 24-unit shadow extent
|
|
38
|
-
// `lighting.ts` lights — an overhead arena whose walls and floor are the only things GI has to bounce between.
|
|
39
|
-
ssgiRadius: 16,
|
|
40
|
-
ssgiQuality: "medium",
|
|
41
|
-
ssrEnabled: true,
|
|
42
|
-
// `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as
|
|
43
|
-
// "reflections are on and do nothing" — the ray dies a metre from where it started.
|
|
44
|
-
ssrMaxDistance: 40,
|
|
45
|
-
// A reflection carries almost no high-frequency detail, so half resolution costs a quarter
|
|
46
|
-
// of the rays and is very hard to see in the result.
|
|
47
|
-
ssrResolutionScale: 0.5,
|
|
48
|
-
// RCAS puts back the micro-detail the half-resolution reflection and the denoiser take out.
|
|
49
|
-
// The same cause everywhere, so the same value everywhere: **0 is maximum sharpening and 2
|
|
50
|
-
// is none** — it is a radius, not a gain.
|
|
51
|
-
sharpenEnabled: true,
|
|
52
|
-
sharpenStrength: 0.3,
|
|
53
|
-
tonemapMode: "aces",
|
|
54
|
-
} as const;
|
|
55
|
-
|
|
56
|
-
// No SSGI, no SSR, and therefore nothing for the sharpener to put back.
|
|
57
|
-
const mobilePreset = {
|
|
58
|
-
...glow,
|
|
59
|
-
exposure,
|
|
60
|
-
tonemapMode: "aces",
|
|
61
|
-
} as const;
|
|
62
|
-
|
|
63
18
|
export function setupPost(
|
|
64
19
|
renderer: OutputRenderer,
|
|
65
20
|
scene: Scene,
|
|
66
21
|
camera: Camera,
|
|
67
|
-
environment: {
|
|
22
|
+
environment: {
|
|
23
|
+
godraysLight?: DirectionalLight;
|
|
24
|
+
mobile?: boolean;
|
|
25
|
+
/** Forces a tier, ignoring `mobile`. An unknown name throws rather than falling back. */
|
|
26
|
+
tier?: QualityTier;
|
|
27
|
+
} = {},
|
|
68
28
|
): void {
|
|
69
|
-
const
|
|
29
|
+
const tier = resolveQualityTier({ mobile: environment.mobile, tier: environment.tier });
|
|
30
|
+
const source = environment.tier === undefined ? "platform" : "override";
|
|
31
|
+
console.info(`TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} source=${source}`);
|
|
32
|
+
const world = new WorldEnvironment(qualityPreset(tier));
|
|
70
33
|
world.apply(renderer, scene, camera, { godraysLight: environment.godraysLight });
|
|
71
34
|
}
|
|
@@ -0,0 +1,170 @@
|
|
|
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 { IWorldEnvironmentOptions } from "./worldEnvironment.js";
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* The three names this game's look comes in.
|
|
26
|
+
*
|
|
27
|
+
* `low` is what a phone gets and `high` what a desktop gets — those two are this template's
|
|
28
|
+
* shipped looks, unchanged. `medium` is the rung in between for a machine that is neither: a
|
|
29
|
+
* laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
|
|
30
|
+
* what any of them mean.
|
|
31
|
+
*/
|
|
32
|
+
export type QualityTier = "low" | "medium" | "high";
|
|
33
|
+
|
|
34
|
+
const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
|
|
38
|
+
* `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
|
|
39
|
+
*/
|
|
40
|
+
function isQualityTier(value: string): value is QualityTier {
|
|
41
|
+
return (QUALITY_TIERS as readonly string[]).includes(value);
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
|
|
46
|
+
*
|
|
47
|
+
* Fails closed. An unrecognised tier name throws with the value it was handed rather than
|
|
48
|
+
* quietly rendering the default, because a silent fallback here looks exactly like a tier that
|
|
49
|
+
* turned out to have no effect.
|
|
50
|
+
*/
|
|
51
|
+
export function resolveQualityTier(
|
|
52
|
+
request: { readonly mobile?: boolean; readonly tier?: string } = {},
|
|
53
|
+
): QualityTier {
|
|
54
|
+
const requested = request.tier;
|
|
55
|
+
if (requested !== undefined) {
|
|
56
|
+
if (!isQualityTier(requested)) {
|
|
57
|
+
throw new Error(
|
|
58
|
+
`Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
59
|
+
);
|
|
60
|
+
}
|
|
61
|
+
return requested;
|
|
62
|
+
}
|
|
63
|
+
return request.mobile === true ? "low" : "high";
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* What a desktop gets: this template's shipped desktop look, unchanged.
|
|
68
|
+
*
|
|
69
|
+
* The whole chain measured 12.5 ms of a 14.7 ms GPU frame in the reference ablation, and SSGI
|
|
70
|
+
* with its denoiser is ~9.2 ms of that.
|
|
71
|
+
*/
|
|
72
|
+
const high: IWorldEnvironmentOptions = {
|
|
73
|
+
// Strength, radius and threshold are a look decision already tuned to this scene's palette.
|
|
74
|
+
// Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
|
|
75
|
+
// to be.
|
|
76
|
+
bloomEnabled: true,
|
|
77
|
+
bloomRadius: 0.42,
|
|
78
|
+
bloomStrength: 0.72,
|
|
79
|
+
bloomThreshold: 0.18,
|
|
80
|
+
exposure: 1.08,
|
|
81
|
+
// The two full-resolution denoise passes over the AO and GI terms: ~1.9 ms. Only worth running
|
|
82
|
+
// when SSGI is on — its noise is what they clean up.
|
|
83
|
+
denoiseEnabled: true,
|
|
84
|
+
// SSGI, the screen-space indirect-light gather: ~7.3 ms alone, ~9.2 ms with the two denoise
|
|
85
|
+
// passes it feeds. The largest stage in the chain by a factor of two, of a 14.7 ms frame.
|
|
86
|
+
// Dropping this pair is what `medium` is.
|
|
87
|
+
ssgiEnabled: true,
|
|
88
|
+
ssgiRadius: 16,
|
|
89
|
+
ssgiQuality: "medium",
|
|
90
|
+
// Half the frame in each axis, so a quarter of the pixels. Full-res SSGI cost 14.4 ms
|
|
91
|
+
// of a 39.7 ms frame on an RTX 2080; this is the same gather over a quarter of the work,
|
|
92
|
+
// and it measured *sharper* because the scaler spends what it hands back on resolution.
|
|
93
|
+
// `worldEnvironment.ts` explains why it takes a wrapper instead of a property.
|
|
94
|
+
ssgiResolutionScale: 0.5,
|
|
95
|
+
// Screen-space reflections: ~4.1 ms.
|
|
96
|
+
ssrEnabled: true,
|
|
97
|
+
// `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
|
|
98
|
+
// are on and do nothing" — the ray dies a metre from where it started.
|
|
99
|
+
ssrMaxDistance: 40,
|
|
100
|
+
// A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
|
|
101
|
+
// the rays and is very hard to see in the result.
|
|
102
|
+
ssrResolutionScale: 0.5,
|
|
103
|
+
// RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
|
|
104
|
+
// denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
|
|
105
|
+
// that runs one of them.
|
|
106
|
+
sharpenEnabled: true,
|
|
107
|
+
// **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
|
|
108
|
+
sharpenStrength: 0.3,
|
|
109
|
+
tonemapMode: "aces",
|
|
110
|
+
};
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* `high` minus the gather and its denoiser — the single change in this chain measured to give
|
|
114
|
+
* back most of the frame: **14.7 ms -> 5.5 ms of GPU** in the reference ablation. Reflections,
|
|
115
|
+
* bloom and the sharpener stay, so it is recognisably the same look.
|
|
116
|
+
*/
|
|
117
|
+
const medium: IWorldEnvironmentOptions = {
|
|
118
|
+
// Strength, radius and threshold are a look decision already tuned to this scene's palette.
|
|
119
|
+
// Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
|
|
120
|
+
// to be.
|
|
121
|
+
bloomEnabled: true,
|
|
122
|
+
bloomRadius: 0.42,
|
|
123
|
+
bloomStrength: 0.72,
|
|
124
|
+
bloomThreshold: 0.18,
|
|
125
|
+
exposure: 1.08,
|
|
126
|
+
// Screen-space reflections: ~4.1 ms.
|
|
127
|
+
ssrEnabled: true,
|
|
128
|
+
// `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
|
|
129
|
+
// are on and do nothing" — the ray dies a metre from where it started.
|
|
130
|
+
ssrMaxDistance: 40,
|
|
131
|
+
// A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
|
|
132
|
+
// the rays and is very hard to see in the result.
|
|
133
|
+
ssrResolutionScale: 0.5,
|
|
134
|
+
// RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
|
|
135
|
+
// denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
|
|
136
|
+
// that runs one of them.
|
|
137
|
+
sharpenEnabled: true,
|
|
138
|
+
// **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
|
|
139
|
+
sharpenStrength: 0.3,
|
|
140
|
+
tonemapMode: "aces",
|
|
141
|
+
};
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* What a phone gets: this template's shipped mobile look, unchanged. Bloom and the tone curve,
|
|
145
|
+
* nothing screen-space. The ablation's floor — every stage off — was 2.2 ms.
|
|
146
|
+
*/
|
|
147
|
+
const low: IWorldEnvironmentOptions = {
|
|
148
|
+
// Strength, radius and threshold are a look decision already tuned to this scene's palette.
|
|
149
|
+
// Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
|
|
150
|
+
// to be.
|
|
151
|
+
bloomEnabled: true,
|
|
152
|
+
bloomRadius: 0.42,
|
|
153
|
+
bloomStrength: 0.72,
|
|
154
|
+
bloomThreshold: 0.18,
|
|
155
|
+
exposure: 1.08,
|
|
156
|
+
tonemapMode: "aces",
|
|
157
|
+
};
|
|
158
|
+
|
|
159
|
+
const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
|
|
160
|
+
|
|
161
|
+
/** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
|
|
162
|
+
export function qualityPreset(tier: string): IWorldEnvironmentOptions {
|
|
163
|
+
const preset = QUALITY_PRESETS[tier as QualityTier];
|
|
164
|
+
if (preset === undefined) {
|
|
165
|
+
throw new Error(
|
|
166
|
+
`Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
167
|
+
);
|
|
168
|
+
}
|
|
169
|
+
return preset;
|
|
170
|
+
}
|