create-threenative 0.2.7 → 0.2.8

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.
Files changed (154) hide show
  1. package/README.md +3 -1
  2. package/agent-docs/references/capability-reference.md +177 -7
  3. package/capabilities.json +247 -4
  4. package/dist/index.js +6 -1
  5. package/dist/threenative.js +3 -2
  6. package/package.json +4 -4
  7. package/templates/action-rpg/package.json +1 -1
  8. package/templates/minimal/package.json +1 -1
  9. package/templates/platformer/package.json +1 -1
  10. package/templates/puzzle/package.json +1 -1
  11. package/templates/racing/package.json +1 -1
  12. package/templates/rain/.codex/config.toml +19 -0
  13. package/templates/rain/.cursor/mcp.json +32 -0
  14. package/templates/rain/.gemini/settings.json +32 -0
  15. package/templates/rain/.mcp.json +32 -0
  16. package/templates/rain/.vscode/mcp.json +36 -0
  17. package/templates/rain/.zed/settings.json +36 -0
  18. package/templates/rain/AGENTS.md +96 -0
  19. package/templates/rain/CLAUDE.md +98 -0
  20. package/templates/rain/assets/rain-loop.wav +0 -0
  21. package/templates/rain/assets/thunder.wav +0 -0
  22. package/templates/rain/assets/wind-loop.wav +0 -0
  23. package/templates/rain/index.html +18 -0
  24. package/templates/rain/kit.json +7 -0
  25. package/templates/rain/native-playtests/boot.playtest.json +13 -0
  26. package/templates/rain/native-playtests/lightning.playtest.json +173 -0
  27. package/templates/rain/opencode.json +41 -0
  28. package/templates/rain/package.json +56 -0
  29. package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
  30. package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
  31. package/templates/rain/playtests/automation.playtest.json +133 -0
  32. package/templates/rain/playtests/cinematic.playtest.json +59 -0
  33. package/templates/rain/playtests/flash.playtest.json +27 -0
  34. package/templates/rain/playtests/fly.playtest.json +54 -0
  35. package/templates/rain/playtests/lightning.playtest.json +220 -0
  36. package/templates/rain/playtests/loading.playtest.json +57 -0
  37. package/templates/rain/playtests/paused.playtest.json +59 -0
  38. package/templates/rain/playtests/performance.playtest.json +22 -0
  39. package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
  40. package/templates/rain/playtests/simulation.playtest.json +20 -0
  41. package/templates/rain/playtests/storm.playtest.json +150 -0
  42. package/templates/rain/playtests/survives.playtest.json +58 -0
  43. package/templates/rain/playtests/tiers.playtest.json +179 -0
  44. package/templates/rain/playtests/weather.playtest.json +77 -0
  45. package/templates/rain/public/favicon.svg +5 -0
  46. package/templates/rain/src/audio/storm.ts +314 -0
  47. package/templates/rain/src/game.ts +114 -0
  48. package/templates/rain/src/main.ts +15 -0
  49. package/templates/rain/src/render/bloom-shader.ts +65 -0
  50. package/templates/rain/src/render/camera.ts +160 -0
  51. package/templates/rain/src/render/clouds-shader.ts +242 -0
  52. package/templates/rain/src/render/clouds.ts +142 -0
  53. package/templates/rain/src/render/lighting.ts +39 -0
  54. package/templates/rain/src/render/lightning.ts +360 -0
  55. package/templates/rain/src/render/loading.ts +327 -0
  56. package/templates/rain/src/render/materials.ts +19 -0
  57. package/templates/rain/src/render/noise-volume.ts +159 -0
  58. package/templates/rain/src/render/palette.ts +18 -0
  59. package/templates/rain/src/render/post-shader.ts +178 -0
  60. package/templates/rain/src/render/postprocessing.ts +226 -0
  61. package/templates/rain/src/render/quality.ts +135 -0
  62. package/templates/rain/src/render/rain.ts +299 -0
  63. package/templates/rain/src/render/sky.ts +28 -0
  64. package/templates/rain/src/render/world-shader.ts +680 -0
  65. package/templates/rain/src/render/world.ts +146 -0
  66. package/templates/rain/src/render/worldEnvironment.ts +809 -0
  67. package/templates/rain/src/scenes/Boot.ts +334 -0
  68. package/templates/rain/src/state.ts +257 -0
  69. package/templates/rain/src/style.css +1160 -0
  70. package/templates/rain/src/ui/App.tsx +29 -0
  71. package/templates/rain/src/ui/GameUi.tsx +187 -0
  72. package/templates/rain/src/ui/Hud.tsx +327 -0
  73. package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
  74. package/templates/rain/src/ui/Menu.tsx +370 -0
  75. package/templates/rain/src/ui/automation.ts +60 -0
  76. package/templates/rain/src/ui/main.tsx +7 -0
  77. package/templates/rain/src/ui/tempest.ts +149 -0
  78. package/templates/rain/tailwind.config.ts +2 -0
  79. package/templates/rain/threenative.config.ts +66 -0
  80. package/templates/rain/tools/generate-shaders.mjs +656 -0
  81. package/templates/rain/tools/make-storm-audio.mjs +387 -0
  82. package/templates/rain/tools/storm-dsp.mjs +177 -0
  83. package/templates/rain/tools/tempest-bloom.frag +10 -0
  84. package/templates/rain/tools/tempest-clouds.frag +86 -0
  85. package/templates/rain/tools/tempest-post.frag +47 -0
  86. package/templates/rain/tools/tempest-world.frag +210 -0
  87. package/templates/rain/tools/verify-noise-volume.mjs +61 -0
  88. package/templates/rain/tsconfig.json +17 -0
  89. package/templates/rain/vite.config.ts +37 -0
  90. package/templates/rts/package.json +1 -1
  91. package/templates/runner/package.json +1 -1
  92. package/templates/sailing/package.json +1 -1
  93. package/templates/shooter/package.json +1 -1
  94. package/templates/snow/.codex/config.toml +19 -0
  95. package/templates/snow/.cursor/mcp.json +32 -0
  96. package/templates/snow/.gemini/settings.json +32 -0
  97. package/templates/snow/.mcp.json +32 -0
  98. package/templates/snow/.vscode/mcp.json +36 -0
  99. package/templates/snow/.zed/settings.json +36 -0
  100. package/templates/snow/AGENTS.md +88 -0
  101. package/templates/snow/CLAUDE.md +90 -0
  102. package/templates/snow/README.md +26 -0
  103. package/templates/snow/assets/crunch.wav +0 -0
  104. package/templates/snow/assets/wind.wav +0 -0
  105. package/templates/snow/index.html +12 -0
  106. package/templates/snow/kit.json +7 -0
  107. package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
  108. package/templates/snow/native-playtests/survives.playtest.json +47 -0
  109. package/templates/snow/opencode.json +41 -0
  110. package/templates/snow/package.json +58 -0
  111. package/templates/snow/playtests/footsteps.playtest.json +95 -0
  112. package/templates/snow/playtests/performance.playtest.json +36 -0
  113. package/templates/snow/playtests/snow-physics.playtest.json +154 -0
  114. package/templates/snow/playtests/survives.playtest.json +56 -0
  115. package/templates/snow/playtests/touch-controls.playtest.json +71 -0
  116. package/templates/snow/playtests/weather.playtest.json +119 -0
  117. package/templates/snow/public/favicon.svg +5 -0
  118. package/templates/snow/src/audio.ts +58 -0
  119. package/templates/snow/src/commands.ts +8 -0
  120. package/templates/snow/src/entities/Explorer.ts +279 -0
  121. package/templates/snow/src/game.ts +69 -0
  122. package/templates/snow/src/main.ts +15 -0
  123. package/templates/snow/src/render/bootPrint.ts +50 -0
  124. package/templates/snow/src/render/camera.ts +84 -0
  125. package/templates/snow/src/render/explorer.ts +321 -0
  126. package/templates/snow/src/render/lighting.ts +50 -0
  127. package/templates/snow/src/render/loading.ts +325 -0
  128. package/templates/snow/src/render/materials.ts +36 -0
  129. package/templates/snow/src/render/palette.ts +17 -0
  130. package/templates/snow/src/render/postprocessing.ts +44 -0
  131. package/templates/snow/src/render/props.ts +42 -0
  132. package/templates/snow/src/render/quality.ts +135 -0
  133. package/templates/snow/src/render/scenery.ts +244 -0
  134. package/templates/snow/src/render/sky.ts +57 -0
  135. package/templates/snow/src/render/snowSurface.ts +259 -0
  136. package/templates/snow/src/render/touch-controls.ts +143 -0
  137. package/templates/snow/src/render/weather.ts +279 -0
  138. package/templates/snow/src/render/worldEnvironment.ts +809 -0
  139. package/templates/snow/src/scenes/Boot.ts +12 -0
  140. package/templates/snow/src/scenes/Snow.ts +635 -0
  141. package/templates/snow/src/state.ts +46 -0
  142. package/templates/snow/src/style.css +143 -0
  143. package/templates/snow/src/terrain.ts +64 -0
  144. package/templates/snow/src/ui/App.tsx +15 -0
  145. package/templates/snow/src/ui/Controls.tsx +322 -0
  146. package/templates/snow/src/ui/GameUi.tsx +354 -0
  147. package/templates/snow/src/ui/icons.tsx +54 -0
  148. package/templates/snow/src/ui/main.tsx +7 -0
  149. package/templates/snow/tailwind.config.ts +2 -0
  150. package/templates/snow/threenative.config.ts +51 -0
  151. package/templates/snow/tsconfig.json +17 -0
  152. package/templates/snow/vite.config.ts +37 -0
  153. package/templates/starter/package.json +1 -1
  154. package/templates/tower-defense/package.json +1 -1
@@ -0,0 +1,47 @@
1
+ // The source of truth for src/render/post-shader.ts, transcribed from the Tempest single-file demo's
2
+ // `POST` constant (const POST, immediately after `BLOOM`).
3
+ //
4
+ // The whole filmic half of the demo in one pass: twelve animated refractive beads near the lens
5
+ // edges, a five-tap luma-edge antialias over the warped coordinate, the bloom added, weather
6
+ // exposure, the ACES fit, the cool-shadow/warm-highlight grade, the vignette, gamma 1/2.2 and the
7
+ // dither. Nothing here is a framework default — every constant is the demo's.
8
+ precision highp float;
9
+ in vec2 vUv;out vec4 fragColor;uniform sampler2D uScene,uBloom;uniform vec2 uRes;uniform float uTime,uExposure,uRain,uLens;
10
+ float hash(vec2 p){return fract(sin(dot(p,vec2(127.1,311.7)))*43758.5453123);}
11
+ vec3 aces(vec3 x){return clamp((x*(2.51*x+.03))/(x*(2.43*x+.59)+.14),0.,1.);}
12
+ vec3 antialias(vec2 uv){
13
+ vec2 px=1./uRes;vec3 m=texture(uScene,uv).rgb;
14
+ vec3 nw=texture(uScene,uv+vec2(-1.,-1.)*px).rgb,ne=texture(uScene,uv+vec2(1.,-1.)*px).rgb;
15
+ vec3 sw=texture(uScene,uv+vec2(-1.,1.)*px).rgb,se=texture(uScene,uv+vec2(1.,1.)*px).rgb;
16
+ vec3 lum=vec3(.299,.587,.114);float l0=dot(m,lum),l1=dot(nw,lum),l2=dot(ne,lum),l3=dot(sw,lum),l4=dot(se,lum);
17
+ vec2 dir=vec2(-((l1+l2)-(l3+l4)),(l1+l3)-(l2+l4));
18
+ float reduce=max((l1+l2+l3+l4)*.03125,.0078125);float rcp=1./(min(abs(dir.x),abs(dir.y))+reduce);
19
+ dir=clamp(dir*rcp,vec2(-6.),vec2(6.))*px;
20
+ vec3 a=.5*(texture(uScene,uv+dir*(-.166667)).rgb+texture(uScene,uv+dir*.166667).rgb);
21
+ vec3 b=a*.5+.25*(texture(uScene,uv-dir*.5).rgb+texture(uScene,uv+dir*.5).rgb);
22
+ float lb=dot(b,lum),lo=min(l0,min(min(l1,l2),min(l3,l4))),hi=max(l0,max(max(l1,l2),max(l3,l4)));
23
+ return lb<lo||lb>hi?a:b;
24
+ }
25
+ void main(){
26
+ vec2 uv=vUv;vec2 warp=vec2(0.);float dropHighlight=0.;
27
+ // Sparse refractive beads near the lens edges, not a full-screen blur.
28
+ if(uLens>.5){for(int i=0;i<12;i++){
29
+ float f=float(i);vec2 p=vec2(hash(vec2(f,3.)),hash(vec2(f,7.)));
30
+ p.y=fract(p.y-uTime*(.008+hash(vec2(f,11.))*.01));
31
+ if(p.x>.18&&p.x<.82)continue;
32
+ vec2 d=(uv-p)*vec2(uRes.x/uRes.y,1.);float rad=.008+hash(vec2(f,9.))*.006;float dist=length(d*vec2(1.,.75));
33
+ float mask=1.-smoothstep(rad*.7,rad,dist);
34
+ warp+=d*mask*uRain*.5;dropHighlight+=pow(max(0.,1.-abs(dist-rad*.8)/(rad*.10)),4.)*.017*uRain;
35
+ }}
36
+ vec3 col=antialias(clamp(uv+warp,0.,1.));
37
+ vec3 bloom=vec3(0.);float wt=0.;for(int i=-3;i<=3;i++){float w=exp(-float(i*i)*.26);bloom+=texture(uBloom,uv+vec2(0.,float(i)*3.)/uRes).rgb*w;wt+=w;}
38
+ col+=bloom/wt*.22;
39
+ col*=uExposure;
40
+ col=aces(col);
41
+ // Cool shadow / warm practical-light grade, retaining neutral highlights.
42
+ col=pow(max(col,vec3(0.)),vec3(1.015,1.,.975));
43
+ float vign=1.-.28*pow(length((uv-.5)*vec2(1.05,1.)),1.65);col*=vign;
44
+ col=pow(col,vec3(1./2.2));
45
+ col+=(hash(gl_FragCoord.xy+floor(uTime*24.))-.5)*.005+dropHighlight;
46
+ fragColor=vec4(clamp(col,0.,1.),1.);
47
+ }
@@ -0,0 +1,210 @@
1
+ // The GLSL this template's coastal world shader is generated from, copied verbatim out of the
2
+ // Tempest single-file demo (its COMMON + WORLD fragment shaders) so the generator is
3
+ // reproducible without the original file. Edits here change the generated
4
+ // templates/rain/src/render/world-shader.ts; edit the generator, not its output.
5
+ precision highp float;
6
+ precision highp sampler3D;
7
+ uniform float uTime, uRain, uCloud, uWind, uFog, uWet, uFlash, uAspect, uTan;
8
+ uniform vec3 uCam, uForward, uRight, uUp, uStrike;
9
+ // The look, owned by src/render/{sky,lighting,materials}.ts and set from there every run.
10
+ uniform vec3 uHazeLow, uHazeHigh, uSunDir, uSunColor, uFill, uFlashLight, uLampLight, uLampGlow, uWater;
11
+ uniform vec2 uRes;
12
+ in vec2 vUv;
13
+ out vec4 fragColor;
14
+ float hash12(vec2 p){vec3 p3=fract(vec3(p.xyx)*.1031);p3+=dot(p3,p3.yzx+33.33);return fract((p3.x+p3.y)*p3.z);}
15
+ float hash13(vec3 p){p=fract(p*.1031);p+=dot(p,p.zyx+31.32);return fract((p.x+p.y)*p.z);}
16
+ float noise2(vec2 p){vec2 i=floor(p),f=fract(p);f=f*f*(3.-2.*f);return mix(mix(hash12(i),hash12(i+vec2(1,0)),f.x),mix(hash12(i+vec2(0,1)),hash12(i+1.),f.x),f.y);}
17
+ float fbm2(vec2 p){float v=.5*noise2(p);p=mat2(.8,-.6,.6,.8)*p*2.03+19.1;v+=.25*noise2(p);p=p*2.02+9.3;v+=.125*noise2(p);return v+.0625*noise2(p*2.01+17.);}
18
+ vec3 ray(vec2 uv){vec2 q=uv*2.-1.;return normalize(uForward+uRight*q.x*uAspect*uTan+uUp*q.y*uTan);}
19
+ vec4 project(vec3 p){vec3 v=p-uCam;float d=dot(v,uForward);return vec4(dot(v,uRight)/(uAspect*uTan),dot(v,uUp)/uTan,1.00012*d-.300018,d);}
20
+ vec3 hazeColor(vec3 rd){return mix(uHazeLow,uHazeHigh,smoothstep(0.,.7,abs(rd.y)))+uFlash*vec3(.11,.16,.24);}
21
+ uniform sampler2D uSky;
22
+ uniform int uReflect;
23
+ float roadCenter(float z){return -1.6+2.1*sin(z*.012)+15.*(1.-smoothstep(-420.,-150.,z));}
24
+ float coast(float z){return roadCenter(z)+9.2+sin(z*.023)*1.8;}
25
+ float terrain(vec2 p){
26
+ float n=fbm2(p*.009+vec2(4.,9.));
27
+ float r=1.-abs(noise2(p*.018)*2.-1.);
28
+ float left=smoothstep(13.,155.,-p.x)*(28.+n*135.+r*20.);
29
+ float back=smoothstep(280.,670.,-p.y)*(46.+n*155.+r*22.);
30
+ float farRight=smoothstep(190.,430.,p.x)*(30.+n*95.);
31
+ float h=max(max(left,back),farRight);
32
+ float island=exp(-dot((p-vec2(94.,-205.))/vec2(39.,48.),(p-vec2(94.,-205.))/vec2(39.,48.)))*(18.+n*10.);
33
+ h=max(h,island);
34
+ if(h<1.5){h=p.x>coast(p.y)?-1.2:.10+n*.20;}
35
+ if(p.y> -175.&&abs(p.x-roadCenter(p.y))<7.3)h=0.;
36
+ return h;
37
+ }
38
+ float sdBox(vec3 p,vec3 b){vec3 q=abs(p)-b;return length(max(q,0.))+min(max(q.x,max(q.y,q.z)),0.);}
39
+ float capsule(vec3 p,vec3 a,vec3 b,float r){vec3 pa=p-a,ba=b-a;return length(pa-ba*clamp(dot(pa,ba)/dot(ba,ba),0.,1.))-r;}
40
+ vec2 choose(vec2 a,vec2 b){return a.x<b.x?a:b;}
41
+ vec2 sceneMap(vec3 p){
42
+ float h=terrain(p.xz);vec2 res=vec2((p.y-(h>1.?h:-3.5))*.58,1.);
43
+ // One bounded procedural tree per spatial cell; crowns fit inside their cells.
44
+ vec2 cell=floor((p.xz+vec2(2.,1.))/10.5);
45
+ float seed=hash12(cell+17.);
46
+ vec2 tc=(cell+.5)*10.5-vec2(2.,1.)+vec2(hash12(cell+3.),hash12(cell+7.))*.9-.45;
47
+ float th=terrain(tc), rel=tc.x-roadCenter(tc.y);
48
+ bool forest=(rel< -9.||tc.y< -175.)&&th>-.2&&th<115.&&seed>.15&&(tc.y< -12.||tc.x< -45.);
49
+ if(forest){
50
+ vec3 q=p-vec3(tc.x,th,tc.y);float ht=6.+seed*13.;
51
+ float cy=clamp(q.y/ht,0.,1.);float angle=atan(q.z,q.x);
52
+ float tier=.77+.23*sin(q.y*3.5+seed*13.);
53
+ float r=(1.-cy)*(2.+seed*1.45)*tier;
54
+ r*=.88+.12*sin(angle*9.+q.y*2.7)+.07*sin(angle*19.-q.y*6.);
55
+ float needle=(noise2(q.xz*6.+q.y*2.)-.5)*.18*(1.-cy);
56
+ float d=max(length(q.xz)-r+needle,max(.8-q.y,q.y-ht))*.67;
57
+ res=choose(res,vec2(d,2.));
58
+ res=choose(res,vec2(max(length(q.xz)-.13*(1.-cy*.65),max(-q.y,q.y-ht)),3.));
59
+ }
60
+ // Repeating steel luminaires, including their angled neck and illuminated undersides.
61
+ float k=clamp(floor((-p.z-10.)/38.+.5),0.,5.);float z=-10.-k*38.;
62
+ float x=roadCenter(z)-6.35;vec3 q=p-vec3(x,0.,z);
63
+ float pole=capsule(q,vec3(0.,0.,0.),vec3(0.,7.65,0.),.075);
64
+ pole=min(pole,capsule(q,vec3(0.,7.6,0.),vec3(1.6,8.05,0.),.065));
65
+ pole=min(pole,capsule(q,vec3(1.6,8.05,0.),vec3(2.5,8.05,0.),.055));
66
+ pole=min(pole,sdBox(q-vec3(2.43,8.,0.),vec3(.40,.10,.23)));
67
+ res=choose(res,vec2(pole,4.));
68
+ res=choose(res,vec2(sdBox(q-vec3(2.45,7.885,0.),vec3(.32,.021,.175)),6.));
69
+ // Guardrail on the water side, stopping before the distant curve.
70
+ if(p.z<28.&&p.z> -176.){
71
+ float rx=roadCenter(p.z)+6.3;
72
+ float rail=sdBox(vec3(p.x-rx,p.y-.84,0.),vec3(.065,.13,1000.));
73
+ float postZ=floor(p.z/5.+.5)*5.;
74
+ rail=min(rail,sdBox(p-vec3(roadCenter(postZ)+6.3,.45,postZ),vec3(.055,.45,.055)));
75
+ res=choose(res,vec2(rail,4.));
76
+ }
77
+ // Small roadside field station, with a lit window and antenna.
78
+ vec3 b=p-vec3(-17.,1.85,-73.);
79
+ float cabin=sdBox(b,vec3(3.3,1.85,2.65));
80
+ res=choose(res,vec2(cabin,9.));
81
+ res=choose(res,vec2(sdBox(p-vec3(-17.,3.85,-73.),vec3(3.6,.14,2.9)),4.));
82
+ res=choose(res,vec2(sdBox(p-vec3(-17.8,2.1,-70.325),vec3(.84,.48,.028)),6.));
83
+ res=choose(res,vec2(capsule(p,vec3(-19.,3.9,-74.),vec3(-19.,13.,-74.),.045),4.));
84
+ return res;
85
+ }
86
+ vec2 trace(vec3 ro,vec3 rd,float limit){
87
+ float t=.25,mat=-1.;
88
+ for(int i=0;i<148;i++){
89
+ if(t>limit||t>1850.)break;
90
+ vec3 p=ro+rd*t;vec2 d=sceneMap(p);
91
+ float eps=max(.007,t*.00048);
92
+ if(d.x<eps){mat=d.y;break;}
93
+ float stepD=max(.05,d.x*.87);
94
+ if(p.y<34.&&t<270.)stepD=min(stepD,4.8);
95
+ t+=stepD;
96
+ }
97
+ return vec2(t,mat);
98
+ }
99
+ vec3 getNormal(vec3 p,float t){float e=max(.008,t*.00032);vec2 k=vec2(1.,-1.)*.5773;return normalize(k.xyy*sceneMap(p+k.xyy*e).x+k.yyx*sceneMap(p+k.yyx*e).x+k.yxy*sceneMap(p+k.yxy*e).x+k.xxx*sceneMap(p+k.xxx*e).x);}
100
+ vec3 baseColor(vec3 p,float mat,vec3 n){
101
+ float grit=noise2(p.xz*4.3+p.y)*.2+noise2(p.xz*31.)*.09;
102
+ // One value, one return. The transpiler turns a GLSL early return into a JavaScript return that
103
+ // only leaves the `If` callback the node graph is being built inside, so the branch is never
104
+ // assigned and every material would take the colour of the last line. `else if` keeps the
105
+ // first-match order the five separate `if`s had, and `res` is seeded with the fall-through value.
106
+ vec3 res=vec3(.1);
107
+ if(mat<1.5){float moss=smoothstep(.46,.66,fbm2(p.xz*.3+p.y*.4))*smoothstep(.4,.9,n.y);res=mix(vec3(.075,.091,.090),vec3(.038,.068,.042),moss)*( .7+grit);}
108
+ else if(mat<2.5){res=mix(vec3(.017,.034,.027),vec3(.045,.071,.047),noise2(p.xz*5.+p.y))*(.8+max(n.y,0.)*.35);}
109
+ else if(mat<3.5)res=vec3(.060,.047,.036);
110
+ else if(mat<4.5)res=vec3(.12,.155,.17)*( .8+grit);
111
+ else if(mat>8.5){float seam=.75+.25*smoothstep(.01,.1,abs(fract(p.x*3.)-.5));res=vec3(.09,.13,.14)*seam;}
112
+ return res;
113
+ }
114
+ vec3 surfaceLight(vec3 p,vec3 n,vec3 v,vec3 albedo,float rough){
115
+ float hemi=.45+.55*max(n.y,0.);vec3 c=albedo*(uFill*hemi+uSunColor*max(dot(n,uSunDir),0.));
116
+ c+=albedo*uFlash*(.6+max(dot(n,normalize(uStrike-p)),0.)*2.5)*uFlashLight;
117
+ for(int i=0;i<6;i++){
118
+ float z=-10.-float(i)*38.;vec3 lp=vec3(roadCenter(z)-3.90,7.87,z);vec3 l=lp-p;float dist2=dot(l,l);l=normalize(l);
119
+ float ndl=max(dot(n,l),0.);float cone=smoothstep(.1,.62,-l.y)*smoothstep(-.1,.1,l.y);
120
+ float atten=48./(1.+dist2);vec3 warm=uLampLight;
121
+ c+=albedo*warm*atten*ndl*2.;
122
+ vec3 hv=normalize(l+v);float shin=mix(20.,900.,1.-rough);float spec=pow(max(dot(n,hv),0.),shin)*(shin+2.)*.018;
123
+ c+=warm*spec*atten*ndl*(rough>.55?.022:1.);
124
+ }
125
+ return c;
126
+ }
127
+ vec2 rippleSlope(vec2 p){
128
+ vec2 cell=floor(p/2.2);vec2 sum=vec2(0.);
129
+ for(int j=-1;j<=1;j++)for(int i=-1;i<=1;i++){
130
+ vec2 c=cell+vec2(float(i),float(j));float h=hash12(c+3.9);
131
+ vec2 ctr=(c+vec2(h,hash12(c+19.)))*2.2;vec2 v=p-ctr;float d=length(v)+.001;
132
+ float age=fract(uTime*(.60+uRain*.2)+h*7.3);float ring=d-age*1.7;
133
+ float env=exp(-abs(ring)*20.)*(1.-age)*smoothstep(.025,.10,age);
134
+ sum+=v/d*cos(ring*95.)*env*.055;
135
+ }return sum*uRain;
136
+ }
137
+ vec3 reflected(vec3 p,vec3 rd,vec3 sky){
138
+ // Same reason as baseColor: no early return. The `uReflect` guard becomes the condition around the
139
+ // march, which is still a skip, and a hit becomes a `res` plus a `Break`, which is what the trace
140
+ // already does. A ray that reaches the end of the march leaves `res` as the sky, as it did.
141
+ vec3 res=sky;
142
+ if(uReflect!=0){
143
+ float t=.5;
144
+ for(int i=0;i<36;i++){
145
+ if(t>280.)break;
146
+ vec3 q=p+rd*t;vec2 d=sceneMap(q);
147
+ if(d.x<max(.03,t*.0016)){
148
+ if(d.y>5.5&&d.y<6.5)res=uLampGlow*.75;
149
+ else res=mix(baseColor(q,d.y,vec3(0,1,0))*.7,hazeColor(rd),1.-exp(-t*(.0015+uFog*.004)));
150
+ break;
151
+ }t+=max(.15,d.x*.9);
152
+ }
153
+ }
154
+ return res;
155
+ }
156
+ void main(){
157
+ vec3 rd=ray(vUv);vec3 sky=texture(uSky,vUv).rgb;
158
+ float planeT=rd.y<-.0001?-uCam.y/rd.y:2200.;
159
+ vec3 pp=uCam+rd*planeT;
160
+ bool water=pp.x>coast(pp.z)&&terrain(pp.xz)<0.;
161
+ if(water&&rd.y<-.0001)planeT=(-.60-uCam.y)/rd.y;
162
+ vec2 hit=trace(uCam,rd,min(planeT,2200.));
163
+ float t=hit.x,mat=hit.y;vec3 p=uCam+rd*t;vec3 n;vec3 color=sky;
164
+ bool ground=mat<0.&&planeT>0.&&planeT<1800.;
165
+ if(ground){
166
+ t=planeT;p=uCam+rd*t;
167
+ float rx=abs(p.x-roadCenter(p.z));
168
+ water=p.x>coast(p.z)&&terrain(p.xz)<0.;
169
+ bool road=rx<5.35&&p.z> -190.;
170
+ vec2 ripple=rippleSlope(p.xz);
171
+ float coarse=noise2(p.xz*2.6),micro=noise2(p.xz*72.);
172
+ float puddle=smoothstep(.37,.64,fbm2(p.xz*.25+7.))*uWet;
173
+ if(water)puddle=1.;
174
+ vec2 wave=vec2(cos(p.x*1.3+p.z*.8+uTime*1.7),sin(p.z*1.7-p.x*.4-uTime*1.2))*(water?.018:.0015);
175
+ vec2 bump=(vec2(noise2(p.xz*35.),noise2(p.xz*35.+9.))-.5)*mix(.22,.013,puddle);
176
+ n=normalize(vec3(bump.x+wave.x+ripple.x,1.,bump.y+wave.y+ripple.y));
177
+ vec3 alb=road?vec3(.031,.037,.042)*( .58+coarse*.40+micro*.30):vec3(.075,.086,.070)*( .7+coarse*.45);
178
+ float rough=mix(.70,.08,puddle);
179
+ if(road){
180
+ float center=p.x-roadCenter(p.z);
181
+ float stripe=(1.-smoothstep(.042,.062,abs(abs(center)-.14)));
182
+ float edge=(1.-smoothstep(.06,.085,abs(rx-5.04)));
183
+ float wear=smoothstep(.1,.35,noise2(p.xz*26.));
184
+ alb=mix(alb,vec3(.50,.36,.11),stripe*wear*.85);
185
+ alb=mix(alb,vec3(.49,.54,.50),edge*wear*.60);
186
+ }
187
+ if(water){alb=uWater;rough=.045;}
188
+ color=surfaceLight(p,n,-rd,alb,rough);
189
+ float fres=.025+.975*pow(1.-max(dot(-rd,n),0.),5.);
190
+ vec2 suv=clamp(vUv+vec2(n.x,n.z)*vec2(.07,.05),.002,.998);
191
+ vec3 refl=reflected(p+n*.10,reflect(rd,n),texture(uSky,suv).rgb);
192
+ float reflection=water?(.25+fres*.7):(uWet*.05+puddle*.23+fres*.50);
193
+ color=mix(color,refl,clamp(reflection,0.,.94));
194
+ // Tiny high-frequency impact coronas, strongest against dark wet tarmac.
195
+ color+=length(ripple)*vec3(.055,.077,.09)*uRain;
196
+ mat=water?8.:(road?7.:1.);
197
+ }else if(mat>0.){
198
+ n=getNormal(p,t);
199
+ if(mat>5.5&&mat<6.5)color=uLampGlow;
200
+ else color=surfaceLight(p,n,-rd,baseColor(p,mat,n),mat>3.5?.28:.88);
201
+ float ao=clamp((p.y-terrain(p.xz))*.09+.50,.4,1.);if(mat!=6.)color*=ao;
202
+ }
203
+ if(mat>0.||ground){
204
+ // Height-dependent aerial perspective with advected rain curtains.
205
+ float curtain=.80+.40*fbm2(p.xz*.012+vec2(uTime*.014,0.));
206
+ float fog=1.-exp(-t*(.0011+uFog*.0048)*curtain*exp(-max(p.y,0.)*.008));
207
+ color=mix(color,hazeColor(rd),clamp(fog,0.,.98));
208
+ float d=max(.15,t*dot(rd,uForward));gl_FragDepth=clamp(1.00006-.150009/d,0.,.999999);
209
+ }else gl_FragDepth=1.;
210
+ fragColor=vec4(max(color,vec3(0.)),1.);
@@ -0,0 +1,61 @@
1
+ // Proves `src/render/noise-volume.ts` is the reference study's volume, byte for byte.
2
+ //
3
+ // node --import tsx tools/verify-noise-volume.mjs <tempest.html>
4
+ //
5
+ // The generated module is imported and run; `rng` and `noiseVolume` are cut out of the study file
6
+ // and called in a `node:vm` context holding nothing but `Math`, `Uint8Array` and `Float32Array`,
7
+ // because the comparison is over pure data and neither side may reach a browser, a GPU or the
8
+ // framework. Fails closed: a missing file, a function the study no longer has, or one differing byte
9
+ // is an error, and the full 1 MiB is compared rather than a sample of it.
10
+ import { createHash } from "node:crypto";
11
+ import { readFileSync } from "node:fs";
12
+ import { runInNewContext } from "node:vm";
13
+ import { NOISE_SIZE, createNoiseVolume } from "../src/render/noise-volume.ts";
14
+
15
+ const [source] = process.argv.slice(2);
16
+ if (source === undefined) {
17
+ console.error("usage: node --import tsx tools/verify-noise-volume.mjs <tempest.html>");
18
+ process.exit(2);
19
+ }
20
+
21
+ /** The text of `function <name>` from `from`, up to its own closing brace. */
22
+ function functionSource(text, name) {
23
+ const start = text.indexOf(`function ${name}`);
24
+ if (start === -1) throw new Error(`TN_SOURCE_MISSING: ${name} is not in the study`);
25
+ let depth = 0;
26
+ let opened = false;
27
+ for (let index = start; index < text.length; index += 1) {
28
+ if (text[index] === "{") {
29
+ depth += 1;
30
+ opened = true;
31
+ } else if (text[index] === "}" && opened) {
32
+ depth -= 1;
33
+ if (depth === 0) return text.slice(start, index + 1);
34
+ }
35
+ }
36
+ throw new Error(`TN_SOURCE_UNBALANCED: ${name} never closes`);
37
+ }
38
+
39
+ const study = readFileSync(source, "utf8");
40
+ const reference = runInNewContext(
41
+ `(() => {${study.match(/const mix=[^\n]*/u)[0]}
42
+ ${functionSource(study, "rng")}
43
+ ${functionSource(study, "noiseVolume")}
44
+ return noiseVolume();})()`,
45
+ { Math, Uint8Array, Float32Array },
46
+ );
47
+ const expected = reference.data;
48
+ const actual = createNoiseVolume().data;
49
+
50
+ if (actual.length !== expected.length || expected.length !== NOISE_SIZE ** 3 * 4) {
51
+ throw new Error(`TN_NOISE_SIZE: ${expected.length} source bytes, ${actual.length} generated`);
52
+ }
53
+ for (let index = 0; index < expected.length; index += 1) {
54
+ if (actual[index] !== expected[index]) {
55
+ throw new Error(
56
+ `TN_NOISE_BYTE: index ${index} is ${actual[index]}, source has ${expected[index]}`,
57
+ );
58
+ }
59
+ }
60
+ const digest = createHash("sha256").update(actual).digest("hex");
61
+ console.log(`TN_NOISE_MATCH ${actual.length} bytes sha256=${digest}`);
@@ -0,0 +1,17 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2022",
4
+ "lib": ["ES2022", "DOM", "DOM.Iterable"],
5
+ "module": "ESNext",
6
+ "moduleResolution": "bundler",
7
+ "jsx": "react-jsx",
8
+ "types": ["vite/client"],
9
+ "strict": true,
10
+ "noUncheckedIndexedAccess": true,
11
+ "noEmit": true,
12
+ "skipLibCheck": true,
13
+ "verbatimModuleSyntax": true,
14
+ "isolatedModules": true
15
+ },
16
+ "include": ["src/**/*.ts", "src/**/*.tsx", "tests/**/*.ts", "*.ts"]
17
+ }
@@ -0,0 +1,37 @@
1
+ import tailwindcss from "@tailwindcss/vite";
2
+ import { watchAssets } from "@threenative/assets";
3
+ import react from "@vitejs/plugin-react";
4
+ import { createEngineFreshnessPlugin, createWebBrandPlugin } from "create-threenative";
5
+ import { defineConfig } from "vite";
6
+ import type { Plugin } from "vite";
7
+ import config from "./threenative.config.js";
8
+
9
+ function assetsWatchPlugin(): Plugin {
10
+ return {
11
+ name: "threenative-assets-watch",
12
+ apply: "serve",
13
+ async configureServer(server) {
14
+ const handle = watchAssets({ config: config.assets, cwd: server.config.root });
15
+ server.httpServer?.once("close", () => handle.close());
16
+ // Nothing is served before the first cook settles: until it does, `public/` has no
17
+ // `assets.manifest.json` and every asset answers from its source fallback.
18
+ await handle.ready;
19
+ },
20
+ };
21
+ }
22
+
23
+ export default defineConfig({
24
+ plugins: [
25
+ createEngineFreshnessPlugin(),
26
+ createWebBrandPlugin(),
27
+ react(),
28
+ tailwindcss(),
29
+ assetsWatchPlugin(),
30
+ ],
31
+ server: {
32
+ watch: {
33
+ ignored: ["**/artifacts/**", "**/screenshots/**", "**/playtests/**"],
34
+ usePolling: true,
35
+ },
36
+ },
37
+ });
@@ -31,7 +31,7 @@
31
31
  "@types/react-dom": "19.2.0",
32
32
  "@types/three": "0.185.3",
33
33
  "@vitejs/plugin-react": "6.0.5",
34
- "create-threenative": "0.2.7",
34
+ "create-threenative": "0.2.8",
35
35
  "esbuild": "0.27.0",
36
36
  "playwright": "1.62.1",
37
37
  "tailwindcss": "4.3.3",
@@ -31,7 +31,7 @@
31
31
  "@types/react-dom": "19.2.0",
32
32
  "@types/three": "0.185.3",
33
33
  "@vitejs/plugin-react": "6.0.5",
34
- "create-threenative": "0.2.7",
34
+ "create-threenative": "0.2.8",
35
35
  "esbuild": "0.27.0",
36
36
  "playwright": "1.62.1",
37
37
  "tailwindcss": "4.3.3",
@@ -32,7 +32,7 @@
32
32
  "@types/react-dom": "19.2.0",
33
33
  "@types/three": "0.185.3",
34
34
  "@vitejs/plugin-react": "6.0.5",
35
- "create-threenative": "0.2.7",
35
+ "create-threenative": "0.2.8",
36
36
  "esbuild": "0.27.0",
37
37
  "playwright": "1.62.1",
38
38
  "tailwindcss": "4.3.3",
@@ -32,7 +32,7 @@
32
32
  "@types/react": "19.2.0",
33
33
  "@types/react-dom": "19.2.0",
34
34
  "playwright": "1.62.1",
35
- "create-threenative": "0.2.7",
35
+ "create-threenative": "0.2.8",
36
36
  "esbuild": "0.27.0",
37
37
  "tailwindcss": "4.3.3",
38
38
  "typescript": "5.9.3",
@@ -0,0 +1,19 @@
1
+ [mcp_servers.threenative-assets]
2
+ command = "node"
3
+ args = ["./node_modules/@threenative/core/mcp/assets.mjs"]
4
+
5
+ [mcp_servers.threenative-assets.env]
6
+ ASSET_DOWNLOAD_DIR = "./public/assets"
7
+ AUDIO_DOWNLOAD_DIR = "./public/audio"
8
+
9
+ [mcp_servers.threenative-sculpt]
10
+ command = "node"
11
+ args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
12
+
13
+ [mcp_servers.threenative-engine]
14
+ command = "node"
15
+ args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
16
+
17
+ [mcp_servers.threenative-blender]
18
+ command = "node"
19
+ args = ["./node_modules/@threenative/core/mcp/blender.mjs"]
@@ -0,0 +1,32 @@
1
+ {
2
+ "mcpServers": {
3
+ "threenative-assets": {
4
+ "command": "node",
5
+ "args": [
6
+ "./node_modules/@threenative/core/mcp/assets.mjs"
7
+ ],
8
+ "env": {
9
+ "ASSET_DOWNLOAD_DIR": "./public/assets",
10
+ "AUDIO_DOWNLOAD_DIR": "./public/audio"
11
+ }
12
+ },
13
+ "threenative-sculpt": {
14
+ "command": "node",
15
+ "args": [
16
+ "./node_modules/@threenative/core/mcp/sculpt.mjs"
17
+ ]
18
+ },
19
+ "threenative-engine": {
20
+ "command": "node",
21
+ "args": [
22
+ "./node_modules/@threenative/core/mcp/engine.mjs"
23
+ ]
24
+ },
25
+ "threenative-blender": {
26
+ "command": "node",
27
+ "args": [
28
+ "./node_modules/@threenative/core/mcp/blender.mjs"
29
+ ]
30
+ }
31
+ }
32
+ }
@@ -0,0 +1,32 @@
1
+ {
2
+ "mcpServers": {
3
+ "threenative-assets": {
4
+ "command": "node",
5
+ "args": [
6
+ "./node_modules/@threenative/core/mcp/assets.mjs"
7
+ ],
8
+ "env": {
9
+ "ASSET_DOWNLOAD_DIR": "./public/assets",
10
+ "AUDIO_DOWNLOAD_DIR": "./public/audio"
11
+ }
12
+ },
13
+ "threenative-sculpt": {
14
+ "command": "node",
15
+ "args": [
16
+ "./node_modules/@threenative/core/mcp/sculpt.mjs"
17
+ ]
18
+ },
19
+ "threenative-engine": {
20
+ "command": "node",
21
+ "args": [
22
+ "./node_modules/@threenative/core/mcp/engine.mjs"
23
+ ]
24
+ },
25
+ "threenative-blender": {
26
+ "command": "node",
27
+ "args": [
28
+ "./node_modules/@threenative/core/mcp/blender.mjs"
29
+ ]
30
+ }
31
+ }
32
+ }
@@ -0,0 +1,32 @@
1
+ {
2
+ "mcpServers": {
3
+ "threenative-assets": {
4
+ "command": "node",
5
+ "args": [
6
+ "./node_modules/@threenative/core/mcp/assets.mjs"
7
+ ],
8
+ "env": {
9
+ "ASSET_DOWNLOAD_DIR": "./public/assets",
10
+ "AUDIO_DOWNLOAD_DIR": "./public/audio"
11
+ }
12
+ },
13
+ "threenative-sculpt": {
14
+ "command": "node",
15
+ "args": [
16
+ "./node_modules/@threenative/core/mcp/sculpt.mjs"
17
+ ]
18
+ },
19
+ "threenative-engine": {
20
+ "command": "node",
21
+ "args": [
22
+ "./node_modules/@threenative/core/mcp/engine.mjs"
23
+ ]
24
+ },
25
+ "threenative-blender": {
26
+ "command": "node",
27
+ "args": [
28
+ "./node_modules/@threenative/core/mcp/blender.mjs"
29
+ ]
30
+ }
31
+ }
32
+ }
@@ -0,0 +1,36 @@
1
+ {
2
+ "servers": {
3
+ "threenative-assets": {
4
+ "type": "stdio",
5
+ "command": "node",
6
+ "args": [
7
+ "./node_modules/@threenative/core/mcp/assets.mjs"
8
+ ],
9
+ "env": {
10
+ "ASSET_DOWNLOAD_DIR": "./public/assets",
11
+ "AUDIO_DOWNLOAD_DIR": "./public/audio"
12
+ }
13
+ },
14
+ "threenative-sculpt": {
15
+ "type": "stdio",
16
+ "command": "node",
17
+ "args": [
18
+ "./node_modules/@threenative/core/mcp/sculpt.mjs"
19
+ ]
20
+ },
21
+ "threenative-engine": {
22
+ "type": "stdio",
23
+ "command": "node",
24
+ "args": [
25
+ "./node_modules/@threenative/core/mcp/engine.mjs"
26
+ ]
27
+ },
28
+ "threenative-blender": {
29
+ "type": "stdio",
30
+ "command": "node",
31
+ "args": [
32
+ "./node_modules/@threenative/core/mcp/blender.mjs"
33
+ ]
34
+ }
35
+ }
36
+ }
@@ -0,0 +1,36 @@
1
+ {
2
+ "context_servers": {
3
+ "threenative-assets": {
4
+ "source": "custom",
5
+ "command": "node",
6
+ "args": [
7
+ "./node_modules/@threenative/core/mcp/assets.mjs"
8
+ ],
9
+ "env": {
10
+ "ASSET_DOWNLOAD_DIR": "./public/assets",
11
+ "AUDIO_DOWNLOAD_DIR": "./public/audio"
12
+ }
13
+ },
14
+ "threenative-sculpt": {
15
+ "source": "custom",
16
+ "command": "node",
17
+ "args": [
18
+ "./node_modules/@threenative/core/mcp/sculpt.mjs"
19
+ ]
20
+ },
21
+ "threenative-engine": {
22
+ "source": "custom",
23
+ "command": "node",
24
+ "args": [
25
+ "./node_modules/@threenative/core/mcp/engine.mjs"
26
+ ]
27
+ },
28
+ "threenative-blender": {
29
+ "source": "custom",
30
+ "command": "node",
31
+ "args": [
32
+ "./node_modules/@threenative/core/mcp/blender.mjs"
33
+ ]
34
+ }
35
+ }
36
+ }