create-threenative 0.2.1 → 0.2.3
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 +10 -2
- package/agent-docs/asset-mcp-loop.md +33 -0
- package/agent-docs/ctx-surface.md +69 -0
- package/agent-docs/engine-capabilities.md +4 -0
- package/agent-docs/framework-blocks-you.md +60 -0
- package/agent-docs/look-at-it-and-budget-the-look.md +27 -0
- package/agent-docs/performance-default.md +42 -0
- package/agent-docs/pixel-budget.md +20 -0
- package/agent-docs/playtest-fail-closed.md +23 -0
- package/agent-docs/references/assertion-reference.md +652 -0
- package/agent-docs/references/capability-reference.md +3279 -0
- package/agent-docs/references/capture-the-frame.md +53 -0
- package/agent-docs/references/ctx-cookbook.md +51 -0
- package/agent-docs/references/debug-surface.md +63 -0
- package/agent-docs/references/finding-assets.md +147 -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 +39 -0
- package/agent-docs/references/visual-baseline.md +133 -0
- package/agent-docs/references/webview-ui.md +113 -0
- package/agent-docs/sculpt-loop.md +16 -0
- package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
- package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
- package/agent-files/.claude/agents/threenative-builder.md +7 -0
- package/agent-files/.claude/agents/threenative-verifier.md +7 -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/capabilities.json +3542 -0
- package/dist/index.d.ts +191 -3
- package/dist/index.js +1707 -73
- package/dist/threenative.d.ts +9 -2
- package/dist/threenative.js +1825 -148
- package/package.json +30 -6
- package/template-assets/loading.ts +315 -0
- package/template-assets/patches/three@0.185.1.patch +287 -0
- package/templates/action-rpg/.codex/config.toml +15 -0
- package/templates/action-rpg/.mcp.json +6 -2
- package/templates/action-rpg/AGENTS.md +370 -6
- package/templates/action-rpg/CLAUDE.md +370 -6
- package/templates/action-rpg/index.html +0 -1
- package/templates/action-rpg/package.json +15 -11
- package/templates/action-rpg/playtests/combat.playtest.json +23 -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 +22 -0
- package/templates/action-rpg/playtests/progress.playtest.json +18 -13
- package/templates/action-rpg/playtests/win.playtest.json +10 -4
- package/templates/action-rpg/public/icon.png +0 -0
- package/templates/action-rpg/src/entities/Enemy.ts +14 -4
- package/templates/action-rpg/src/game.ts +21 -0
- package/templates/action-rpg/src/render/lighting.ts +6 -1
- package/templates/action-rpg/src/render/loading.ts +267 -42
- package/templates/action-rpg/src/render/postprocessing.ts +68 -15
- package/templates/action-rpg/src/render/worldEnvironment.ts +583 -0
- package/templates/action-rpg/src/scenes/Play.ts +49 -19
- package/templates/action-rpg/src/state.ts +4 -0
- package/templates/action-rpg/src/style.css +45 -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 +21 -8
- package/templates/action-rpg/vite.config.ts +32 -2
- package/templates/defense/.codex/config.toml +15 -0
- package/templates/defense/.mcp.json +6 -2
- package/templates/defense/AGENTS.md +371 -8
- package/templates/defense/CLAUDE.md +371 -8
- package/templates/defense/README.md +2 -1
- package/templates/defense/index.html +0 -1
- package/templates/defense/package.json +16 -12
- package/templates/defense/playtests/leak.playtest.json +9 -4
- package/templates/defense/playtests/performance.playtest.json +22 -0
- package/templates/defense/playtests/placement.playtest.json +5 -5
- package/templates/defense/playtests/pointer-placement.playtest.json +89 -0
- package/templates/defense/playtests/scan.playtest.json +3 -3
- package/templates/defense/playtests/survive.playtest.json +11 -6
- package/templates/defense/public/icon.png +0 -0
- package/templates/defense/src/attackers/Attacker.ts +28 -12
- package/templates/defense/src/game.ts +24 -2
- package/templates/defense/src/render/lighting.ts +6 -1
- package/templates/defense/src/render/loading.ts +263 -37
- package/templates/defense/src/render/postprocessing.ts +70 -13
- package/templates/defense/src/render/shapes.ts +38 -0
- package/templates/defense/src/render/worldEnvironment.ts +583 -0
- package/templates/defense/src/scenes/Defense.ts +109 -50
- package/templates/defense/src/state.ts +6 -0
- package/templates/defense/src/style.css +45 -1
- package/templates/defense/src/ui/App.tsx +9 -4
- 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 +21 -8
- package/templates/defense/vite.config.ts +34 -1
- package/templates/minimal/.codex/config.toml +15 -0
- package/templates/minimal/.mcp.json +6 -2
- package/templates/minimal/AGENTS.md +360 -255
- package/templates/minimal/CLAUDE.md +360 -255
- package/templates/minimal/index.html +0 -1
- package/templates/minimal/package.json +14 -11
- package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
- package/templates/minimal/playtests/play.playtest.json +17 -5
- package/templates/minimal/public/icon.png +0 -0
- package/templates/minimal/src/game.ts +1 -0
- 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/postprocessing.ts +92 -14
- package/templates/minimal/src/render/sky.ts +37 -32
- package/templates/minimal/src/render/worldEnvironment.ts +583 -0
- package/templates/minimal/src/scenes/Play.ts +91 -13
- package/templates/minimal/src/state.ts +8 -1
- package/templates/minimal/threenative.config.ts +15 -10
- package/templates/minimal/vite.config.ts +28 -1
- package/templates/platformer/.codex/config.toml +15 -0
- package/templates/platformer/.mcp.json +6 -2
- package/templates/platformer/AGENTS.md +385 -130
- package/templates/platformer/CLAUDE.md +385 -130
- package/templates/platformer/index.html +0 -1
- 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 +1 -1
- package/templates/platformer/playtests/performance.playtest.json +6 -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/terminal-loop-fail.playtest.json +13 -4
- package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
- package/templates/platformer/playtests/touch-controls-web.playtest.json +46 -0
- package/templates/platformer/public/icon.png +0 -0
- package/templates/platformer/src/entities/Character.ts +16 -10
- package/templates/platformer/src/entities/Patrol.ts +5 -0
- package/templates/platformer/src/game.ts +24 -1
- package/templates/platformer/src/render/lighting.ts +6 -1
- package/templates/platformer/src/render/loading.ts +270 -61
- package/templates/platformer/src/render/postprocessing.ts +68 -15
- package/templates/platformer/src/render/touch-controls.ts +54 -36
- package/templates/platformer/src/render/worldEnvironment.ts +583 -0
- package/templates/platformer/src/scenes/Level.ts +47 -22
- package/templates/platformer/src/state.ts +4 -0
- package/templates/platformer/src/style.css +45 -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 +20 -10
- package/templates/platformer/vite.config.ts +34 -1
- package/templates/racing/.codex/config.toml +15 -0
- package/templates/racing/.mcp.json +6 -2
- package/templates/racing/AGENTS.md +370 -6
- package/templates/racing/CLAUDE.md +370 -6
- package/templates/racing/index.html +0 -1
- package/templates/racing/package.json +16 -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 +22 -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/public/icon.png +0 -0
- package/templates/racing/src/game.ts +24 -1
- package/templates/racing/src/render/camera.ts +10 -6
- package/templates/racing/src/render/lighting.ts +6 -1
- package/templates/racing/src/render/loading.ts +291 -34
- package/templates/racing/src/render/postprocessing.ts +70 -13
- package/templates/racing/src/render/worldEnvironment.ts +583 -0
- package/templates/racing/src/scenes/Race.ts +68 -36
- package/templates/racing/src/state.ts +4 -0
- package/templates/racing/src/style.css +45 -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 +29 -16
- 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 +21 -8
- package/templates/racing/vite.config.ts +34 -1
- package/templates/sailing/.codex/config.toml +15 -0
- package/templates/sailing/.mcp.json +20 -0
- package/templates/sailing/AGENTS.md +388 -0
- package/templates/sailing/CLAUDE.md +390 -0
- package/templates/sailing/README.md +25 -0
- package/templates/sailing/index.html +12 -0
- package/templates/sailing/kit.json +7 -0
- package/templates/sailing/native-playtests/survives.playtest.json +21 -0
- package/templates/sailing/package.json +52 -0
- package/templates/sailing/playtests/fail.playtest.json +24 -0
- package/templates/sailing/playtests/performance.playtest.json +21 -0
- package/templates/sailing/playtests/survives.playtest.json +38 -0
- package/templates/sailing/playtests/win.playtest.json +31 -0
- package/templates/sailing/public/favicon.svg +5 -0
- package/templates/sailing/public/icon.png +0 -0
- package/templates/sailing/src/entities/Ship.ts +96 -0
- package/templates/sailing/src/game.ts +40 -0
- package/templates/sailing/src/main.ts +15 -0
- package/templates/sailing/src/render/camera.ts +21 -0
- package/templates/sailing/src/render/lighting.ts +36 -0
- package/templates/sailing/src/render/loading.ts +315 -0
- package/templates/sailing/src/render/materials.ts +28 -0
- package/templates/sailing/src/render/palette.ts +24 -0
- package/templates/sailing/src/render/postprocessing.ts +33 -0
- package/templates/sailing/src/render/props.ts +52 -0
- package/templates/sailing/src/render/sky.ts +32 -0
- package/templates/sailing/src/render/water-material.ts +14 -0
- package/templates/sailing/src/render/water-shaders.ts +12 -0
- package/templates/sailing/src/render/wave-nodes.ts +10 -0
- package/templates/sailing/src/render/worldEnvironment.ts +590 -0
- package/templates/sailing/src/scenes/Boot.ts +12 -0
- package/templates/sailing/src/scenes/Sailing.ts +106 -0
- package/templates/sailing/src/state.ts +10 -0
- package/templates/sailing/src/style.css +61 -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 +34 -0
- package/templates/sailing/tsconfig.json +17 -0
- package/templates/sailing/vite.config.ts +34 -0
- package/templates/shooter/.codex/config.toml +15 -0
- package/templates/shooter/.mcp.json +6 -2
- package/templates/shooter/AGENTS.md +373 -7
- package/templates/shooter/CLAUDE.md +373 -7
- package/templates/shooter/index.html +0 -1
- package/templates/shooter/package.json +16 -11
- package/templates/shooter/playtests/fail.playtest.json +5 -4
- package/templates/shooter/playtests/input-control.playtest.json +131 -0
- package/templates/shooter/playtests/per-item.playtest.json +59 -0
- package/templates/shooter/playtests/performance.playtest.json +22 -0
- package/templates/shooter/playtests/shooter.playtest.json +22 -18
- package/templates/shooter/playtests/survives.playtest.json +1 -1
- package/templates/shooter/public/favicon.svg +1 -1
- package/templates/shooter/public/icon.png +0 -0
- package/templates/shooter/src/game.ts +24 -1
- package/templates/shooter/src/main.ts +3 -13
- package/templates/shooter/src/render/camera.ts +62 -12
- package/templates/shooter/src/render/lighting.ts +6 -1
- package/templates/shooter/src/render/loading.ts +262 -33
- package/templates/shooter/src/render/palette.ts +1 -1
- package/templates/shooter/src/render/postprocessing.ts +68 -16
- package/templates/shooter/src/render/shapes.ts +178 -0
- package/templates/shooter/src/render/ui.css +34 -1
- package/templates/shooter/src/render/worldEnvironment.ts +583 -0
- package/templates/shooter/src/scenes/Play.ts +246 -73
- package/templates/shooter/src/state.ts +13 -0
- package/templates/shooter/src/style.css +26 -0
- package/templates/shooter/src/ui/App.tsx +10 -12
- package/templates/shooter/src/ui/GameUi.tsx +20 -0
- package/templates/shooter/src/ui/Hud.tsx +8 -10
- package/templates/shooter/src/ui/Menu.tsx +24 -9
- package/templates/shooter/src/ui/main.tsx +15 -0
- package/templates/shooter/src/weapons/Projectile.ts +21 -10
- package/templates/shooter/threenative.config.ts +21 -8
- package/templates/shooter/vite.config.ts +32 -2
- package/templates/starter/.codex/config.toml +15 -0
- package/templates/starter/.mcp.json +6 -2
- package/templates/starter/AGENTS.md +429 -326
- package/templates/starter/CLAUDE.md +429 -326
- 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 +12 -0
- package/templates/starter/package.json +16 -12
- package/templates/starter/playtests/assets.playtest.json +65 -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 +34 -6
- 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 +43 -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 +27 -4
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +74 -0
- package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
- package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
- package/templates/starter/public/icon.png +0 -0
- package/templates/starter/src/entities/Goal.ts +122 -0
- package/templates/starter/src/entities/Player.ts +40 -2
- package/templates/starter/src/game.ts +25 -0
- package/templates/starter/src/render/camera.ts +31 -5
- 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/lighting.ts +6 -1
- package/templates/starter/src/render/loading.ts +315 -0
- package/templates/starter/src/render/materials.ts +17 -1
- package/templates/starter/src/render/pennant.ts +54 -0
- package/templates/starter/src/render/postprocessing.ts +46 -15
- package/templates/starter/src/render/scenery.ts +83 -0
- package/templates/starter/src/render/shapes.ts +9 -21
- package/templates/starter/src/render/worldEnvironment.ts +583 -0
- package/templates/starter/src/scenes/Play.ts +146 -36
- package/templates/starter/src/state.ts +12 -0
- package/templates/starter/src/style.css +45 -1
- 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/minimal/assets/.gitkeep +0 -0
- package/templates/minimal/public/.gitkeep +0 -0
- package/templates/platformer/assets/.gitkeep +0 -0
- package/templates/platformer/public/.gitkeep +0 -0
- package/templates/starter/assets/.gitkeep +0 -0
- package/templates/starter/public/.gitkeep +0 -0
- package/templates/starter/public/pickup.ogg +0 -0
- /package/templates/starter/{public → assets}/native-proof.glb +0 -0
- /package/templates/starter/{public → assets}/native-proof.png +0 -0
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "__PROJECT_NAME__",
|
|
3
3
|
"private": true,
|
|
4
|
+
"license": "MIT",
|
|
4
5
|
"type": "module",
|
|
5
6
|
"scripts": {
|
|
6
7
|
"dev": "vite",
|
|
@@ -11,30 +12,32 @@
|
|
|
11
12
|
"build:android": "threenative build --target android",
|
|
12
13
|
"build:ios": "threenative build --target ios",
|
|
13
14
|
"pretest": "playwright install chromium",
|
|
14
|
-
"test": "vite build && threenative-playtest --scenario playtests
|
|
15
|
+
"test": "vite build && threenative-playtest --scenario \"playtests/*.playtest.json\" --browser-recipe webgpu --headed --server-command \"pnpm dev --host 127.0.0.1 --port $PORT --strictPort\"",
|
|
15
16
|
"typecheck": "tsc --noEmit -p tsconfig.json"
|
|
16
17
|
},
|
|
17
18
|
"dependencies": {
|
|
18
|
-
"@threenative/core": "0.
|
|
19
|
-
"@threenative/physics": "0.
|
|
19
|
+
"@threenative/core": "0.3.0",
|
|
20
|
+
"@threenative/physics": "0.3.0",
|
|
20
21
|
"three": "0.185.1"
|
|
21
22
|
},
|
|
22
23
|
"devDependencies": {
|
|
23
|
-
"@threenative/
|
|
24
|
-
"@threenative/
|
|
24
|
+
"@threenative/assets": "0.3.0",
|
|
25
|
+
"@threenative/playtest": "0.3.0",
|
|
25
26
|
"@types/three": "0.185.3",
|
|
26
|
-
"create-threenative": "0.2.
|
|
27
|
+
"create-threenative": "0.2.3",
|
|
27
28
|
"esbuild": "0.27.0",
|
|
28
29
|
"playwright": "1.62.1",
|
|
29
|
-
"threenative-asset-mcp": "0.4.0",
|
|
30
|
-
"threenative-sculpt-mcp": "0.1.0",
|
|
31
30
|
"typescript": "5.9.3",
|
|
32
|
-
"vite": "8.2.0"
|
|
31
|
+
"vite": "8.2.0",
|
|
32
|
+
"@gltf-transform/cli": "4.4.2"
|
|
33
33
|
},
|
|
34
34
|
"optionalDependencies": {
|
|
35
|
-
"@threenative/runtime-native": "0.
|
|
35
|
+
"@threenative/runtime-native": "0.3.0"
|
|
36
36
|
},
|
|
37
37
|
"pnpm": {
|
|
38
|
-
"onlyBuiltDependencies": ["@threenative/runtime-native"]
|
|
38
|
+
"onlyBuiltDependencies": ["@threenative/core", "@threenative/runtime-native"],
|
|
39
|
+
"patchedDependencies": {
|
|
40
|
+
"three@0.185.1": "patches/three@0.185.1.patch"
|
|
41
|
+
}
|
|
39
42
|
}
|
|
40
43
|
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "atmosphere",
|
|
3
|
+
"target": "web",
|
|
4
|
+
"schemaVersion": 1,
|
|
5
|
+
"viewport": { "width": 1280, "height": 720 },
|
|
6
|
+
"warmupFrames": 30,
|
|
7
|
+
"steps": [{ "kind": "wait", "label": "sun moves", "waitTicks": 600, "release": true }],
|
|
8
|
+
"assert": {
|
|
9
|
+
"diagnostics": {
|
|
10
|
+
"noConsoleErrors": true,
|
|
11
|
+
"noNetworkErrors": true,
|
|
12
|
+
"runtimeReady": true
|
|
13
|
+
},
|
|
14
|
+
"resources": [
|
|
15
|
+
{ "id": "state", "path": "sunElevation", "changed": true },
|
|
16
|
+
{ "id": "state", "path": "sunAzimuth", "changed": true },
|
|
17
|
+
{ "id": "state", "path": "sunTransmittanceRed", "changed": true }
|
|
18
|
+
],
|
|
19
|
+
"visual": [
|
|
20
|
+
{
|
|
21
|
+
"frameDiff": { "minChangedPixelRatio": 0.001 },
|
|
22
|
+
"region": {
|
|
23
|
+
"x": 0,
|
|
24
|
+
"y": 0,
|
|
25
|
+
"width": 1280,
|
|
26
|
+
"height": 720,
|
|
27
|
+
"minNonblankPixelRatio": 0.01
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
]
|
|
31
|
+
}
|
|
32
|
+
}
|
|
@@ -3,15 +3,20 @@
|
|
|
3
3
|
"target": "web",
|
|
4
4
|
"schemaVersion": 1,
|
|
5
5
|
"viewport": {
|
|
6
|
-
"width":
|
|
7
|
-
"height":
|
|
6
|
+
"width": 1920,
|
|
7
|
+
"height": 1080
|
|
8
8
|
},
|
|
9
|
-
"warmupFrames":
|
|
9
|
+
"warmupFrames": 60,
|
|
10
10
|
"steps": [
|
|
11
11
|
{
|
|
12
12
|
"kind": "input",
|
|
13
13
|
"press": "ArrowRight",
|
|
14
|
-
"
|
|
14
|
+
"holdTicks": 60,
|
|
15
|
+
"release": true
|
|
16
|
+
},
|
|
17
|
+
{
|
|
18
|
+
"kind": "wait",
|
|
19
|
+
"waitTicks": 600,
|
|
15
20
|
"release": true
|
|
16
21
|
}
|
|
17
22
|
],
|
|
@@ -27,6 +32,13 @@
|
|
|
27
32
|
"entity": "hud"
|
|
28
33
|
}
|
|
29
34
|
],
|
|
30
|
-
"performance": {
|
|
35
|
+
"performance": {
|
|
36
|
+
"maxDrawCalls": 48,
|
|
37
|
+
"maxFrameMsP95": 33,
|
|
38
|
+
"maxTriangles": 1223
|
|
39
|
+
},
|
|
40
|
+
"renderChain": {
|
|
41
|
+
"tier": "high"
|
|
42
|
+
}
|
|
31
43
|
}
|
|
32
44
|
}
|
|
Binary file
|
|
@@ -20,6 +20,7 @@ const game = defineGame<GameState, IPhysicsContext>({
|
|
|
20
20
|
// `playtest()` installs the bridge a scenario needs to observe entities and state. Without
|
|
21
21
|
// it, semantic assertions fail closed with TN_PLAYTEST_BRIDGE_MISSING rather than passing.
|
|
22
22
|
plugins: [rapier(), playtest()],
|
|
23
|
+
display: config.display,
|
|
23
24
|
render: config.renderer,
|
|
24
25
|
scenes: { play: Play },
|
|
25
26
|
start: "play",
|
|
@@ -4,7 +4,7 @@ import type { PerspectiveCamera } from "three";
|
|
|
4
4
|
export function setupCamera(camera: PerspectiveCamera): void {
|
|
5
5
|
camera.fov = 54;
|
|
6
6
|
camera.near = 0.1;
|
|
7
|
-
camera.far =
|
|
7
|
+
camera.far = 20_000;
|
|
8
8
|
camera.position.set(0, 3, 9);
|
|
9
9
|
camera.lookAt(0, 1, 0);
|
|
10
10
|
camera.updateProjectionMatrix();
|
|
@@ -8,7 +8,19 @@ const GLYPHS =
|
|
|
8
8
|
.split(" ")
|
|
9
9
|
.map((hex) => BigInt(`0x${hex}`));
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
type HudValues = { counter?: number; primary: number; seconds: number };
|
|
12
|
+
|
|
13
|
+
function formatHudText(primaryLabel: string, counterLabel: string | undefined, values: HudValues) {
|
|
14
|
+
const minutes = String(Math.floor(values.seconds / 60)).padStart(2, "0");
|
|
15
|
+
const seconds = String(Math.floor(values.seconds % 60)).padStart(2, "0");
|
|
16
|
+
const lines = [`${primaryLabel} ${Math.max(0, Math.round(values.primary))}`];
|
|
17
|
+
if (counterLabel !== undefined && values.counter !== undefined)
|
|
18
|
+
lines.push(`${counterLabel} ${Math.max(0, Math.round(values.counter))}`);
|
|
19
|
+
lines.push(`TIME ${minutes}:${seconds}`);
|
|
20
|
+
return lines.join("\n");
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export function createHud(camera: PerspectiveCamera, primaryLabel: string, counterLabel?: string) {
|
|
12
24
|
const material = new MeshBasicMaterial({
|
|
13
25
|
color: palette.player,
|
|
14
26
|
depthTest: false,
|
|
@@ -21,10 +33,16 @@ export function createHud(camera: PerspectiveCamera, primaryLabel: string, count
|
|
|
21
33
|
camera.add(root);
|
|
22
34
|
return {
|
|
23
35
|
glyphs: 0,
|
|
24
|
-
update(values:
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
36
|
+
update(values: HudValues): void {
|
|
37
|
+
// The HUD changes at most once a second, but update runs per frame — skip the glyph
|
|
38
|
+
// rebuild and the instance upload when the text is unchanged. Placement still recomputes:
|
|
39
|
+
// a resize moves the anchor even when the text has not changed.
|
|
40
|
+
const text = formatHudText(primaryLabel, counterLabel, values);
|
|
41
|
+
const height = 2 * Math.tan(MathUtils.degToRad(camera.fov / 2));
|
|
42
|
+
root.position.set(-height * camera.aspect * 0.46, height * 0.42, -1);
|
|
43
|
+
root.scale.setScalar(height / 160);
|
|
44
|
+
if (text === this.lastText) return;
|
|
45
|
+
this.lastText = text;
|
|
28
46
|
let instance = 0;
|
|
29
47
|
for (const [y, line] of text.split("\n").entries()) {
|
|
30
48
|
for (let x = 0; x < line.length; x += 1) {
|
|
@@ -40,10 +58,8 @@ export function createHud(camera: PerspectiveCamera, primaryLabel: string, count
|
|
|
40
58
|
}
|
|
41
59
|
root.count = this.glyphs = instance;
|
|
42
60
|
root.instanceMatrix.needsUpdate = true;
|
|
43
|
-
const height = 2 * Math.tan(MathUtils.degToRad(camera.fov / 2));
|
|
44
|
-
root.position.set(-height * camera.aspect * 0.46, height * 0.42, -1);
|
|
45
|
-
root.scale.setScalar(height / 160);
|
|
46
61
|
},
|
|
62
|
+
lastText: "",
|
|
47
63
|
dispose(): void {
|
|
48
64
|
root.removeFromParent();
|
|
49
65
|
root.geometry.dispose();
|
|
@@ -5,23 +5,40 @@
|
|
|
5
5
|
// back light, silhouettes read as flat cut-outs against the background.
|
|
6
6
|
import {
|
|
7
7
|
AmbientLight,
|
|
8
|
+
Color,
|
|
8
9
|
DirectionalLight,
|
|
9
10
|
HemisphereLight,
|
|
10
11
|
PCFSoftShadowMap,
|
|
11
12
|
type Scene,
|
|
13
|
+
Vector3,
|
|
12
14
|
} from "three";
|
|
13
15
|
import { palette } from "./palette.js";
|
|
14
16
|
|
|
15
17
|
type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
|
|
18
|
+
type AtmosphereLike = {
|
|
19
|
+
getSunDirection(target?: Vector3): Vector3;
|
|
20
|
+
sunTransmittance(direction: Vector3): unknown;
|
|
21
|
+
};
|
|
16
22
|
|
|
17
|
-
export function setupLighting(
|
|
23
|
+
export function setupLighting(
|
|
24
|
+
scene: Scene,
|
|
25
|
+
renderer: ShadowRenderer,
|
|
26
|
+
atmosphere?: AtmosphereLike,
|
|
27
|
+
): { key: DirectionalLight; updateSun(direction: Vector3): void } {
|
|
18
28
|
renderer.shadowMap.enabled = true;
|
|
19
29
|
renderer.shadowMap.type = PCFSoftShadowMap;
|
|
20
30
|
|
|
21
31
|
scene.add(new HemisphereLight(palette.skyHigh, palette.shadow, 1.6));
|
|
22
32
|
|
|
23
33
|
const key = new DirectionalLight(palette.accent, 3);
|
|
24
|
-
|
|
34
|
+
const updateSun = (direction: Vector3): void => {
|
|
35
|
+
key.position.copy(direction).multiplyScalar(7);
|
|
36
|
+
const transmittance = atmosphere?.sunTransmittance(direction);
|
|
37
|
+
if (transmittance instanceof Vector3) {
|
|
38
|
+
key.color.copy(new Color().setRGB(transmittance.x, transmittance.y, transmittance.z));
|
|
39
|
+
}
|
|
40
|
+
};
|
|
41
|
+
updateSun(atmosphere?.getSunDirection() ?? new Vector3(4, 7, 3).normalize());
|
|
25
42
|
key.castShadow = true;
|
|
26
43
|
// 1024² keeps the default shadow pass at one quarter of a 2048² map's
|
|
27
44
|
// texel storage and fill work. The small generated scene fits this 12-unit
|
|
@@ -43,4 +60,8 @@ export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
|
|
|
43
60
|
scene.add(rim);
|
|
44
61
|
|
|
45
62
|
scene.add(new AmbientLight(palette.shadow, 0.28));
|
|
63
|
+
// The key light travels with the sun updater: `WorldEnvironment`'s godrays stage raymarches
|
|
64
|
+
// against its shadow map, so `setupPost` needs the light itself and refuses a shadowless one
|
|
65
|
+
// by name instead of rendering a black pass.
|
|
66
|
+
return { key, updateSun };
|
|
46
67
|
}
|
|
@@ -1,113 +1,33 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
*/
|
|
15
|
-
export interface LoadingHost {
|
|
1
|
+
import type { Camera, OrthographicCamera, Scene } from "three";
|
|
2
|
+
|
|
3
|
+
/** Minimal deliberately opts out; changing this one source value enables a full authored cover. */
|
|
4
|
+
export const loading = {
|
|
5
|
+
backgroundImage: undefined as string | undefined,
|
|
6
|
+
enabled: false,
|
|
7
|
+
fillImage: undefined as string | undefined,
|
|
8
|
+
logoImage: undefined as string | undefined,
|
|
9
|
+
progressColor: 0xffd27a,
|
|
10
|
+
trackColor: 0x14516e,
|
|
11
|
+
} as const;
|
|
12
|
+
|
|
13
|
+
interface LoadingHost {
|
|
16
14
|
readonly camera: Camera;
|
|
17
|
-
readonly scene: Scene;
|
|
18
15
|
readonly canvasLayer: {
|
|
19
16
|
readonly camera: OrthographicCamera;
|
|
20
17
|
readonly scene: Scene;
|
|
21
18
|
opaque: boolean;
|
|
22
19
|
};
|
|
23
|
-
readonly
|
|
24
|
-
|
|
20
|
+
readonly viewport?: {
|
|
21
|
+
readonly safeArea: {
|
|
22
|
+
readonly height: number;
|
|
23
|
+
readonly width: number;
|
|
24
|
+
readonly x: number;
|
|
25
|
+
readonly y: number;
|
|
26
|
+
};
|
|
27
|
+
};
|
|
25
28
|
}
|
|
26
29
|
|
|
27
|
-
/**
|
|
28
|
-
* Draws the loading screen in the framework's pixel-sized canvas layer. Colours, layout, and the
|
|
29
|
-
* shape of the bar live here in generated source, so they remain the game's to change or delete.
|
|
30
|
-
*/
|
|
31
30
|
export function createLoadingScreen(host: LoadingHost) {
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
const cover = (color: number, renderOrder: number) => {
|
|
35
|
-
const mesh = new Mesh(
|
|
36
|
-
new PlaneGeometry(1, 1),
|
|
37
|
-
new MeshBasicMaterial({ color, depthTest: false, depthWrite: false }),
|
|
38
|
-
);
|
|
39
|
-
mesh.frustumCulled = false;
|
|
40
|
-
mesh.renderOrder = renderOrder;
|
|
41
|
-
layer.scene.add(mesh);
|
|
42
|
-
return mesh;
|
|
43
|
-
};
|
|
44
|
-
const backdrop = cover(palette.skyLow, 0);
|
|
45
|
-
const track = cover(palette.skyHigh, 1);
|
|
46
|
-
const fill = cover(palette.accent, 2);
|
|
47
|
-
const parts = [backdrop, track, fill];
|
|
48
|
-
layer.opaque = true;
|
|
49
|
-
|
|
50
|
-
let width = 0;
|
|
51
|
-
let height = 0;
|
|
52
|
-
let lastProgress = 0;
|
|
53
|
-
|
|
54
|
-
const layout = (): void => {
|
|
55
|
-
const nextWidth = camera.right - camera.left;
|
|
56
|
-
const nextHeight = camera.top - camera.bottom;
|
|
57
|
-
width = Number.isFinite(nextWidth) && nextWidth > 0 ? nextWidth : 1;
|
|
58
|
-
height = Number.isFinite(nextHeight) && nextHeight > 0 ? nextHeight : 1;
|
|
59
|
-
backdrop.scale.set(width, height, 1);
|
|
60
|
-
track.scale.set(width * 0.5, height * 0.012, 1);
|
|
61
|
-
track.position.set(0, -height * 0.05, 0);
|
|
62
|
-
fill.position.set(0, -height * 0.05, 0);
|
|
63
|
-
};
|
|
64
|
-
|
|
65
|
-
const setProgress = (progress: number): void => {
|
|
66
|
-
// `Math.max(0, Math.min(1, NaN))` is NaN, so non-finite progress means no progress.
|
|
67
|
-
lastProgress = Number.isFinite(progress) ? Math.max(0, Math.min(1, progress)) : 0;
|
|
68
|
-
const full = width * 0.5;
|
|
69
|
-
const barWidth = Math.max(full * 0.002, full * lastProgress);
|
|
70
|
-
fill.scale.set(barWidth, height * 0.012, 1);
|
|
71
|
-
fill.position.x = -full / 2 + barWidth / 2;
|
|
72
|
-
};
|
|
73
|
-
|
|
74
|
-
let laidOutWidth = camera.right - camera.left;
|
|
75
|
-
let laidOutHeight = camera.top - camera.bottom;
|
|
76
|
-
layout();
|
|
77
|
-
setProgress(0);
|
|
78
|
-
|
|
79
|
-
let done = false;
|
|
80
|
-
const finish = (): void => {
|
|
81
|
-
if (done) return;
|
|
82
|
-
done = true;
|
|
83
|
-
for (const mesh of parts) {
|
|
84
|
-
mesh.removeFromParent();
|
|
85
|
-
mesh.geometry.dispose();
|
|
86
|
-
mesh.material.dispose();
|
|
87
|
-
}
|
|
88
|
-
layer.opaque = false;
|
|
89
|
-
};
|
|
90
|
-
|
|
91
|
-
void (async () => {
|
|
92
|
-
await host.startup.whenReady();
|
|
93
|
-
// Compile the collapsed world's pipelines while the opaque canvas layer still covers it.
|
|
94
|
-
await host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
|
|
95
|
-
finish();
|
|
96
|
-
})();
|
|
97
|
-
|
|
98
|
-
return {
|
|
99
|
-
update(): void {
|
|
100
|
-
if (done) return;
|
|
101
|
-
const nextWidth = camera.right - camera.left;
|
|
102
|
-
const nextHeight = camera.top - camera.bottom;
|
|
103
|
-
if (nextWidth !== laidOutWidth || nextHeight !== laidOutHeight) {
|
|
104
|
-
laidOutWidth = nextWidth;
|
|
105
|
-
laidOutHeight = nextHeight;
|
|
106
|
-
layout();
|
|
107
|
-
setProgress(lastProgress);
|
|
108
|
-
}
|
|
109
|
-
setProgress(host.startup.progress);
|
|
110
|
-
},
|
|
111
|
-
finish,
|
|
112
|
-
};
|
|
31
|
+
host.canvasLayer.opaque = false;
|
|
32
|
+
return { finish: () => undefined, update: () => undefined };
|
|
113
33
|
}
|
|
@@ -1,20 +1,98 @@
|
|
|
1
1
|
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
2
|
// ThreeNative does not read this file.
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
//
|
|
4
|
+
// `WorldEnvironment`, in this folder, builds the lighting chain: which stages run, in what
|
|
5
|
+
// order, and an honest report of what happened. It prints `TN_WORLD_ENVIRONMENT` naming every
|
|
6
|
+
// stage as applied or refused **with a reason**, so a stage that silently no-op'd is never
|
|
7
|
+
// mistaken for one you turned off. It decides no colour and no strength — every value below is
|
|
8
|
+
// an argument, and they are yours.
|
|
9
|
+
//
|
|
10
|
+
// SSGI and SSR are the expensive pair, so they ship on for desktop and off for mobile. That
|
|
11
|
+
// split is the shipped default, not a ceiling: turn either on for mobile by adding it to
|
|
12
|
+
// `mobilePreset` and read the frame cost back out of `TN_FRAME_BUDGET`. What each stage costs,
|
|
13
|
+
// and the one-line enable for the ones that ship off everywhere (godrays, contact AO,
|
|
14
|
+
// vignette), is in `agent-docs/visual-baseline.md`.
|
|
15
|
+
import type { Camera, DirectionalLight, Scene } from "three";
|
|
16
|
+
import { vec3 } from "three/tsl";
|
|
17
|
+
import type { Node } from "three/webgpu";
|
|
18
|
+
import type { OutputRenderer } from "./worldEnvironment.js";
|
|
19
|
+
import { WorldEnvironment } from "./worldEnvironment.js";
|
|
6
20
|
|
|
7
|
-
type
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
setOutputNode(node: unknown): void;
|
|
21
|
+
type AtmosphereLike = {
|
|
22
|
+
aerialPerspective(scenePass: unknown, depth: unknown, inScatteredRadiance?: unknown): unknown;
|
|
23
|
+
radiance(direction: unknown): unknown;
|
|
11
24
|
};
|
|
12
25
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
26
|
+
// Scene-referred exposure: multiplied into the pass before the tone curve, so the gather, the
|
|
27
|
+
// reflections and the bloom threshold all see the same exposed image.
|
|
28
|
+
const exposure = 1.15;
|
|
29
|
+
|
|
30
|
+
// Unchanged from this template's previous chain — strength, radius and threshold are a look
|
|
31
|
+
// decision that was already tuned to this scene's palette.
|
|
32
|
+
const glow = {
|
|
33
|
+
bloomEnabled: true,
|
|
34
|
+
bloomRadius: 0.5,
|
|
35
|
+
bloomStrength: 0.5,
|
|
36
|
+
bloomThreshold: 0.2,
|
|
37
|
+
} as const;
|
|
38
|
+
|
|
39
|
+
// No SSGI here, and this is the one template where that is a measured decision rather than a
|
|
40
|
+
// taste one: its sky, sun colour and depth haze are a volumetric `Atmosphere`, which already owns
|
|
41
|
+
// most of the frame. With the gather on, `playtests/play.playtest.json` measured **34.2 ms p95
|
|
42
|
+
// against the 33 ms ceiling**; without it the same scenario passes. Turn it on when you replace
|
|
43
|
+
// the atmosphere with a flat sky, and read the p95 back out of `TN_FRAME_BUDGET`.
|
|
44
|
+
const desktopPreset = {
|
|
45
|
+
...glow,
|
|
46
|
+
exposure,
|
|
47
|
+
ssrEnabled: true,
|
|
48
|
+
// `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as
|
|
49
|
+
// "reflections are on and do nothing" — the ray dies a metre from where it started.
|
|
50
|
+
ssrMaxDistance: 20,
|
|
51
|
+
// A reflection carries almost no high-frequency detail, so half resolution costs a quarter
|
|
52
|
+
// of the rays and is very hard to see in the result.
|
|
53
|
+
ssrResolutionScale: 0.5,
|
|
54
|
+
// RCAS puts back the micro-detail the half-resolution reflection and the denoiser take out.
|
|
55
|
+
// The same cause everywhere, so the same value everywhere: **0 is maximum sharpening and 2
|
|
56
|
+
// is none** — it is a radius, not a gain.
|
|
57
|
+
sharpenEnabled: true,
|
|
58
|
+
sharpenStrength: 0.3,
|
|
59
|
+
tonemapMode: "aces",
|
|
60
|
+
} as const;
|
|
61
|
+
|
|
62
|
+
// No SSGI, no SSR, and therefore nothing for the sharpener to put back.
|
|
63
|
+
const mobilePreset = {
|
|
64
|
+
...glow,
|
|
65
|
+
exposure,
|
|
66
|
+
tonemapMode: "aces",
|
|
67
|
+
} as const;
|
|
68
|
+
|
|
69
|
+
export function setupPost(
|
|
70
|
+
renderer: OutputRenderer,
|
|
71
|
+
scene: Scene,
|
|
72
|
+
camera: Camera,
|
|
73
|
+
environment: {
|
|
74
|
+
atmosphere?: AtmosphereLike;
|
|
75
|
+
godraysLight?: DirectionalLight;
|
|
76
|
+
mobile?: boolean;
|
|
77
|
+
} = {},
|
|
78
|
+
): void {
|
|
79
|
+
const world = new WorldEnvironment(environment.mobile === true ? mobilePreset : desktopPreset);
|
|
80
|
+
const atmosphere = environment.atmosphere;
|
|
81
|
+
world.apply(renderer, scene, camera, {
|
|
82
|
+
// The chain builds the scene pass, so aerial perspective — which needs that pass and its
|
|
83
|
+
// view-Z — is composed here, first, before exposure and before any stage. Delete this
|
|
84
|
+
// property to drop aerial perspective while keeping the sky and the rest of the chain.
|
|
85
|
+
baseColour:
|
|
86
|
+
atmosphere === undefined
|
|
87
|
+
? undefined
|
|
88
|
+
: (scenePass) =>
|
|
89
|
+
atmosphere.aerialPerspective(
|
|
90
|
+
scenePass,
|
|
91
|
+
scenePass.getViewZNode(),
|
|
92
|
+
// Same scale as the dome in sky.ts, and for the same reason: this radiance is
|
|
93
|
+
// mixed into every pixel by the haze term, so at 24 it lifted the whole frame.
|
|
94
|
+
(atmosphere.radiance(vec3(0, 0, 1)) as Node<"vec3">).mul(1.5),
|
|
95
|
+
) as Node<"vec4">,
|
|
96
|
+
godraysLight: environment.godraysLight,
|
|
97
|
+
});
|
|
20
98
|
}
|
|
@@ -1,41 +1,46 @@
|
|
|
1
|
-
// Generated for you.
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
MathUtils,
|
|
8
|
-
Mesh,
|
|
9
|
-
MeshBasicMaterial,
|
|
10
|
-
type Scene,
|
|
11
|
-
SphereGeometry,
|
|
12
|
-
} from "three";
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
// The atmosphere object is mechanism; this file owns the mesh, material, and exposure.
|
|
3
|
+
import { BackSide, Color, Mesh, type Scene, SphereGeometry } from "three";
|
|
4
|
+
import { cameraPosition, normalize, positionWorld } from "three/tsl";
|
|
5
|
+
import { MeshBasicNodeMaterial } from "three/webgpu";
|
|
6
|
+
import type { Node } from "three/webgpu";
|
|
13
7
|
import { palette } from "./palette.js";
|
|
14
8
|
|
|
15
|
-
|
|
9
|
+
type AtmosphereLike = {
|
|
10
|
+
radiance(direction: unknown): unknown;
|
|
11
|
+
};
|
|
12
|
+
|
|
13
|
+
export function setupSky(scene: Scene, atmosphere?: AtmosphereLike): void {
|
|
16
14
|
const top = new Color(palette.skyHigh);
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
const colors = new Float32Array(positions.count * 3);
|
|
22
|
-
const color = new Color();
|
|
23
|
-
for (let index = 0; index < positions.count; index += 1) {
|
|
24
|
-
const height = MathUtils.clamp((positions.getY(index) / radius + 0.2) / 0.65, 0, 1);
|
|
25
|
-
color.copy(bottom).lerp(top, height);
|
|
26
|
-
colors.set([color.r, color.g, color.b], index * 3);
|
|
15
|
+
if (atmosphere === undefined) {
|
|
16
|
+
scene.background = top;
|
|
17
|
+
scene.fog = null;
|
|
18
|
+
return;
|
|
27
19
|
}
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
20
|
+
|
|
21
|
+
// Keep the dome outside the deliberately kilometre-scale atmosphere probe in Play.ts. The
|
|
22
|
+
// view-space depth remains metres, so the package can apply its supplied 1/km coefficients.
|
|
23
|
+
const geometry = new SphereGeometry(20_000, 24, 12);
|
|
24
|
+
const material = new MeshBasicNodeMaterial({
|
|
25
|
+
fog: false,
|
|
26
|
+
side: BackSide,
|
|
27
|
+
toneMapped: false,
|
|
28
|
+
});
|
|
29
|
+
const viewDirection = normalize(positionWorld.sub(cameraPosition));
|
|
30
|
+
// 24 was authored when this template had no post chain, so the dome's radiance landed straight
|
|
31
|
+
// in the frame. The chain now exposes the pass at 1.15 and tone-maps it with ACES, and the same
|
|
32
|
+
// radiance is *also* fed to `aerialPerspective` as in-scattering in postprocessing.ts — so 24
|
|
33
|
+
// was being applied twice over and then exposed again. Measured on a scaffolded minimal, median
|
|
34
|
+
// frame luminance was 203 of 255 at 24 and is 25 at 1.5, against 22 for this template's last
|
|
35
|
+
// good baseline. Both multipliers moved together; neither alone reaches it.
|
|
36
|
+
material.colorNode = (atmosphere.radiance(viewDirection) as Node<"vec3">).mul(1.5);
|
|
37
|
+
const dome = new Mesh(geometry, material);
|
|
38
|
+
// The dome is authored at the origin and never moves; freeze only this known-static render
|
|
39
|
+
// object, leaving gameplay transforms under user control.
|
|
35
40
|
dome.updateMatrix();
|
|
36
41
|
dome.matrixAutoUpdate = false;
|
|
37
42
|
dome.frustumCulled = false;
|
|
38
|
-
scene.background =
|
|
39
|
-
scene.fog =
|
|
43
|
+
scene.background = null;
|
|
44
|
+
scene.fog = null;
|
|
40
45
|
scene.add(dome);
|
|
41
46
|
}
|