create-threenative 0.2.6 → 0.2.7
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 +2 -2
- package/agent-docs/references/build-profiles.md +126 -0
- package/agent-docs/references/capability-reference.md +431 -20
- package/agent-docs/references/performance-basics.md +8 -5
- package/agent-docs/references/sculpt-from-a-reference.md +1 -1
- package/agent-docs/references/trace-a-slow-frame.md +1 -1
- package/agent-docs/references/visual-baseline.md +8 -4
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
- package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
- package/capabilities.json +555 -21
- package/dist/index.d.ts +30 -1
- package/dist/index.js +294 -55
- package/dist/threenative.js +714 -154
- package/package.json +6 -6
- package/template-assets/assets/mannequin-combat.glb +0 -0
- package/template-assets/assets/mannequin.glb +0 -0
- package/template-assets/assets/player-viewmodel.glb +0 -0
- package/template-assets/assets/sky.jpg +0 -0
- package/template-assets/clearwater/README.md +141 -0
- package/template-assets/clearwater/install.mjs +50 -0
- package/template-assets/clearwater/src/clearwater.ts +180 -0
- package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
- package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
- package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
- package/template-assets/clearwater/src/render/clearwater.ts +278 -0
- package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
- package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
- package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
- package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
- package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
- package/template-assets/patches/three@0.185.1.patch +2101 -138
- package/template-assets/worldEnvironment.ts +52 -1
- package/templates/action-rpg/AGENTS.md +42 -42
- package/templates/action-rpg/CLAUDE.md +42 -42
- package/templates/action-rpg/kit.json +1 -1
- package/templates/action-rpg/package.json +13 -7
- package/templates/action-rpg/playtests/combat.playtest.json +162 -23
- package/templates/action-rpg/playtests/performance.playtest.json +4 -3
- package/templates/action-rpg/playtests/survives.playtest.json +25 -8
- package/templates/action-rpg/src/conventions.ts +24 -18
- package/templates/action-rpg/src/entities/Enemy.ts +74 -24
- package/templates/action-rpg/src/entities/Fighter.ts +127 -0
- package/templates/action-rpg/src/entities/Player.ts +102 -32
- package/templates/action-rpg/src/game.ts +3 -3
- package/templates/action-rpg/src/render/camera.ts +18 -16
- package/templates/action-rpg/src/render/dungeon.ts +192 -0
- package/templates/action-rpg/src/render/lighting.ts +45 -28
- package/templates/action-rpg/src/render/loading.ts +4 -4
- package/templates/action-rpg/src/render/materials.ts +191 -47
- package/templates/action-rpg/src/render/palette.ts +14 -13
- package/templates/action-rpg/src/render/postprocessing.ts +12 -2
- package/templates/action-rpg/src/render/props.ts +117 -0
- package/templates/action-rpg/src/render/quality.ts +40 -82
- package/templates/action-rpg/src/render/sky.ts +36 -13
- package/templates/action-rpg/src/render/touch-controls.ts +1 -1
- package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
- package/templates/action-rpg/src/scenes/Play.ts +61 -39
- package/templates/action-rpg/src/style.css +9 -7
- package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
- package/templates/action-rpg/src/ui/Hud.tsx +3 -3
- package/templates/action-rpg/threenative.config.ts +14 -1
- package/templates/action-rpg/vite.config.ts +4 -1
- package/templates/minimal/AGENTS.md +10 -10
- package/templates/minimal/CLAUDE.md +10 -10
- package/templates/minimal/package.json +12 -6
- package/templates/minimal/playtests/play.playtest.json +6 -5
- package/templates/minimal/playtests/sky.playtest.json +27 -0
- package/templates/minimal/src/conventions.ts +6 -3
- package/templates/minimal/src/entities/Player.ts +73 -27
- package/templates/minimal/src/main.ts +2 -3
- package/templates/minimal/src/render/camera.ts +22 -4
- package/templates/minimal/src/render/lighting.ts +24 -48
- package/templates/minimal/src/render/materials.ts +158 -13
- package/templates/minimal/src/render/palette.ts +10 -7
- package/templates/minimal/src/render/postprocessing.ts +12 -25
- package/templates/minimal/src/render/quality.ts +35 -69
- package/templates/minimal/src/render/sky.ts +35 -54
- package/templates/minimal/src/render/touch-controls.ts +1 -1
- package/templates/minimal/src/render/worldEnvironment.ts +52 -1
- package/templates/minimal/src/scenes/Play.ts +121 -111
- package/templates/minimal/src/state.ts +0 -4
- package/templates/minimal/src/style.css +0 -10
- package/templates/minimal/threenative.config.ts +14 -1
- package/templates/minimal/vite.config.ts +4 -1
- package/templates/platformer/AGENTS.md +18 -56
- package/templates/platformer/CLAUDE.md +18 -56
- package/templates/platformer/kit.json +2 -2
- package/templates/platformer/package.json +13 -9
- package/templates/platformer/playtests/buffer.playtest.json +15 -5
- package/templates/platformer/playtests/collect.playtest.json +8 -34
- package/templates/platformer/playtests/coyote.playtest.json +12 -34
- package/templates/platformer/playtests/damage.playtest.json +40 -15
- package/templates/platformer/playtests/hud.playtest.json +34 -0
- package/templates/platformer/playtests/move.playtest.json +24 -0
- package/templates/platformer/playtests/performance.playtest.json +24 -7
- package/templates/platformer/playtests/respawn.playtest.json +46 -11
- package/templates/platformer/playtests/stomp.playtest.json +49 -12
- package/templates/platformer/playtests/survives.playtest.json +3 -19
- package/templates/platformer/playtests/world.playtest.json +26 -0
- package/templates/platformer/src/entities/Fox.ts +273 -0
- package/templates/platformer/src/entities/Pickup.ts +43 -60
- package/templates/platformer/src/entities/Walker.ts +88 -0
- package/templates/platformer/src/game.ts +11 -8
- package/templates/platformer/src/level/Checkpoints.ts +29 -16
- package/templates/platformer/src/level/Stage.ts +469 -0
- package/templates/platformer/src/render/blocks.ts +94 -0
- package/templates/platformer/src/render/camera.ts +28 -3
- package/templates/platformer/src/render/fox.ts +196 -0
- package/templates/platformer/src/render/lighting.ts +42 -33
- package/templates/platformer/src/render/materials.ts +115 -5
- package/templates/platformer/src/render/palette.ts +68 -53
- package/templates/platformer/src/render/pickups.ts +142 -0
- package/templates/platformer/src/render/postprocessing.ts +12 -2
- package/templates/platformer/src/render/props.ts +147 -0
- package/templates/platformer/src/render/quality.ts +47 -99
- package/templates/platformer/src/render/scenery.ts +172 -0
- package/templates/platformer/src/render/sky.ts +120 -31
- package/templates/platformer/src/render/touch-controls.ts +5 -2
- package/templates/platformer/src/render/walkers.ts +96 -0
- package/templates/platformer/src/render/waterfall.ts +85 -0
- package/templates/platformer/src/render/worldEnvironment.ts +52 -1
- package/templates/platformer/src/scenes/Boot.ts +3 -4
- package/templates/platformer/src/scenes/Play.ts +362 -0
- package/templates/platformer/src/state.ts +16 -14
- package/templates/platformer/src/style.css +9 -8
- package/templates/platformer/src/ui/Hud.tsx +62 -29
- package/templates/platformer/src/ui/Menu.tsx +2 -2
- package/templates/platformer/threenative.config.ts +14 -1
- package/templates/platformer/vite.config.ts +4 -1
- package/templates/puzzle/AGENTS.md +19 -20
- package/templates/puzzle/CLAUDE.md +19 -20
- package/templates/puzzle/assets/native-proof.glb +0 -0
- package/templates/puzzle/assets/native-proof.png +0 -0
- package/templates/puzzle/kit.json +1 -1
- package/templates/puzzle/package.json +13 -7
- package/templates/puzzle/playtests/axis.playtest.json +20 -0
- package/templates/puzzle/playtests/blocked.playtest.json +73 -0
- package/templates/puzzle/playtests/caused.playtest.json +65 -0
- package/templates/puzzle/playtests/lit.playtest.json +74 -0
- package/templates/puzzle/playtests/performance.playtest.json +24 -7
- package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
- package/templates/puzzle/playtests/replay.playtest.json +81 -0
- package/templates/puzzle/playtests/restart.playtest.json +108 -0
- package/templates/puzzle/playtests/seal.playtest.json +98 -0
- package/templates/puzzle/playtests/settle.playtest.json +100 -0
- package/templates/puzzle/playtests/survives.playtest.json +6 -29
- package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
- package/templates/puzzle/src/entities/Crate.ts +99 -42
- package/templates/puzzle/src/entities/Seal.ts +69 -0
- package/templates/puzzle/src/entities/Warden.ts +135 -0
- package/templates/puzzle/src/game.ts +15 -11
- package/templates/puzzle/src/render/camera.ts +66 -31
- package/templates/puzzle/src/render/crateShape.ts +70 -0
- package/templates/puzzle/src/render/lighting.ts +41 -41
- package/templates/puzzle/src/render/loading.ts +4 -4
- package/templates/puzzle/src/render/materials.ts +131 -27
- package/templates/puzzle/src/render/palette.ts +19 -29
- package/templates/puzzle/src/render/postprocessing.ts +15 -3
- package/templates/puzzle/src/render/quality.ts +71 -80
- package/templates/puzzle/src/render/shapes.ts +109 -108
- package/templates/puzzle/src/render/sky.ts +18 -10
- package/templates/puzzle/src/render/touch-controls.ts +8 -51
- package/templates/puzzle/src/render/vault.ts +315 -0
- package/templates/puzzle/src/render/warden.ts +46 -0
- package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
- package/templates/puzzle/src/scenes/Play.ts +793 -0
- package/templates/puzzle/src/state.ts +55 -24
- package/templates/puzzle/src/style.css +7 -8
- package/templates/puzzle/src/ui/App.tsx +2 -2
- package/templates/puzzle/src/ui/Hud.tsx +92 -40
- package/templates/puzzle/src/ui/Menu.tsx +40 -2
- package/templates/puzzle/threenative.config.ts +14 -1
- package/templates/puzzle/vite.config.ts +4 -1
- package/templates/racing/AGENTS.md +19 -20
- package/templates/racing/CLAUDE.md +19 -20
- package/templates/racing/package.json +13 -7
- package/templates/racing/playtests/boost.playtest.json +33 -12
- package/templates/racing/playtests/outcome.playtest.json +32 -50
- package/templates/racing/playtests/performance.playtest.json +2 -1
- package/templates/racing/playtests/ranking.playtest.json +5 -14
- package/templates/racing/playtests/rescue.playtest.json +2 -2
- package/templates/racing/playtests/reverse.playtest.json +30 -8
- package/templates/racing/playtests/shortcut.playtest.json +54 -9
- package/templates/racing/playtests/touch-controls.playtest.json +32 -5
- package/templates/racing/src/entities/CarBody.ts +327 -0
- package/templates/racing/src/entities/LineDriver.ts +220 -0
- package/templates/racing/src/entities/RacingCar.ts +150 -89
- package/templates/racing/src/entities/Rival.ts +61 -24
- package/templates/racing/src/game.ts +5 -0
- package/templates/racing/src/render/camera.ts +49 -7
- package/templates/racing/src/render/lighting.ts +36 -37
- package/templates/racing/src/render/materials.ts +239 -19
- package/templates/racing/src/render/palette.ts +19 -21
- package/templates/racing/src/render/postprocessing.ts +12 -2
- package/templates/racing/src/render/quality.ts +43 -82
- package/templates/racing/src/render/shapes.ts +20 -6
- package/templates/racing/src/render/sky.ts +47 -39
- package/templates/racing/src/render/touch-controls.ts +1 -1
- package/templates/racing/src/render/worldEnvironment.ts +52 -1
- package/templates/racing/src/scenes/Race.ts +107 -54
- package/templates/racing/src/state.ts +2 -0
- package/templates/racing/src/track/Checkline.ts +22 -7
- package/templates/racing/src/track/Lap.ts +64 -36
- package/templates/racing/src/track/Ranking.ts +20 -11
- package/templates/racing/src/track/Track.ts +809 -361
- package/templates/racing/src/track/TrackSector.ts +40 -11
- package/templates/racing/src/track/circuit.ts +477 -0
- package/templates/racing/src/track/rescue.ts +16 -4
- package/templates/racing/threenative.config.ts +14 -1
- package/templates/racing/vite.config.ts +4 -1
- package/templates/rts/AGENTS.md +96 -0
- package/templates/rts/CLAUDE.md +98 -0
- package/templates/rts/kit.json +7 -0
- package/templates/{defense → rts}/package.json +13 -7
- package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
- package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
- package/templates/rts/playtests/rts-attack.playtest.json +75 -0
- package/templates/rts/playtests/rts-build.playtest.json +68 -0
- package/templates/rts/playtests/rts-orders.playtest.json +150 -0
- package/templates/rts/playtests/rts-train.playtest.json +62 -0
- package/templates/rts/playtests/survives.playtest.json +58 -0
- package/templates/rts/public/favicon.svg +4 -0
- package/templates/rts/src/game.ts +64 -0
- package/templates/rts/src/orders.ts +22 -0
- package/templates/rts/src/render/army.ts +346 -0
- package/templates/rts/src/render/camera.ts +123 -0
- package/templates/rts/src/render/lighting.ts +61 -0
- package/templates/rts/src/render/loading.ts +33 -0
- package/templates/rts/src/render/materials.ts +152 -0
- package/templates/rts/src/render/models.ts +705 -0
- package/templates/rts/src/render/palette.ts +17 -0
- package/templates/rts/src/render/picking.ts +93 -0
- package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
- package/templates/rts/src/render/quality.ts +128 -0
- package/templates/rts/src/render/resources.ts +141 -0
- package/templates/rts/src/render/sky.ts +44 -0
- package/templates/rts/src/render/terrain.ts +116 -0
- package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
- package/templates/rts/src/scenes/Play.ts +650 -0
- package/templates/rts/src/sim/ai.ts +1140 -0
- package/templates/rts/src/sim/combat.ts +416 -0
- package/templates/rts/src/sim/construction.ts +374 -0
- package/templates/rts/src/sim/economy.ts +167 -0
- package/templates/rts/src/sim/game.ts +1082 -0
- package/templates/rts/src/sim/movement.ts +371 -0
- package/templates/rts/src/sim/nav.ts +276 -0
- package/templates/rts/src/sim/production.ts +180 -0
- package/templates/rts/src/sim/terrain.ts +170 -0
- package/templates/rts/src/sim/types.ts +647 -0
- package/templates/rts/src/sim/vision.ts +46 -0
- package/templates/rts/src/state.ts +100 -0
- package/templates/{defense → rts}/src/style.css +21 -8
- package/templates/rts/src/ui/App.tsx +21 -0
- package/templates/rts/src/ui/Commands.tsx +129 -0
- package/templates/rts/src/ui/GameUi.tsx +22 -0
- package/templates/rts/src/ui/Hud.tsx +165 -0
- package/templates/rts/src/ui/Minimap.tsx +84 -0
- package/templates/rts/tailwind.config.ts +2 -0
- package/templates/rts/threenative.config.ts +56 -0
- package/templates/rts/tsconfig.json +17 -0
- package/templates/{defense → rts}/vite.config.ts +4 -1
- package/templates/runner/AGENTS.md +6 -10
- package/templates/runner/CLAUDE.md +6 -10
- package/templates/runner/README.md +3 -3
- package/templates/runner/package.json +13 -7
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +4 -3
- package/templates/runner/src/entities/Runner.ts +54 -7
- package/templates/runner/src/game.ts +2 -0
- package/templates/runner/src/render/camera.ts +4 -2
- package/templates/runner/src/render/dust.ts +5 -2
- package/templates/runner/src/render/lighting.ts +41 -45
- package/templates/runner/src/render/loading.ts +2 -2
- package/templates/runner/src/render/materials.ts +165 -25
- package/templates/runner/src/render/palette.ts +17 -28
- package/templates/runner/src/render/postprocessing.ts +12 -2
- package/templates/runner/src/render/quality.ts +42 -96
- package/templates/runner/src/render/shapes.ts +59 -37
- package/templates/runner/src/render/sky.ts +32 -41
- package/templates/runner/src/render/touch-controls.ts +1 -1
- package/templates/runner/src/render/worldEnvironment.ts +52 -1
- package/templates/runner/src/scenes/Run.ts +26 -6
- package/templates/runner/src/track.ts +6 -1
- package/templates/runner/threenative.config.ts +14 -1
- package/templates/runner/vite.config.ts +4 -1
- package/templates/sailing/AGENTS.md +12 -12
- package/templates/sailing/CLAUDE.md +12 -12
- package/templates/sailing/assets/ship.glb +0 -0
- package/templates/sailing/package.json +13 -7
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
- package/templates/sailing/playtests/sails.playtest.json +33 -0
- package/templates/sailing/playtests/win.playtest.json +156 -8
- package/templates/sailing/src/conventions.ts +29 -2
- package/templates/sailing/src/entities/Ship.ts +381 -57
- package/templates/sailing/src/game.ts +14 -0
- package/templates/sailing/src/render/camera.ts +63 -9
- package/templates/sailing/src/render/lighting.ts +49 -27
- package/templates/sailing/src/render/materials.ts +50 -15
- package/templates/sailing/src/render/ocean.ts +647 -60
- package/templates/sailing/src/render/palette.ts +16 -12
- package/templates/sailing/src/render/postprocessing.ts +12 -2
- package/templates/sailing/src/render/props.ts +316 -442
- package/templates/sailing/src/render/quality.ts +14 -4
- package/templates/sailing/src/render/sky.ts +116 -23
- package/templates/sailing/src/render/worldEnvironment.ts +52 -1
- package/templates/sailing/src/scenes/Boot.ts +21 -0
- package/templates/sailing/src/scenes/Sailing.ts +173 -39
- package/templates/sailing/src/state.ts +6 -0
- package/templates/sailing/src/ui/Hud.tsx +41 -9
- package/templates/sailing/threenative.config.ts +14 -1
- package/templates/sailing/vite.config.ts +4 -1
- package/templates/shooter/AGENTS.md +27 -42
- package/templates/shooter/CLAUDE.md +27 -42
- package/templates/shooter/index.html +1 -0
- package/templates/shooter/package.json +13 -7
- package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
- package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
- package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
- package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
- package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
- package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
- package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
- package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
- package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
- package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
- package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
- package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
- package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
- package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
- package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
- package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
- package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
- package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
- package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
- package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
- package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
- package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
- package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
- package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
- package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
- package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
- package/templates/shooter/playtests/input-control.playtest.json +43 -98
- package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
- package/templates/shooter/playtests/performance.playtest.json +62 -26
- package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
- package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
- package/templates/shooter/playtests/survives.playtest.json +36 -30
- package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
- package/templates/shooter/src/entities/Breakables.ts +412 -0
- package/templates/shooter/src/entities/Enemy.ts +2095 -0
- package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
- package/templates/shooter/src/entities/Rifle.ts +442 -0
- package/templates/shooter/src/entities/Target.ts +199 -83
- package/templates/shooter/src/entities/TouchControls.ts +276 -0
- package/templates/shooter/src/game.ts +75 -41
- package/templates/shooter/src/main.ts +0 -1
- package/templates/shooter/src/postPhysics.ts +36 -0
- package/templates/shooter/src/render/camera.ts +78 -74
- package/templates/shooter/src/render/decals.ts +142 -82
- package/templates/shooter/src/render/facade.ts +1373 -0
- package/templates/shooter/src/render/gunfx.ts +704 -0
- package/templates/shooter/src/render/lighting.ts +52 -38
- package/templates/shooter/src/render/loading.ts +2 -2
- package/templates/shooter/src/render/materials.ts +100 -88
- package/templates/shooter/src/render/occlusion.ts +108 -0
- package/templates/shooter/src/render/palette.ts +10 -10
- package/templates/shooter/src/render/palm.ts +455 -0
- package/templates/shooter/src/render/pooled-billboards.ts +144 -0
- package/templates/shooter/src/render/postprocessing.ts +15 -3
- package/templates/shooter/src/render/quality.ts +40 -82
- package/templates/shooter/src/render/scale.ts +148 -15
- package/templates/shooter/src/render/shapes.ts +138 -613
- package/templates/shooter/src/render/sky.ts +35 -35
- package/templates/shooter/src/render/town-schematic.ts +120 -0
- package/templates/shooter/src/render/town.ts +986 -0
- package/templates/shooter/src/render/townMaterials.ts +160 -0
- package/templates/shooter/src/render/vehicles.ts +741 -0
- package/templates/shooter/src/render/worldEnvironment.ts +52 -1
- package/templates/shooter/src/scenes/Play.ts +727 -650
- package/templates/shooter/src/state.ts +26 -41
- package/templates/shooter/src/style.css +207 -11
- package/templates/shooter/src/surfaces.ts +131 -0
- package/templates/shooter/src/ui/App.tsx +9 -10
- package/templates/shooter/src/ui/Crosshair.tsx +25 -18
- package/templates/shooter/src/ui/GameUi.tsx +6 -9
- package/templates/shooter/src/ui/Hud.tsx +428 -39
- package/templates/shooter/src/ui/Minimap.tsx +164 -0
- package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
- package/templates/shooter/src/ui/main.tsx +2 -3
- package/templates/shooter/threenative.config.ts +14 -1
- package/templates/shooter/vite.config.ts +4 -1
- package/templates/starter/AGENTS.md +17 -17
- package/templates/starter/CLAUDE.md +17 -17
- package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
- package/templates/starter/package.json +13 -7
- package/templates/starter/playtests/play.playtest.json +2 -1
- package/templates/starter/playtests/survives.playtest.json +1 -1
- package/templates/starter/src/conventions.ts +6 -3
- package/templates/starter/src/entities/Goal.ts +35 -42
- package/templates/starter/src/entities/Player.ts +99 -16
- package/templates/starter/src/render/arena.ts +131 -0
- package/templates/starter/src/render/lighting.ts +27 -44
- package/templates/starter/src/render/materials.ts +164 -35
- package/templates/starter/src/render/palette.ts +16 -16
- package/templates/starter/src/render/postprocessing.ts +6 -7
- package/templates/starter/src/render/quality.ts +43 -101
- package/templates/starter/src/render/shapes.ts +1 -1
- package/templates/starter/src/render/sky.ts +39 -45
- package/templates/starter/src/render/touch-controls.ts +3 -1
- package/templates/starter/src/render/worldEnvironment.ts +52 -1
- package/templates/starter/src/scenes/Play.ts +82 -81
- package/templates/starter/threenative.config.ts +14 -1
- package/templates/starter/vite.config.ts +4 -1
- package/templates/tower-defense/.codex/config.toml +19 -0
- package/templates/tower-defense/.cursor/mcp.json +32 -0
- package/templates/tower-defense/.gemini/settings.json +32 -0
- package/templates/tower-defense/.mcp.json +32 -0
- package/templates/tower-defense/.vscode/mcp.json +36 -0
- package/templates/tower-defense/.zed/settings.json +36 -0
- package/templates/{defense → tower-defense}/AGENTS.md +14 -12
- package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
- package/templates/tower-defense/README.md +16 -0
- package/templates/tower-defense/index.html +12 -0
- package/templates/tower-defense/kit.json +7 -0
- package/templates/tower-defense/opencode.json +41 -0
- package/templates/tower-defense/package.json +56 -0
- package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
- package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
- package/templates/tower-defense/playtests/look.playtest.json +130 -0
- package/templates/tower-defense/playtests/performance.playtest.json +77 -0
- package/templates/tower-defense/playtests/placement.playtest.json +115 -0
- package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
- package/templates/tower-defense/playtests/strike.playtest.json +98 -0
- package/templates/tower-defense/playtests/survives.playtest.json +85 -0
- package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
- package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
- package/templates/tower-defense/playtests/victory.playtest.json +810 -0
- package/templates/tower-defense/src/balance.ts +187 -0
- package/templates/tower-defense/src/board/Board.ts +100 -0
- package/templates/tower-defense/src/board/Route.ts +84 -0
- package/templates/tower-defense/src/camera-rig.ts +62 -0
- package/templates/tower-defense/src/economy.ts +64 -0
- package/templates/tower-defense/src/effects/Effects.ts +284 -0
- package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
- package/templates/tower-defense/src/game.ts +72 -0
- package/templates/tower-defense/src/intents.ts +21 -0
- package/templates/tower-defense/src/main.ts +15 -0
- package/templates/tower-defense/src/physics.ts +6 -0
- package/templates/tower-defense/src/render/camera.ts +38 -0
- package/templates/tower-defense/src/render/lighting.ts +42 -0
- package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
- package/templates/tower-defense/src/render/materials.ts +103 -0
- package/templates/tower-defense/src/render/palette.ts +58 -0
- package/templates/tower-defense/src/render/postprocessing.ts +46 -0
- package/templates/tower-defense/src/render/quality.ts +128 -0
- package/templates/tower-defense/src/render/shapes.ts +550 -0
- package/templates/tower-defense/src/render/sky.ts +27 -0
- package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
- package/templates/tower-defense/src/scenes/Battle.ts +539 -0
- package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
- package/templates/tower-defense/src/state.ts +88 -0
- package/templates/tower-defense/src/style.css +137 -0
- package/templates/tower-defense/src/towers/Tower.ts +230 -0
- package/templates/tower-defense/src/towers/targeting.ts +97 -0
- package/templates/tower-defense/src/ui/Hud.tsx +270 -0
- package/templates/tower-defense/src/ui/Menu.tsx +134 -0
- package/templates/tower-defense/src/ui/icons.tsx +54 -0
- package/templates/tower-defense/src/ui/main.tsx +14 -0
- package/templates/tower-defense/src/waves.ts +90 -0
- package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
- package/templates/tower-defense/vite.config.ts +41 -0
- package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
- package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
- package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
- package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
- package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
- package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
- package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
- package/agent-files/AGENT-ROLES.md +0 -26
- package/templates/action-rpg/src/render/shapes.ts +0 -269
- package/templates/action-rpg/src/render/types.ts +0 -3
- package/templates/action-rpg/src/scenes/Boot.ts +0 -12
- package/templates/defense/README.md +0 -10
- package/templates/defense/kit.json +0 -7
- package/templates/defense/playtests/leak.playtest.json +0 -23
- package/templates/defense/playtests/placement.playtest.json +0 -40
- package/templates/defense/playtests/scan.playtest.json +0 -20
- package/templates/defense/playtests/survive.playtest.json +0 -45
- package/templates/defense/playtests/survives.playtest.json +0 -36
- package/templates/defense/src/attackers/Attacker.ts +0 -120
- package/templates/defense/src/board/Route.ts +0 -94
- package/templates/defense/src/conventions.ts +0 -18
- package/templates/defense/src/economy.ts +0 -36
- package/templates/defense/src/entities/Player.ts +0 -52
- package/templates/defense/src/game.ts +0 -51
- package/templates/defense/src/physics.ts +0 -13
- package/templates/defense/src/placement/Buildable.ts +0 -49
- package/templates/defense/src/render/camera.ts +0 -16
- package/templates/defense/src/render/lighting.ts +0 -37
- package/templates/defense/src/render/materials.ts +0 -22
- package/templates/defense/src/render/palette.ts +0 -28
- package/templates/defense/src/render/quality.ts +0 -170
- package/templates/defense/src/render/shapes.ts +0 -246
- package/templates/defense/src/render/sky.ts +0 -45
- package/templates/defense/src/scenes/Boot.ts +0 -12
- package/templates/defense/src/scenes/Defense.ts +0 -231
- package/templates/defense/src/state.ts +0 -56
- package/templates/defense/src/towers/Tower.ts +0 -95
- package/templates/defense/src/towers/targeting.ts +0 -53
- package/templates/defense/src/ui/Hud.tsx +0 -62
- package/templates/defense/src/ui/Menu.tsx +0 -7
- package/templates/defense/src/waves.ts +0 -40
- package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
- package/templates/minimal/src/render/hud.ts +0 -69
- package/templates/platformer/playtests/avoidance.playtest.json +0 -28
- package/templates/platformer/playtests/chase.playtest.json +0 -21
- package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
- package/templates/platformer/playtests/oneway.playtest.json +0 -44
- package/templates/platformer/playtests/patrol.playtest.json +0 -13
- package/templates/platformer/playtests/physics.playtest.json +0 -14
- package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
- package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
- package/templates/platformer/src/conventions.ts +0 -18
- package/templates/platformer/src/entities/Character.ts +0 -286
- package/templates/platformer/src/entities/Chaser.ts +0 -118
- package/templates/platformer/src/entities/Patrol.ts +0 -93
- package/templates/platformer/src/level/Platform.ts +0 -46
- package/templates/platformer/src/render/rig.ts +0 -60
- package/templates/platformer/src/render/terrain.ts +0 -31
- package/templates/platformer/src/scenes/Level.ts +0 -241
- package/templates/puzzle/README.md +0 -43
- package/templates/puzzle/playtests/carry.playtest.json +0 -71
- package/templates/puzzle/playtests/swing.playtest.json +0 -38
- package/templates/puzzle/src/conventions.ts +0 -25
- package/templates/puzzle/src/entities/Ball.ts +0 -70
- package/templates/puzzle/src/entities/Gripper.ts +0 -69
- package/templates/puzzle/src/entities/Pendulum.ts +0 -89
- package/templates/puzzle/src/physics.ts +0 -19
- package/templates/puzzle/src/room.ts +0 -83
- package/templates/puzzle/src/scenes/Boot.ts +0 -12
- package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
- package/templates/shooter/playtests/combat.playtest.json +0 -48
- package/templates/shooter/playtests/fail.playtest.json +0 -31
- package/templates/shooter/playtests/per-item.playtest.json +0 -59
- package/templates/shooter/playtests/shooter.playtest.json +0 -99
- package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
- package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
- package/templates/shooter/src/combat/damage.ts +0 -40
- package/templates/shooter/src/conventions.ts +0 -51
- package/templates/shooter/src/entities/Pickup.ts +0 -70
- package/templates/shooter/src/entities/Player.ts +0 -310
- package/templates/shooter/src/level/SpawnPoints.ts +0 -28
- package/templates/shooter/src/playtest-events.ts +0 -15
- package/templates/shooter/src/render/touch-controls.ts +0 -305
- package/templates/shooter/src/render/types.ts +0 -3
- package/templates/shooter/src/render/ui.css +0 -330
- package/templates/shooter/src/render/ui.ts +0 -75
- package/templates/shooter/src/render/vfx.ts +0 -215
- package/templates/shooter/src/ui/Menu.tsx +0 -41
- package/templates/shooter/src/waves.ts +0 -50
- package/templates/shooter/src/weapons/Hitscan.ts +0 -42
- package/templates/shooter/src/weapons/Projectile.ts +0 -92
- package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
- package/templates/starter/playtests/assets.playtest.json +0 -65
- package/templates/starter/playtests/buffer.playtest.json +0 -79
- package/templates/starter/playtests/cloth.playtest.json +0 -113
- package/templates/starter/playtests/coyote.playtest.json +0 -87
- package/templates/starter/playtests/gameover.playtest.json +0 -66
- package/templates/starter/playtests/goal.playtest.json +0 -67
- package/templates/starter/playtests/look.playtest.json +0 -175
- package/templates/starter/playtests/models-baseline.png +0 -0
- package/templates/starter/playtests/models.playtest.json +0 -74
- package/templates/starter/playtests/monitoring.playtest.json +0 -72
- package/templates/starter/playtests/odometer.playtest.json +0 -54
- package/templates/starter/playtests/restart.playtest.json +0 -91
- package/templates/starter/playtests/seed.playtest.json +0 -54
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +0 -74
- package/templates/starter/playtests/touch-controls.playtest.json +0 -42
- package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
- package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
- package/templates/starter/src/render/coast.ts +0 -199
- package/templates/starter/src/render/hero.ts +0 -88
- package/templates/starter/src/render/implicitSurface.ts +0 -199
- package/templates/starter/src/render/kuwahara.ts +0 -174
- package/templates/starter/src/render/outline.ts +0 -141
- package/templates/starter/src/render/painterly.ts +0 -86
- package/templates/starter/src/render/rockRidge.ts +0 -198
- package/templates/starter/src/render/rockRidge.worker.ts +0 -77
- package/templates/starter/src/render/scenery.ts +0 -40
- package/templates/starter/src/render/textureLifetime.ts +0 -53
- package/templates/starter/src/render/water.ts +0 -38
- package/templates/starter/src/render/watercolor.ts +0 -85
- /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
- /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
- /package/templates/{defense → rts}/.codex/config.toml +0 -0
- /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
- /package/templates/{defense → rts}/.gemini/settings.json +0 -0
- /package/templates/{defense → rts}/.mcp.json +0 -0
- /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
- /package/templates/{defense → rts}/.zed/settings.json +0 -0
- /package/templates/{defense → rts}/index.html +0 -0
- /package/templates/{defense → rts}/opencode.json +0 -0
- /package/templates/{defense → rts}/src/main.ts +0 -0
- /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
- /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
- /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
- /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
- /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
- /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
- /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
|
@@ -1,23 +1,168 @@
|
|
|
1
1
|
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
2
|
// ThreeNative does not read this file.
|
|
3
|
-
|
|
3
|
+
//
|
|
4
|
+
// The prototype look every engine ships a new project with: a metre grid on neutral greys, one
|
|
5
|
+
// saturated colour for things you can touch, and a metal figure. It reads as "a real engine" only
|
|
6
|
+
// because `sky.ts` gives every surface an environment to reflect — roughness then decides how much
|
|
7
|
+
// sky a surface mirrors, so keep it varied between neighbours.
|
|
8
|
+
import {
|
|
9
|
+
type BufferGeometry,
|
|
10
|
+
DataTexture,
|
|
11
|
+
Float32BufferAttribute,
|
|
12
|
+
LinearMipmapLinearFilter,
|
|
13
|
+
MeshStandardMaterial,
|
|
14
|
+
RepeatWrapping,
|
|
15
|
+
SRGBColorSpace,
|
|
16
|
+
Vector2,
|
|
17
|
+
Vector3,
|
|
18
|
+
} from "three";
|
|
4
19
|
import { palette } from "./palette.js";
|
|
5
20
|
|
|
21
|
+
/**
|
|
22
|
+
* One metre of grid: a heavy line on the metre, faint lines every 25 cm, a faint per-texel grain so
|
|
23
|
+
* large areas do not band. Built from bytes rather than a canvas so it runs the same in the browser
|
|
24
|
+
* and in the native host.
|
|
25
|
+
*/
|
|
26
|
+
function gridTexture(base: number, line: number, size = 256): DataTexture {
|
|
27
|
+
const data = new Uint8Array(size * size * 4);
|
|
28
|
+
const minorEvery = size / 4;
|
|
29
|
+
let seed = 7;
|
|
30
|
+
for (let y = 0; y < size; y += 1) {
|
|
31
|
+
for (let x = 0; x < size; x += 1) {
|
|
32
|
+
const major = x < 3 || y < 3;
|
|
33
|
+
const minor = x % minorEvery < 1 || y % minorEvery < 1;
|
|
34
|
+
const weight = major ? 0.92 : minor ? 0.22 : 0;
|
|
35
|
+
seed = (seed * 16807) % 2147483647;
|
|
36
|
+
const grain = 1 + (seed / 2147483647 - 0.5) * 0.04;
|
|
37
|
+
const index = (y * size + x) * 4;
|
|
38
|
+
for (let channel = 0; channel < 3; channel += 1) {
|
|
39
|
+
const shift = 16 - channel * 8;
|
|
40
|
+
const from = ((base >> shift) & 0xff) * grain;
|
|
41
|
+
const to = (line >> shift) & 0xff;
|
|
42
|
+
data[index + channel] = Math.min(255, Math.round(from * (1 - weight) + to * weight));
|
|
43
|
+
}
|
|
44
|
+
data[index + 3] = 255;
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
const texture = new DataTexture(data, size, size);
|
|
48
|
+
texture.colorSpace = SRGBColorSpace;
|
|
49
|
+
texture.wrapS = RepeatWrapping;
|
|
50
|
+
texture.wrapT = RepeatWrapping;
|
|
51
|
+
texture.generateMipmaps = true;
|
|
52
|
+
texture.minFilter = LinearMipmapLinearFilter;
|
|
53
|
+
texture.anisotropy = 16;
|
|
54
|
+
texture.needsUpdate = true;
|
|
55
|
+
return texture;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
const _normal = new Vector3();
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* A faint cast-concrete grain as a tangent-space normal map: two octaves of smoothed value noise,
|
|
62
|
+
* tiling every metre like the grid. It is what stops a large flat face reading as an untextured
|
|
63
|
+
* blockout under a low sun — the light breaks up across it instead of sliding off in one tone.
|
|
64
|
+
* Bytes, not a file, so it costs nothing to ship and runs on every target.
|
|
65
|
+
*/
|
|
66
|
+
function grainNormalTexture(size = 128): DataTexture {
|
|
67
|
+
const cells = [8, 32];
|
|
68
|
+
const lattice = cells.map((count) => {
|
|
69
|
+
const values = new Float32Array(count * count);
|
|
70
|
+
let seed = count * 7919;
|
|
71
|
+
for (let index = 0; index < values.length; index += 1) {
|
|
72
|
+
seed = (seed * 16807) % 2147483647;
|
|
73
|
+
values[index] = seed / 2147483647;
|
|
74
|
+
}
|
|
75
|
+
return { count, values };
|
|
76
|
+
});
|
|
77
|
+
const height = (x: number, y: number): number => {
|
|
78
|
+
let total = 0;
|
|
79
|
+
for (const [octave, { count, values }] of lattice.entries()) {
|
|
80
|
+
const u = (x / size) * count;
|
|
81
|
+
const v = (y / size) * count;
|
|
82
|
+
const x0 = Math.floor(u);
|
|
83
|
+
const y0 = Math.floor(v);
|
|
84
|
+
const fx = u - x0;
|
|
85
|
+
const fy = v - y0;
|
|
86
|
+
const sx = fx * fx * (3 - 2 * fx);
|
|
87
|
+
const sy = fy * fy * (3 - 2 * fy);
|
|
88
|
+
const at = (i: number, j: number): number =>
|
|
89
|
+
values[(((j % count) + count) % count) * count + (((i % count) + count) % count)] ?? 0;
|
|
90
|
+
const top = at(x0, y0) + (at(x0 + 1, y0) - at(x0, y0)) * sx;
|
|
91
|
+
const bottom = at(x0, y0 + 1) + (at(x0 + 1, y0 + 1) - at(x0, y0 + 1)) * sx;
|
|
92
|
+
total += (top + (bottom - top) * sy) * (octave === 0 ? 1 : 0.5);
|
|
93
|
+
}
|
|
94
|
+
return total;
|
|
95
|
+
};
|
|
96
|
+
const data = new Uint8Array(size * size * 4);
|
|
97
|
+
for (let y = 0; y < size; y += 1) {
|
|
98
|
+
for (let x = 0; x < size; x += 1) {
|
|
99
|
+
const dx = height(x + 1, y) - height(x - 1, y);
|
|
100
|
+
const dy = height(x, y + 1) - height(x, y - 1);
|
|
101
|
+
_normal.set(-dx * 4, -dy * 4, 1).normalize();
|
|
102
|
+
const index = (y * size + x) * 4;
|
|
103
|
+
data[index] = Math.round((_normal.x * 0.5 + 0.5) * 255);
|
|
104
|
+
data[index + 1] = Math.round((_normal.y * 0.5 + 0.5) * 255);
|
|
105
|
+
data[index + 2] = Math.round((_normal.z * 0.5 + 0.5) * 255);
|
|
106
|
+
data[index + 3] = 255;
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
const texture = new DataTexture(data, size, size);
|
|
110
|
+
texture.wrapS = RepeatWrapping;
|
|
111
|
+
texture.wrapT = RepeatWrapping;
|
|
112
|
+
texture.generateMipmaps = true;
|
|
113
|
+
texture.minFilter = LinearMipmapLinearFilter;
|
|
114
|
+
texture.needsUpdate = true;
|
|
115
|
+
return texture;
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
const grain = grainNormalTexture();
|
|
119
|
+
|
|
120
|
+
/**
|
|
121
|
+
* Rewrites a geometry's UVs as world metres, projected along each face's dominant axis, so one grid
|
|
122
|
+
* tile is one metre on every face of every prop regardless of its size. Call it after the geometry
|
|
123
|
+
* is translated into place (merged geometry included), before it is given to a mesh.
|
|
124
|
+
*/
|
|
125
|
+
export function worldGridUVs<T extends BufferGeometry>(geometry: T): T {
|
|
126
|
+
const position = geometry.getAttribute("position");
|
|
127
|
+
const normal = geometry.getAttribute("normal");
|
|
128
|
+
const uv = new Float32Array(position.count * 2);
|
|
129
|
+
for (let index = 0; index < position.count; index += 1) {
|
|
130
|
+
_normal.fromBufferAttribute(normal, index);
|
|
131
|
+
const x = position.getX(index);
|
|
132
|
+
const y = position.getY(index);
|
|
133
|
+
const z = position.getZ(index);
|
|
134
|
+
const ax = Math.abs(_normal.x);
|
|
135
|
+
const ay = Math.abs(_normal.y);
|
|
136
|
+
const az = Math.abs(_normal.z);
|
|
137
|
+
const [u, v] = ay >= ax && ay >= az ? [x, z] : ax >= az ? [z, y] : [x, y];
|
|
138
|
+
uv[index * 2] = u;
|
|
139
|
+
uv[index * 2 + 1] = v;
|
|
140
|
+
}
|
|
141
|
+
geometry.setAttribute("uv", new Float32BufferAttribute(uv, 2));
|
|
142
|
+
return geometry;
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
/** Light grid: floors and the ground. */
|
|
6
146
|
export const floorMaterial = new MeshStandardMaterial({
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
147
|
+
map: gridTexture(palette.floor, palette.gridLine),
|
|
148
|
+
normalMap: grain,
|
|
149
|
+
normalScale: new Vector2(0.18, 0.18),
|
|
150
|
+
roughness: 0.62,
|
|
151
|
+
metalness: 0,
|
|
10
152
|
});
|
|
11
153
|
|
|
12
|
-
/**
|
|
13
|
-
export const
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
154
|
+
/** Dark grid: walls, pillars, anything structural. */
|
|
155
|
+
export const structureMaterial = new MeshStandardMaterial({
|
|
156
|
+
map: gridTexture(palette.structure, palette.gridLine),
|
|
157
|
+
normalMap: grain,
|
|
158
|
+
normalScale: new Vector2(0.18, 0.18),
|
|
159
|
+
roughness: 0.7,
|
|
160
|
+
metalness: 0,
|
|
17
161
|
});
|
|
18
162
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
163
|
+
/** The one saturated colour: things you can push, pick up or stand on. */
|
|
164
|
+
export const propMaterial = new MeshStandardMaterial({
|
|
165
|
+
color: palette.prop,
|
|
166
|
+
roughness: 0.45,
|
|
167
|
+
metalness: 0,
|
|
23
168
|
});
|
|
@@ -1,9 +1,12 @@
|
|
|
1
|
-
// Generated for you. Keep these
|
|
1
|
+
// Generated for you. Keep these roles coherent when you change the look.
|
|
2
|
+
// Neutral greys carry the light; one saturated blue marks what you can touch.
|
|
2
3
|
export const palette = {
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
4
|
+
floor: 0xb4b1ae,
|
|
5
|
+
structure: 0x747578,
|
|
6
|
+
gridLine: 0x3a3a3c,
|
|
7
|
+
prop: 0x2a6cf0,
|
|
8
|
+
/** Touch-control highlight. */
|
|
9
|
+
accent: 0xffffff,
|
|
10
|
+
/** The sky photograph's own horizon, measured from its HDR: distance fades into this. */
|
|
11
|
+
horizon: 0xacb1c1,
|
|
9
12
|
} as const;
|
|
@@ -11,49 +11,36 @@
|
|
|
11
11
|
// `setupPost(renderer, scene, camera, { tier: "low" })`. Overriding does not silence the report:
|
|
12
12
|
// `TN_QUALITY_TIER` names the tier that ran either way.
|
|
13
13
|
import type { Camera, DirectionalLight, Scene } from "three";
|
|
14
|
-
import { vec3 } from "three/tsl";
|
|
15
|
-
import type { Node } from "three/webgpu";
|
|
16
14
|
import { type QualityTier, qualityPreset, resolveQualityTier } from "./quality.js";
|
|
17
15
|
import type { OutputRenderer } from "./worldEnvironment.js";
|
|
18
16
|
import { WorldEnvironment } from "./worldEnvironment.js";
|
|
19
17
|
|
|
20
|
-
type AtmosphereLike = {
|
|
21
|
-
aerialPerspective(scenePass: unknown, depth: unknown, inScatteredRadiance?: unknown): unknown;
|
|
22
|
-
radiance(direction: unknown): unknown;
|
|
23
|
-
};
|
|
24
|
-
|
|
25
18
|
export function setupPost(
|
|
26
19
|
renderer: OutputRenderer,
|
|
27
20
|
scene: Scene,
|
|
28
21
|
camera: Camera,
|
|
29
22
|
environment: {
|
|
30
|
-
atmosphere?: AtmosphereLike;
|
|
31
23
|
godraysLight?: DirectionalLight;
|
|
32
24
|
mobile?: boolean;
|
|
25
|
+
/** The renderer named a software adapter; this game's answer is its `low` tier. */
|
|
26
|
+
software?: boolean;
|
|
33
27
|
/** Forces a tier, ignoring `mobile`. An unknown name throws rather than falling back. */
|
|
34
28
|
tier?: QualityTier;
|
|
35
29
|
} = {},
|
|
36
30
|
): void {
|
|
37
|
-
const tier = resolveQualityTier({
|
|
31
|
+
const tier = resolveQualityTier({
|
|
32
|
+
mobile: environment.mobile,
|
|
33
|
+
software: environment.software,
|
|
34
|
+
tier: environment.tier,
|
|
35
|
+
});
|
|
38
36
|
const source = environment.tier === undefined ? "platform" : "override";
|
|
39
|
-
console.info(
|
|
37
|
+
console.info(
|
|
38
|
+
`TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} software=${
|
|
39
|
+
environment.software === true
|
|
40
|
+
} source=${source}`,
|
|
41
|
+
);
|
|
40
42
|
const world = new WorldEnvironment(qualityPreset(tier));
|
|
41
|
-
const atmosphere = environment.atmosphere;
|
|
42
43
|
world.apply(renderer, scene, camera, {
|
|
43
|
-
// The chain builds the scene pass, so aerial perspective — which needs that pass and its
|
|
44
|
-
// view-Z — is composed here, first, before exposure and before any stage. Delete this
|
|
45
|
-
// property to drop aerial perspective while keeping the sky and the rest of the chain.
|
|
46
|
-
baseColour:
|
|
47
|
-
atmosphere === undefined
|
|
48
|
-
? undefined
|
|
49
|
-
: (scenePass) =>
|
|
50
|
-
atmosphere.aerialPerspective(
|
|
51
|
-
scenePass,
|
|
52
|
-
scenePass.getViewZNode(),
|
|
53
|
-
// Same scale as the dome in sky.ts, and for the same reason: this radiance is
|
|
54
|
-
// mixed into every pixel by the haze term, so at 24 it lifted the whole frame.
|
|
55
|
-
(atmosphere.radiance(vec3(0, 0, 1)) as Node<"vec3">).mul(1.5),
|
|
56
|
-
) as Node<"vec4">,
|
|
57
44
|
godraysLight: environment.godraysLight,
|
|
58
45
|
});
|
|
59
46
|
}
|
|
@@ -54,7 +54,7 @@ function isQualityTier(value: string): value is QualityTier {
|
|
|
54
54
|
* turned out to have no effect.
|
|
55
55
|
*/
|
|
56
56
|
export function resolveQualityTier(
|
|
57
|
-
request: { readonly mobile?: boolean; readonly tier?: string } = {},
|
|
57
|
+
request: { readonly mobile?: boolean; readonly software?: boolean; readonly tier?: string } = {},
|
|
58
58
|
): QualityTier {
|
|
59
59
|
const requested = request.tier;
|
|
60
60
|
if (requested !== undefined) {
|
|
@@ -65,88 +65,54 @@ export function resolveQualityTier(
|
|
|
65
65
|
}
|
|
66
66
|
return requested;
|
|
67
67
|
}
|
|
68
|
+
// A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
|
|
69
|
+
// game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
|
|
70
|
+
// drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
|
|
71
|
+
// fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
|
|
72
|
+
// `tier` above still wins over it.
|
|
73
|
+
if (request.software === true) return "low";
|
|
68
74
|
return request.mobile === true ? "low" : "high";
|
|
69
75
|
}
|
|
70
76
|
|
|
71
77
|
/**
|
|
72
|
-
*
|
|
78
|
+
* The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the sun
|
|
79
|
+
* disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey walls and
|
|
80
|
+
* flattens contrast), and a corner falloff. Antialiasing is on in every tier that installs a chain;
|
|
81
|
+
* see `screenSpaceAA` in `worldEnvironment.ts`.
|
|
73
82
|
*
|
|
74
|
-
*
|
|
75
|
-
*
|
|
83
|
+
* No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
|
|
84
|
+
* captured sky (`sky.ts`), and SSR on rough floors traced speckle into the grid; RCAS then rang the
|
|
85
|
+
* smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
|
|
76
86
|
*/
|
|
77
|
-
const
|
|
78
|
-
//
|
|
79
|
-
// Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
|
|
80
|
-
// to be.
|
|
87
|
+
const shared: IWorldEnvironmentOptions = {
|
|
88
|
+
// Bloom: ~4.6 ms in the reference ablation — the second most expensive stage there.
|
|
81
89
|
bloomEnabled: true,
|
|
82
|
-
bloomRadius: 0.
|
|
83
|
-
bloomStrength: 0.
|
|
84
|
-
bloomThreshold:
|
|
85
|
-
exposure:
|
|
86
|
-
// Screen-space reflections: ~4.1 ms.
|
|
87
|
-
ssrEnabled: true,
|
|
88
|
-
// `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
|
|
89
|
-
// are on and do nothing" — the ray dies a metre from where it started.
|
|
90
|
-
ssrMaxDistance: 20,
|
|
91
|
-
// A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
|
|
92
|
-
// the rays and is very hard to see in the result.
|
|
93
|
-
ssrResolutionScale: 0.5,
|
|
94
|
-
// RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
|
|
95
|
-
// denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
|
|
96
|
-
// that runs one of them.
|
|
97
|
-
sharpenEnabled: true,
|
|
98
|
-
// **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
|
|
99
|
-
sharpenStrength: 0.3,
|
|
90
|
+
bloomRadius: 0.6,
|
|
91
|
+
bloomStrength: 0.22,
|
|
92
|
+
bloomThreshold: 1,
|
|
93
|
+
exposure: 0.62,
|
|
100
94
|
tonemapMode: "aces",
|
|
95
|
+
vignetteAmount: 0.22,
|
|
101
96
|
};
|
|
102
97
|
|
|
103
98
|
/**
|
|
104
|
-
*
|
|
105
|
-
*
|
|
106
|
-
*
|
|
107
|
-
*
|
|
99
|
+
* What a desktop gets: contact occlusion on top — the dark line where a foot meets the floor and a
|
|
100
|
+
* wall meets the ground, most of what separates "objects in a world" from "objects pasted on a
|
|
101
|
+
* background". Gathered at full resolution and denoised: at half, the upsample left a grain around
|
|
102
|
+
* every foot.
|
|
108
103
|
*/
|
|
109
|
-
const
|
|
110
|
-
|
|
111
|
-
//
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
bloomRadius: 0.5,
|
|
115
|
-
bloomStrength: 0.5,
|
|
116
|
-
bloomThreshold: 0.2,
|
|
117
|
-
exposure: 1.15,
|
|
118
|
-
// Screen-space reflections: ~4.1 ms.
|
|
119
|
-
ssrEnabled: true,
|
|
120
|
-
// `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
|
|
121
|
-
// are on and do nothing" — the ray dies a metre from where it started.
|
|
122
|
-
ssrMaxDistance: 20,
|
|
123
|
-
// A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
|
|
124
|
-
// the rays and is very hard to see in the result.
|
|
125
|
-
ssrResolutionScale: 0.25,
|
|
126
|
-
// RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
|
|
127
|
-
// denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
|
|
128
|
-
// that runs one of them.
|
|
129
|
-
sharpenEnabled: true,
|
|
130
|
-
// **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
|
|
131
|
-
sharpenStrength: 0.3,
|
|
132
|
-
tonemapMode: "aces",
|
|
104
|
+
const high: IWorldEnvironmentOptions = {
|
|
105
|
+
...shared,
|
|
106
|
+
// GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
|
|
107
|
+
gtaoEnabled: true,
|
|
108
|
+
gtaoRadius: 0.35,
|
|
133
109
|
};
|
|
134
110
|
|
|
135
|
-
/**
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
*/
|
|
139
|
-
const low: IWorldEnvironmentOptions = {
|
|
140
|
-
// Strength, radius and threshold are a look decision already tuned to this scene's palette.
|
|
141
|
-
// Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
|
|
142
|
-
// to be.
|
|
143
|
-
bloomEnabled: true,
|
|
144
|
-
bloomRadius: 0.5,
|
|
145
|
-
bloomStrength: 0.5,
|
|
146
|
-
bloomThreshold: 0.2,
|
|
147
|
-
exposure: 1.15,
|
|
148
|
-
tonemapMode: "aces",
|
|
149
|
-
};
|
|
111
|
+
/** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
|
|
112
|
+
const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8 };
|
|
113
|
+
|
|
114
|
+
/** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
|
|
115
|
+
const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
|
|
150
116
|
|
|
151
117
|
const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
|
|
152
118
|
|
|
@@ -1,60 +1,41 @@
|
|
|
1
1
|
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
-
//
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
2
|
+
//
|
|
3
|
+
// The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
|
|
4
|
+
// by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
|
|
5
|
+
// The same image is the background, the environment light every surface reflects and is filled by,
|
|
6
|
+
// and — through `SUN_DIRECTION` — the direction the sun's shadows fall. Swap the file for any
|
|
7
|
+
// equirectangular sky and re-aim `SUN_DIRECTION` at its sun.
|
|
8
|
+
import {
|
|
9
|
+
EquirectangularReflectionMapping,
|
|
10
|
+
FogExp2,
|
|
11
|
+
SRGBColorSpace,
|
|
12
|
+
type Scene,
|
|
13
|
+
type Texture,
|
|
14
|
+
Vector3,
|
|
15
|
+
} from "three";
|
|
7
16
|
import { palette } from "./palette.js";
|
|
8
17
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
18
|
+
/**
|
|
19
|
+
* How the JPEG was made from the 4k HDR: linear radiance × 0.4, clipped, sRGB-encoded — so white
|
|
20
|
+
* in the file is 2.5 in the sky. Multiplying back restores the HDR brightness of the clouds; the sun
|
|
21
|
+
* disk itself is clipped, which is why the sun is a light (`lighting.ts`) and not a texel.
|
|
22
|
+
*/
|
|
23
|
+
const SKY_RANGE = 2.5;
|
|
12
24
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
if (atmosphere === undefined) {
|
|
16
|
-
scene.background = top;
|
|
17
|
-
scene.fog = null;
|
|
18
|
-
return;
|
|
19
|
-
}
|
|
25
|
+
/** Unit vector toward the photographed sun: 47.9° up, measured from the source HDR. */
|
|
26
|
+
export const SUN_DIRECTION = new Vector3(0.555, 0.742, 0.38).normalize();
|
|
20
27
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
//
|
|
27
|
-
//
|
|
28
|
-
//
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
});
|
|
35
|
-
const viewDirection = normalize(positionWorld.sub(cameraPosition));
|
|
36
|
-
// Exposure for the dome alone.
|
|
37
|
-
//
|
|
38
|
-
// 24 was authored when this template had no post chain, so the dome's radiance landed straight
|
|
39
|
-
// in the frame; the chain now exposes the pass at 1.15 and tone-maps it with ACES. A previous
|
|
40
|
-
// pass measured 203 of 255 at 24 and 25 at 1.5, and chose 1.5 because it matched "this
|
|
41
|
-
// template's last good baseline" of 22. That baseline was the problem: **22 of 255 is not a
|
|
42
|
-
// sky**, it is a black rectangle above the horizon, and it is what the smallest template showed
|
|
43
|
-
// a new project on its first frame with a sun fifty degrees up and a correctly-scattering
|
|
44
|
-
// atmosphere behind it.
|
|
45
|
-
//
|
|
46
|
-
// 8 lands the daytime sky around a hundred, which is a sky. Raising it further starts to blow
|
|
47
|
-
// the horizon out under ACES. This multiplier scales the dome and nothing else — the
|
|
48
|
-
// in-scattering `aerialPerspective` receives in postprocessing.ts comes from its own call and
|
|
49
|
-
// is unaffected, so this cannot double-count the way the old note feared.
|
|
50
|
-
material.colorNode = (atmosphere.radiance(viewDirection) as Node<"vec3">).mul(8);
|
|
51
|
-
const dome = new Mesh(geometry, material);
|
|
52
|
-
// The dome is authored at the origin and never moves; freeze only this known-static render
|
|
53
|
-
// object, leaving gameplay transforms under user control.
|
|
54
|
-
dome.updateMatrix();
|
|
55
|
-
dome.matrixAutoUpdate = false;
|
|
56
|
-
dome.frustumCulled = false;
|
|
57
|
-
scene.background = null;
|
|
58
|
-
scene.fog = null;
|
|
59
|
-
scene.add(dome);
|
|
28
|
+
export function setupSky(scene: Scene, sky: Texture): void {
|
|
29
|
+
sky.mapping = EquirectangularReflectionMapping;
|
|
30
|
+
sky.colorSpace = SRGBColorSpace;
|
|
31
|
+
scene.background = sky;
|
|
32
|
+
scene.backgroundIntensity = SKY_RANGE;
|
|
33
|
+
// three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
|
|
34
|
+
// It is what makes a standard material read as a material: sky-blue fill on faces the sun
|
|
35
|
+
// misses, and a sky to reflect, sharper as roughness drops.
|
|
36
|
+
scene.environment = sky;
|
|
37
|
+
scene.environmentIntensity = SKY_RANGE;
|
|
38
|
+
// Almost nothing inside the arena (1.4% at 30 m), and the ground plane gone into the horizon by
|
|
39
|
+
// a kilometre — so the floor meets the sky instead of ending at a line.
|
|
40
|
+
scene.fog = new FogExp2(palette.horizon, 0.003);
|
|
60
41
|
}
|
|
@@ -75,7 +75,7 @@ export class TouchControls {
|
|
|
75
75
|
|
|
76
76
|
constructor(camera: PerspectiveCamera) {
|
|
77
77
|
this.#camera = camera;
|
|
78
|
-
this.#idleMaterial = overlayMaterial(palette.
|
|
78
|
+
this.#idleMaterial = overlayMaterial(palette.gridLine, 0.34);
|
|
79
79
|
this.#activeMaterial = overlayMaterial(palette.accent, 0.6);
|
|
80
80
|
this.#moveBase = ringMesh(MOVE_RADIUS, this.#idleMaterial);
|
|
81
81
|
this.#moveKnob = new Mesh(new CircleGeometry(28, 24), this.#activeMaterial);
|
|
@@ -24,8 +24,10 @@ import {
|
|
|
24
24
|
} from "three";
|
|
25
25
|
import { bloom } from "three/addons/tsl/display/BloomNode.js";
|
|
26
26
|
import { denoise } from "three/addons/tsl/display/DenoiseNode.js";
|
|
27
|
+
import { fxaa } from "three/addons/tsl/display/FXAANode.js";
|
|
27
28
|
import { ao } from "three/addons/tsl/display/GTAONode.js";
|
|
28
29
|
import { godrays } from "three/addons/tsl/display/GodraysNode.js";
|
|
30
|
+
import { smaa } from "three/addons/tsl/display/SMAANode.js";
|
|
29
31
|
import { ssgi } from "three/addons/tsl/display/SSGINode.js";
|
|
30
32
|
import { ssr } from "three/addons/tsl/display/SSRNode.js";
|
|
31
33
|
import { sharpen } from "three/addons/tsl/display/SharpenNode.js";
|
|
@@ -33,6 +35,7 @@ import {
|
|
|
33
35
|
color,
|
|
34
36
|
convertToTexture,
|
|
35
37
|
float,
|
|
38
|
+
max,
|
|
36
39
|
metalness,
|
|
37
40
|
mrt,
|
|
38
41
|
normalView,
|
|
@@ -45,6 +48,9 @@ import {
|
|
|
45
48
|
} from "three/tsl";
|
|
46
49
|
import type { Node } from "three/webgpu";
|
|
47
50
|
|
|
51
|
+
/** Godot's `Viewport.screen_space_aa`: which post-process antialiasing smooths the frame's edges. */
|
|
52
|
+
export type ScreenSpaceAA = "smaa" | "fxaa" | "disabled";
|
|
53
|
+
|
|
48
54
|
/** Godot's `Environment.tonemap_mode`, with the modes Three.js actually ships. */
|
|
49
55
|
export type TonemapMode = "aces" | "agx" | "neutral";
|
|
50
56
|
|
|
@@ -184,6 +190,16 @@ export interface IWorldEnvironmentOptions {
|
|
|
184
190
|
readonly sharpenStrength?: number;
|
|
185
191
|
/** Corner darkening, as a fraction removed at the extreme corner. Zero disables it. */
|
|
186
192
|
readonly vignetteAmount?: number;
|
|
193
|
+
/**
|
|
194
|
+
* Post-process antialiasing, run last. Godot's `Viewport.screen_space_aa`. Default `"smaa"`.
|
|
195
|
+
*
|
|
196
|
+
* Not optional in practice: the chain renders `pass(scene, camera)` single-sampled, so the moment
|
|
197
|
+
* any stage runs, the renderer's own multisampling no longer reaches the frame and every edge
|
|
198
|
+
* stairsteps — the single loudest "this is a prototype" signal in a frame. It is requested only
|
|
199
|
+
* when some other stage (or a `baseColour`) installs a chain; with nothing installed the renderer
|
|
200
|
+
* draws straight to the canvas with its own MSAA and this would be paying twice.
|
|
201
|
+
*/
|
|
202
|
+
readonly screenSpaceAA?: ScreenSpaceAA;
|
|
187
203
|
/** Godot's `glow_enabled`. */
|
|
188
204
|
readonly bloomEnabled?: boolean;
|
|
189
205
|
readonly bloomStrength?: number;
|
|
@@ -391,6 +407,7 @@ export class WorldEnvironment {
|
|
|
391
407
|
sharpenEnabled: options.sharpenEnabled ?? false,
|
|
392
408
|
sharpenStrength: options.sharpenStrength ?? 0.2,
|
|
393
409
|
vignetteAmount: options.vignetteAmount ?? 0,
|
|
410
|
+
screenSpaceAA: options.screenSpaceAA ?? "smaa",
|
|
394
411
|
bloomEnabled: options.bloomEnabled ?? true,
|
|
395
412
|
bloomStrength: options.bloomStrength ?? 0.7,
|
|
396
413
|
bloomRadius: options.bloomRadius ?? 0.5,
|
|
@@ -432,6 +449,11 @@ export class WorldEnvironment {
|
|
|
432
449
|
(name === "vignette" && options.vignetteAmount > 0),
|
|
433
450
|
);
|
|
434
451
|
requested.push(...options.authoredStageNames);
|
|
452
|
+
if (
|
|
453
|
+
options.screenSpaceAA !== "disabled" &&
|
|
454
|
+
(requested.length > 0 || target.baseColour !== undefined)
|
|
455
|
+
)
|
|
456
|
+
requested.push("antialias");
|
|
435
457
|
|
|
436
458
|
// With no stage running there is no node graph to install — the renderer's own
|
|
437
459
|
// tone-mapping path renders the frame, and the exposure scalar is live there (measured:
|
|
@@ -542,7 +564,14 @@ export class WorldEnvironment {
|
|
|
542
564
|
// Applied before SSGI by the chain's canonical order; composing it after the GI
|
|
543
565
|
// combine instead darkens crevices the gather re-lit — that is a look choice, and
|
|
544
566
|
// this file is where you make it.
|
|
545
|
-
|
|
567
|
+
//
|
|
568
|
+
// Denoised with the same depth-aware filter as the GI gather: GTAO's interleaved
|
|
569
|
+
// sampling otherwise reads as a speckled halo around every contact — around feet on a
|
|
570
|
+
// plain floor most of all — which is exactly the "not smooth" a player notices first.
|
|
571
|
+
const occlusion = options.denoiseEnabled
|
|
572
|
+
? denoised(denoise(contact.getTextureNode(), depth(), normal(), view))
|
|
573
|
+
: contact;
|
|
574
|
+
return input.mul(occlusion.r);
|
|
546
575
|
},
|
|
547
576
|
}),
|
|
548
577
|
stage({
|
|
@@ -668,6 +697,26 @@ export class WorldEnvironment {
|
|
|
668
697
|
return input.mul(fall.oneMinus());
|
|
669
698
|
},
|
|
670
699
|
}),
|
|
700
|
+
{
|
|
701
|
+
// Last, after every built-in: antialiasing is defined on the finished picture, and any
|
|
702
|
+
// stage after it would put the stairsteps back.
|
|
703
|
+
name: "antialias",
|
|
704
|
+
after: "gradualBackground",
|
|
705
|
+
build: (input) => {
|
|
706
|
+
const colour = input as ChainNode;
|
|
707
|
+
// SMAA and FXAA find edges by local contrast and expect display-range colour, but this is
|
|
708
|
+
// the linear HDR frame before the tone curve — a sun-lit edge at 20 against sky at 3
|
|
709
|
+
// would blend into a bright halo. The reversible Karis weighting squeezes it into [0, 1)
|
|
710
|
+
// for the filter and expands it back afterwards, so edges resolve without the halo.
|
|
711
|
+
const peak = max(colour.r, max(colour.g, colour.b));
|
|
712
|
+
const squeezed = colour.div(peak.add(1));
|
|
713
|
+
const filtered = (options.screenSpaceAA === "fxaa"
|
|
714
|
+
? fxaa(squeezed)
|
|
715
|
+
: smaa(squeezed)) as unknown as ChainNode;
|
|
716
|
+
const back = max(filtered.r, max(filtered.g, filtered.b));
|
|
717
|
+
return filtered.div(float(1).sub(back).max(1e-4));
|
|
718
|
+
},
|
|
719
|
+
},
|
|
671
720
|
];
|
|
672
721
|
|
|
673
722
|
// The kit's own stages, composed after the built-ins. The factory is called with the two
|
|
@@ -723,6 +772,7 @@ export class WorldEnvironment {
|
|
|
723
772
|
const options = this.#options;
|
|
724
773
|
const off: Record<string, string> = {
|
|
725
774
|
ambientOcclusion: "gtaoEnabled is false",
|
|
775
|
+
antialias: 'screenSpaceAA is "disabled", or no other stage installed a chain',
|
|
726
776
|
bloom: "bloomEnabled is false",
|
|
727
777
|
godRays: "godraysEnabled is false",
|
|
728
778
|
sharpen: "sharpenEnabled is false",
|
|
@@ -745,6 +795,7 @@ export class WorldEnvironment {
|
|
|
745
795
|
denoise: options.denoiseEnabled,
|
|
746
796
|
exposure: options.exposure,
|
|
747
797
|
marker: "TN_WORLD_ENVIRONMENT",
|
|
798
|
+
screenSpaceAA: options.screenSpaceAA,
|
|
748
799
|
ssgiQuality: options.ssgiQuality,
|
|
749
800
|
stages,
|
|
750
801
|
tonemapMode: options.tonemapMode,
|