@volter/cyclotron 0.5.201 → 0.5.203

package/starter/playable/src/models/circuit.py

@@ -0,0 +1,131 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright 2026 Volter AI, Inc.
+# Milestone 1 of canyon.py: the circuit, six karts, sky, sun and chase camera.
+import bpy, math, random, datetime
+from mathutils import Vector
+from pathlib import Path
+ROOT=str(Path(bpy.data.filepath).resolve().parents[2])
+random.seed(71)
+# Rebuild only owned scene content, preserving reference, notes and manual objects.
+for o in list(bpy.data.objects):
+ if (o.get('canyon_owned') or o.name=='Cube') and not any(c.name in ['References','Notes'] for c in o.users_collection): bpy.data.objects.remove(o,do_unlink=True)
+col=bpy.data.collections.get('Canyon Comet') or bpy.data.collections.new('Canyon Comet')
+if col.name not in bpy.context.scene.collection.children: bpy.context.scene.collection.children.link(col)
+def own(o): o['canyon_owned']=True; col.objects.link(o); return o
+def lin(c): return c/12.92 if c<.04045 else ((c+.055)/1.055)**2.4
+def mat(n,h,rough=.55,metal=0):
+ m=bpy.data.materials.get(n) or bpy.data.materials.new(n); m.use_nodes=True
+ rgb=[lin(int(h[i:i+2],16)/255) for i in (0,2,4)]; m.diffuse_color=(*rgb,1)
+ p=m.node_tree.nodes.get('Principled BSDF'); p.inputs['Base Color'].default_value=(*rgb,1); p.inputs['Roughness'].default_value=rough;p.inputs['Metallic'].default_value=metal
+ return m
+sand=mat('Warm peach sand','EBA76B'); road=mat('Granular warm asphalt','777970',.98); white=mat('Ivory enamel','EDF1E7',.28); teal=mat('Lagoon turquoise','13C8CF',.25,.15); yellow=mat('Golden yellow','F5C62B',.3); purple=mat('Violet racer','773FDC',.28); green=mat('Apple racer','59BC37',.28); blue=mat('Sky racer','319BBE',.27); coral=mat('Coral racer','F05C33',.3); tire=mat('Graphite rubber','202A29',.9); metal=mat('Brushed aluminum','A3AFAA',.3,.55); dark=mat('Ink blue helmet','203D58',.28); red=mat('Ruby tail lamps','BA291D',.22); orange=mat('Tangerine trim','F68B25',.3); mint=mat('Mint creature','38CCAC',.4); edge=mat('Mint track paint','5AF1B9',.8); black=mat('Sign charcoal','343B32',.8); lamp=mat('Amber lamps','FFF399',.4)
+lamp.node_tree.nodes.get('Principled BSDF').inputs['Emission Color'].default_value=(1,.72,.15,1);lamp.node_tree.nodes.get('Principled BSDF').inputs['Emission Strength'].default_value=1.2
+cache={}
+def mesh(n,v,f,m):
+ d=bpy.data.meshes.new(n);d.from_pydata(v,[],f);d.materials.append(m);d.update();return d
+def obj(n,d,loc=(0,0,0),scale=(1,1,1),parent=None):
+ o=own(bpy.data.objects.new(n,d));o.location=loc;o.scale=scale;o.parent=parent;return o
+def sphere(n,loc,scale,m,parent=None):
+ key=('sphere',m.name)
+ if key not in cache:
+  v=[(math.sin(math.pi*j/16)*math.cos(2*math.pi*i/28),math.sin(math.pi*j/16)*math.sin(2*math.pi*i/28),math.cos(math.pi*j/16)) for j in range(17) for i in range(28)]
+  f=[(j*28+i,j*28+(i+1)%28,(j+1)*28+(i+1)%28,(j+1)*28+i) for j in range(16) for i in range(28)]
+  # Sphere param runs north to south, winding outward.
+  d=mesh('Smooth '+m.name,v,[tuple(reversed(a)) for a in f],m)
+  for p in d.polygons:p.use_smooth=True
+  cache[key]=d
+ return obj(n,cache[key],loc,scale,parent)
+def box(n,loc,s,m,parent=None):
+ key=('box',m.name)
+ if key not in cache:
+  v=[(-1,-1,-1),(1,-1,-1),(1,1,-1),(-1,1,-1),(-1,-1,1),(1,-1,1),(1,1,1),(-1,1,1)]
+  cache[key]=mesh(m.name+' block',v,[(0,3,2,1),(0,1,5,4),(1,2,6,5),(2,3,7,6),(3,0,4,7),(4,5,6,7)],m)
+ return obj(n,cache[key],loc,tuple(a/2 for a in s),parent)
+def rod(n,a,b,r,m,parent=None):
+ mid=(Vector(a)+Vector(b))/2;o=sphere(n,mid,(r,r,(Vector(b)-Vector(a)).length/2+r),m,parent);o.rotation_euler=(Vector(b)-Vector(a)).to_track_quat('Z','Y').to_euler();return o
+def torus(n,loc,R,r,m,parent=None):
+ key=('torus',R,r,m.name)
+ if key not in cache:
+  v=[((R+r*math.cos(j*math.tau/12))*math.cos(i*math.tau/28),(R+r*math.cos(j*math.tau/12))*math.sin(i*math.tau/28),r*math.sin(j*math.tau/12)) for i in range(28) for j in range(12)]
+  f=[(i*12+j,((i+1)%28)*12+j,((i+1)%28)*12+(j+1)%12,i*12+(j+1)%12) for i in range(28) for j in range(12)]
+  d=mesh(n,v,f,m)
+  for p in d.polygons:p.use_smooth=True
+  cache[key]=d
+ return obj(n,cache[key],loc,parent=parent)
+POINTS=[(0,0),(0,25),(12,55),(42,70),(68,45),(65,5),(40,-25),(8,-25)]
+def center(t):
+ k=math.floor(t)%8;u=t%1;p0=Vector(POINTS[(k-1)%8]);p1=Vector(POINTS[k]);p2=Vector(POINTS[(k+1)%8]);p3=Vector(POINTS[(k+2)%8]);return .5*((2*p1)+(-p0+p2)*u+(2*p0-5*p1+4*p2-p3)*u*u+(-p0+3*p1-3*p2+p3)*u*u*u)
+def sample(t,offset=0):
+ p=center(t);d=(center(t+.001)-center(t-.001)).normalized();return p+Vector((d.y,-d.x))*offset
+N=512
+def ribbon(n,left,right,z,m):
+ v=[]
+ for i in range(N):
+  for off in [left,right]:
+   p=sample(i*8/N,off);v.append((p.x,p.y,z))
+ f=[(2*i,2*i+1,2*((i+1)%N)+1,2*((i+1)%N)) for i in range(N)]
+ return obj(n,mesh(n,v,f,m))
+box('Desert floor',(30,20,-.3),(360,360,.5),sand)
+ribbon('Circuit asphalt',-12,12,0,road)
+for side in [-1,1]:
+ ribbon('Ivory shoulder '+str(side),side*12,side*12.5,.015,white)
+ ribbon('Turquoise racing edge '+str(side),side*11.45,side*12,.028,edge)
+for i in range(90):
+ t=i*8/90;p=sample(t);q=sample(t+.015);d=q-p
+ o=box('Lane dash %03d'%i,(p.x,p.y,.035),(.28,2.1,.015),white);o.rotation_euler.z=-math.atan2(d.x,d.y)
+def kart(index,pos,color,character):
+ root=own(bpy.data.objects.new('Kart.%d'%index,None));root.location=pos
+ sphere('K%d sculpted chassis'%index,(0,0,.64),(1.05,1.5,.52),color,root)
+ sphere('K%d cockpit'%index,(0,.12,1.01),(.73,.8,.19),tire,root)
+ sphere('K%d nose'%index,(0,1,.67),(.9,.75,.35),color,root)
+ for x in [-1,1]:
+  for y in [-.88,.88]:
+   o=torus('K%d tire'%index,(x,y,.46),.31,.16,tire,root);o.rotation_euler.y=math.pi/2
+   sphere('K%d gold wheel'%index,(x*1.145,y,.46),(.07,.28,.28),yellow,root)
+   sphere('K%d wheel hub'%index,(x*1.2,y,.46),(.025,.13,.13),tire,root)
+  sphere('K%d white rear pod'%index,(x*.8,-.85,.85),(.23,.53,.44),white,root)
+  sphere('K%d red lamp'%index,(x*.83,-1.28,.98),(.14,.065,.23),red,root)
+  sphere('K%d lamp glint'%index,(x*.8,-1.34,1.06),(.045,.017,.085),orange,root)
+  rod('K%d wing strut'%index,(x*.6,-.84,1.1),(x*.6,-.84,1.4),.055,metal,root)
+ sphere('K%d rounded wing'%index,(0,-.96,1.4),(.88,.18,.09),color,root)
+ box('K%d rear cream stripe'%index,(0,-1.46,.72),(.32,.018,.45),white,root)
+ sphere('K%d bumper'%index,(0,-1.43,.46),(.48,.16,.22),metal,root)
+ for x in [-.17,.17]:
+  o=torus('K%d exhaust rim'%index,(x,-1.66,.34),.12,.042,metal,root);o.rotation_euler.x=math.pi/2
+  sphere('K%d exhaust bore'%index,(x,-1.65,.34),(.105,.02,.105),tire,root)
+ sphere('K%d driver suit'%index,(0,.05,1.36),(.43,.34,.48),orange if index==0 else coral,root)
+ for x in [-.37,.37]:rod('K%d driver arm'%index,(x,0,1.49),(x,.55,1.18),.14,white,root)
+ if character=='helmet':
+  sphere('K%d helmet rim'%index,(0,.05,1.82),(.64,.6,.28),tire,root)
+  sphere('K%d helmet'%index,(0,.06,2.14),(.67,.61,.65),white,root)
+  sphere('K%d face visor'%index,(0,.55,2.11),(.5,.14,.32),dark,root)
+  # Orange stripe follows the curved helmet from brow to neck.
+  v=[];f=[]
+  for j in range(33):
+   a=-math.pi*.48+math.pi*1.05*j/32
+   for x in [-.115,.115]:v.append((x,.06+math.sin(a)*.623,2.14+math.cos(a)*.657))
+  for j in range(32):f.append((j*2,j*2+1,j*2+3,j*2+2))
+  obj('K%d helmet stripe'%index,mesh('Stripe',v,f,orange),parent=root)
+  sphere('K%d scarf'%index,(0,-.28,1.49),(.38,.12,.14),coral,root)
+ elif character=='miso':
+  sphere('K%d mint head'%index,(0,.06,2.03),(.77,.66,.65),mint,root)
+  for x in [-.73,.73]:sphere('K%d rounded ears'%index,(x,.05,2.17),(.28,.21,.28),mint,root)
+  for x in [-.28,.28]:sphere('K%d coral crest'%index,(x,.02,2.67),(.14,.25,.28),orange,root)
+ else:
+  sphere('K%d navy helmet'%index,(0,.06,2.1),(.68,.62,.64),dark,root)
+  for x in [-.66,.66]:
+   sphere('K%d orange earcup'%index,(x,0,2.04),(.15,.28,.3),orange,root)
+   sphere('K%d earcup metal'%index,(x*1.14,0,2.04),(.025,.17,.19),metal,root)
+  rod('K%d headband'%index,(-.52,.04,2.56),(.52,.04,2.56),.08,metal,root)
+  sphere('K%d visor'%index,(0,.6,2.12),(.48,.13,.28),teal,root)
+ return root
+kart(0,(0,0,0),teal,'helmet');kart(1,(-5.4,1.3,0),yellow,'miso');kart(2,(4.8,4.4,0),purple,'nova');kart(3,(-1.5,17,0),green,'miso');kart(4,(1,23,0),blue,'helmet');kart(5,(7,30,0),coral,'nova')
+# Sunlight and a sky dome use the actual authored scene in Edit and Play.
+world=bpy.context.scene.world or bpy.data.worlds.new('Canyon sky');bpy.context.scene.world=world;world.use_nodes=True;world.node_tree.nodes['Background'].inputs[0].default_value=(.23,.65,.8,1);world.node_tree.nodes['Background'].inputs[1].default_value=.7
+sky=mat('Cyan sky','6AD9ED',1);p=sky.node_tree.nodes.get('Principled BSDF');p.inputs['Emission Color'].default_value=(*[lin(a/255) for a in (106,217,237)],1);p.inputs['Emission Strength'].default_value=.8
+light=bpy.data.lights.new('Afternoon sun','SUN');light.energy=3;light.angle=.08;l=own(bpy.data.objects.new('Afternoon sun',light));l.rotation_euler=(.5,-.5,-.5)
+c=bpy.data.cameras.new('Chase camera');c.lens=24;c.sensor_width=36;cam=own(bpy.data.objects.new('Chase camera',c));cam.location=(0,-9,5.1);cam.rotation_euler=(Vector((0,18,1.6))-cam.location).to_track_quat('-Z','Y').to_euler();bpy.context.scene.camera=cam
+bpy.context.scene.render.resolution_x=1672;bpy.context.scene.render.resolution_y=941
+bpy.context.scene.view_settings.view_transform='Standard'
+bpy.ops.wm.save_as_mainfile(filepath=ROOT+'/src/models/canyon.blend')
+print('Milestone 1: circuit, six rounded karts and chase camera saved')

package/starter/playable/src/models/complete_environment.py

@@ -0,0 +1,35 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright 2026 Volter AI, Inc.
+import bpy,math,random,datetime
+from pathlib import Path
+ROOT=str(Path(bpy.data.filepath).resolve().parents[2])
+exec(compile(open(ROOT+'/src/models/scene_helpers.py').read(),'scene_helpers.py','exec'))
+random.seed(38)
+rock=bpy.data.materials['Continuous sandstone strata']
+# Layered landforms on the return straight and inner island.
+def mesa2(n,x,y,rx,ry,h):
+ v=[];count=18;rings=17
+ jitter=[random.uniform(.87,1.1)for _ in range(count)]
+ for j in range(rings):
+  z=h*j/(rings-1);s=1-(j//4)*.14
+  for i in range(count):
+   a=i*math.tau/count;r=s*jitter[i];v.append((x+rx*r*math.cos(a)+.16*math.sin(z+i),y+ry*r*math.sin(a),z))
+ f=[(j*count+i,j*count+(i+1)%count,(j+1)*count+(i+1)%count,(j+1)*count+i)for j in range(rings-1)for i in range(count)];f+=[tuple(range((rings-1)*count,rings*count))]
+ d=mesh(n,v,f,rock);o=obj(n,d);uv=d.uv_layers.new(name='Strata')
+ for p in d.polygons:
+  for li in p.loop_indices:
+   a=d.vertices[d.loops[li].vertex_index].co;uv.data[li].uv=((a.x+a.y*.61)/18,a.z/9)
+ b=o.modifiers.new('Weathered corners','BEVEL');b.width=.22;b.segments=2
+ return o
+for i,(x,y,rx,ry,h)in enumerate([(-40,-32,15,22,23),(-14,-59,22,12,21),(22,-62,21,12,28),(57,-56,15,12,19),(90,-34,15,20,24),(112,0,16,22,29),(112,38,13,21,24),(104,76,15,18,27),(70,106,21,15,22),(32,26,10,14,8),(38,48,9,8,5)]):mesa2('Return canyon mesa '+str(i),x,y,rx,ry,h)
+for ob in list(bpy.data.objects):
+ if ob.name.startswith('Distant eroded butte'):bpy.data.objects.remove(ob,do_unlink=True)
+# Add fine puffs to the clouds, using one shared mesh.
+cloud=bpy.data.materials['Soft cream clouds'];p=cloud.node_tree.nodes['Principled BSDF'];p.inputs['Emission Color'].default_value=(.45,.43,.38,1);p.inputs['Emission Strength'].default_value=.45
+for x,y,z in [(-5,-140,40),(60,-140,42),(155,30,47)]:
+ for j in range(18):sphere('Return cloud puff',(x+random.uniform(-15,15),y+random.uniform(-3,3),z+random.uniform(-3,4)),(random.uniform(2,5),3,random.uniform(2,4)),cloud)
+# Visible start/finish stripe lives just behind the grid, leaving the reference shot open.
+for ix in range(20):
+ for iy in range(2):box('Finish line tile',(-11.4+ix*1.2,-2+iy*.6,.045),(1.2,.6,.018),white if (ix+iy)%2==0 else tire)
+bpy.ops.wm.save_as_mainfile(filepath=ROOT+'/src/models/canyon.blend')
+print('Return circuit scenery and finish line saved')

package/starter/playable/src/models/course.ts

@@ -0,0 +1,12 @@
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Volter AI, Inc.
+export const points=[[0,0],[0,25],[12,55],[42,70],[68,45],[65,5],[40,-25],[8,-25]];
+export function curve(t:number){const k=Math.floor(t),u=t-k;const p=[-1,0,1,2].map(d=>points[((k+d)%8+8)%8]);return [0,1].map(c=>.5*(2*p[1][c]+(-p[0][c]+p[2][c])*u+(2*p[0][c]-5*p[1][c]+4*p[2][c]-p[3][c])*u*u+(-p[0][c]+3*p[1][c]-3*p[2][c]+p[3][c])*u*u*u));}
+export const course=Array.from({length:769},(_,i)=>{const p=curve(i*8/768);return {x:p[0],y:p[1],s:0,t:i*8/768}});
+for(let i=1;i<course.length;i++)course[i].s=course[i-1].s+Math.hypot(course[i].x-course[i-1].x,course[i].y-course[i-1].y);
+export const length=course.at(-1)!.s;
+export const wrap=(v:number)=>((v%length)+length)%length;
+export function at(s:number,lane=0){s=wrap(s);let lo=0,hi=768;while(hi-lo>1){const m=(lo+hi)>>1;if(course[m].s<s)lo=m;else hi=m;}const a=course[lo],b=course[hi],f=(s-a.s)/(b.s-a.s),dx=b.x-a.x,dy=b.y-a.y,h=Math.atan2(dx,dy);return {x:a.x+(b.x-a.x)*f+Math.cos(h)*lane,y:a.y+(b.y-a.y)*f-Math.sin(h)*lane,heading:h,t:a.t+(b.t-a.t)*f};}
+export function nearest(x:number,y:number){let best=Infinity,res={s:0,x:0,y:0,d:0,lane:0,t:0,heading:0};for(let i=0;i<768;i++){const a=course[i],b=course[i+1],dx=b.x-a.x,dy=b.y-a.y,q=Math.max(0,Math.min(1,((x-a.x)*dx+(y-a.y)*dy)/(dx*dx+dy*dy))),px=a.x+dx*q,py=a.y+dy*q,d=(px-x)**2+(py-y)**2;if(d<best){best=d;const h=Math.atan2(dx,dy);res={x:px,y:py,s:a.s+q*(b.s-a.s),d:Math.sqrt(d),lane:(x-px)*Math.cos(h)-(y-py)*Math.sin(h),heading:h,t:a.t+(b.t-a.t)*q}}}return res;}
+export const leftWidth=(t:number,y:number)=>12+((t<2.4||t>7.3)?17*Math.exp(-Math.max(0,y)/28):0);
+export const angle=(v:number)=>Math.atan2(Math.sin(v),Math.cos(v));

package/starter/playable/src/models/detail.py

@@ -0,0 +1,44 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright 2026 Volter AI, Inc.
+import bpy,math,random,datetime
+from pathlib import Path
+ROOT=str(Path(bpy.data.filepath).resolve().parents[2])
+exec(compile(open(ROOT+'/src/models/scene_helpers.py').read(),'scene_helpers.py','exec'))
+for ob in list(bpy.data.objects):
+ if 'exhaust tube' in ob.name:bpy.data.objects.remove(ob,do_unlink=True)
+# Wider, softer kart body with a rounded rectangular engine bumper.
+for i in range(6):
+ rt=bpy.data.objects['Kart.'+str(i)]
+ for ob in rt.children:
+  if 'bumper' in ob.name:
+   ob.scale.z*=1.6;ob.scale.y*=.85
+  if 'helmet stripe' in ob.name:
+   for j in range(33):
+    a=-2.2+4.0*j/32
+    for k,x in enumerate([-.115,.115]):ob.data.vertices[j*2+k].co=(x,.06+math.sin(a)*.623,2.14+math.cos(a)*.657)
+   ob.data.update()
+ # Small amber brake studs and bolts provide scale and material contrast.
+ for x in [-.58,.58]:sphere('K%d wing bolt'%i,(x,-1.08,1.4),(.055,.035,.035),metal,rt)
+# Broader lane dashes and a more open skyline.
+for ob in bpy.data.objects:
+ if ob.name.startswith('Lane dash'):
+  ob.scale.x*=1.8;ob.scale.y*=.7
+ if ob.name.startswith('Cloud'):
+  ob.scale.z*=.65;ob.location.z+=5
+# Raised sand terraces put the left signs above the distant rail like the reference.
+for name in ['West ledge','West middle mesa']:
+ ob=bpy.data.objects[name];ob.scale.z*=.86
+# Secondary sandstone shelves, forming broad irregular blocks rather than isolated cylinders.
+rock=bpy.data.materials['Continuous sandstone strata']
+for i,(x,y,z,sx,sy,sz) in enumerate([(-29,28,1.2,18,18,2.4),(-23,45,1.1,14,16,2.2),(28,37,.7,8,7,1.4)]):
+ ob=box('Low sandstone shelf '+str(i),(x,y,z),(sx,sy,sz),rock)
+ uv=ob.data.uv_layers.get('Strata') or ob.data.uv_layers.new(name='Strata')
+ for p in ob.data.polygons:
+  for li in p.loop_indices:
+   v=ob.data.vertices[ob.data.loops[li].vertex_index].co;uv.data[li].uv=((v.x+v.y)*.5,v.z*.25)
+# Hazy distant formations fill the opening below the arch.
+haze=mat('Distant rose sandstone','DBA188',1)
+for x,y,z,sx,sy,sz in [(23,122,5,18,13,10),(29,123,11,13,11,5),(29,123,15,8,8,3),(-3,137,6,16,16,12)]:
+ sphere('Distant eroded butte',(x,y,z),(sx,sy,sz*.5),haze)
+bpy.ops.wm.save_as_mainfile(filepath=ROOT+'/src/models/canyon.blend')
+print('Final surface and silhouette detailing saved')

package/starter/playable/src/models/driver_details.py

@@ -0,0 +1,25 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright 2026 Volter AI, Inc.
+import bpy,math
+from pathlib import Path
+ROOT=str(Path(bpy.data.filepath).resolve().parents[2])
+exec(compile(open(ROOT+'/src/models/scene_helpers.py').read(),'scene_helpers.py','exec'))
+for i in range(6):
+ root=bpy.data.objects['Kart.'+str(i)]
+ if bpy.data.objects.get('K%d steering wheel'%i):continue
+ wheel=torus('K%d steering wheel'%i,(0,.63,1.25),.24,.043,tire,root);wheel.rotation_euler.x=.9
+ rod('K%d steering column'%i,(0,.65,.9),(0,.63,1.25),.045,metal,root)
+ rod('K%d steering spoke'%i,(-.23,.63,1.25),(.23,.63,1.25),.025,metal,root)
+ for x in [-.54,.54]:
+  sphere('K%d headlight housing'%i,(x,1.53,.77),(.26,.17,.18),white,root)
+  sphere('K%d golden headlight'%i,(x,1.66,.77),(.17,.055,.115),yellow,root)
+ sphere('K%d front air intake'%i,(0,1.72,.52),(.34,.04,.09),tire,root)
+ if i in [1,3]:
+  for x in [-.27,.27]:
+   sphere('K%d creature eye'%i,(x,.637,2.2),(.18,.06,.22),white,root)
+   sphere('K%d creature pupil'%i,(x,.693,2.19),(.087,.035,.13),dark,root)
+   sphere('K%d eye sparkle'%i,(x-.025,.721,2.24),(.026,.015,.036),white,root)
+  sphere('K%d creature muzzle'%i,(0,.686,1.92),(.27,.11,.13),mint,root)
+  sphere('K%d creature nose'%i,(0,.783,1.98),(.075,.025,.047),dark,root)
+bpy.ops.wm.save_as_mainfile(filepath=ROOT+'/src/models/canyon.blend')
+print('Steering controls, headlights and original creature faces saved')

package/starter/playable/src/models/environment.py

@@ -0,0 +1,87 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright 2026 Volter AI, Inc.
+# Additive environment milestone; shares helpers from scene_helpers.py.
+import bpy, math, random, datetime
+exec(compile(open(str(__import__('pathlib').Path(bpy.data.filepath).resolve().parent / 'scene_helpers.py')).read(),"scene_helpers.py","exec"))
+random.seed(178)
+for o in list(bpy.data.objects):
+ if o.get('environment_owned'):bpy.data.objects.remove(o,do_unlink=True)
+before=set(bpy.data.objects)
+rocks=[mat('Sandstone band '+str(i),h,.95) for i,h in enumerate(['C8794E','D98654','B9603F','E49C61','BB6548','F3B576','D78457','A95A42'])]
+def mesa(n,x,y,rx,ry,h):
+ count=14; rings=18;v=[]
+ angular=[random.uniform(.85,1.12) for i in range(count)]
+ for j in range(rings):
+  z=h*j/(rings-1);s=1-(j//4)*.12+random.uniform(-.015,.015)
+  for i in range(count):
+   a=i*math.tau/count;v.append((x+rx*s*angular[i]*math.cos(a),y+ry*s*angular[i]*math.sin(a),z))
+ f=[]
+ for j in range(rings-1):
+  for i in range(count):f.append((j*count+i,j*count+(i+1)%count,(j+1)*count+(i+1)%count,(j+1)*count+i))
+ f.append(tuple(range((rings-1)*count,rings*count)));f.append(tuple(reversed(range(count))))
+ d=mesh(n,v,f,rocks[0]);[d.materials.append(m) for m in rocks[1:]]
+ for p in d.polygons:p.material_index=(p.index//count)%len(rocks)
+ return obj(n,d)
+# Main composition: left stepped escarpment and right arch buttress.
+for args in [('West high mesa',-29,28,16,23,29),('West middle mesa',-22,42,12,22,18),('West ledge',-22,12,11,17,9),('Arch east tower',38,49,12,17,24),('East foreground cliff',43,27,15,15,17),('Arch west tower',-12,53,9,11,15),('Distant mesa',36,106,23,18,22),('Far left mesa',-31,102,21,24,25),('Far right mesa',95,85,21,27,30)]:mesa(*args)
+# Uneven, layered voussoirs form a true open arch over the roadway.
+for i in range(14):
+ a=i/14*math.pi;b=(i+1)/14*math.pi
+ inner=20;outer=25+random.uniform(-.5,.7);cx=13;cz=3
+ v=[]
+ for y in [46,55]:
+  for r,t in [(inner,a),(outer,a),(outer,b),(inner,b)]:v.append((cx+r*math.cos(t),y,cz+r*.65*math.sin(t)))
+ d=mesh('Arch stone',v,[(0,3,2,1),(4,5,6,7),(0,1,5,4),(1,2,6,5),(2,3,7,6),(3,0,4,7)],rocks[i%6]);obj('Natural arch span %02d'%i,d)
+# Thin sediment seams across each major mesa, geometry preserves horizontal strata.
+for o in list(bpy.data.objects):
+ if o.type=='MESH' and 'mesa' in o.name.lower() or o.name in ['West ledge','East foreground cliff','Arch east tower','Arch west tower']:
+  if not o.type=='MESH':continue
+  # add subtle surface noise as an image texture via shared materials later
+# Guardrail wraps the outside bend.
+for i in range(80):
+ t=-.28+i*.038;p=sample(t,-12.9);q=sample(t+.038,-12.9)
+ rod('Guardrail beam',(p.x,p.y,.97),(q.x,q.y,.97),.13,metal)
+ rod('Guardrail lower',(p.x,p.y,.73),(q.x,q.y,.73),.08,metal)
+ if i%2==0:box('Rail post',(p.x,p.y,.43),(.18,.2,.86),metal)
+# Arrow panels are front facing and properly lit dot lamps.
+for ix,(x,y,s) in enumerate([(-15,10,1.5),(-14,24,1.35),(-8,38,1.18)]):
+ box('Arrow panel frame '+str(ix),(x,y,4.1*s),(4.7*s,.25,2.5*s),metal)
+ box('Arrow panel face '+str(ix),(x,y-.15,4.1*s),(4.4*s,.07,2.25*s),black)
+ for cx in [-1.4,0,1.4]:
+  for j in range(9):
+   zz=(j-4)*.2;xx=cx+.65-abs(j-4)*.18
+   sphere('Arrow amber lamp',(x+xx*s,y-.22,4.1*s+zz*s),(.075*s,.05,.08*s),lamp)
+ for xx in [-1.65,1.65]:box('Arrow board post',(x+xx*s,y,1.8*s),(.19,.2,3.6*s),metal)
+ pole=rod('Flag pole',(x,y,5.3*s),(x,y,8.4*s),.06,metal)
+ obj('Sunrise racing pennant',mesh('Pennant',[(x,y,8.35*s),(x+1.4*s,y,7.8*s),(x,y,7.45*s)],[(0,1,2),(2,1,0)],green))
+ obj('Flag gold inset',mesh('Pennant gold',[(x+.15*s,y-.01,8.11*s),(x+1.05*s,y-.01,7.81*s),(x+.15*s,y-.01,7.63*s)],[(0,1,2),(2,1,0)],yellow))
+cactus=mat('Saguaro green','529554',.85);rib=mat('Saguaro sunlit ribs','8CAC61',.85);thorn=mat('Cactus gold thorns','D4B66E',.9)
+def cactus_at(x,y,h):
+ sphere('Saguaro trunk',(x,y,h*.5),(.36*h/4,.4*h/4,h*.5),cactus)
+ for j in range(7):
+  a=j*math.tau/7;rod('Cactus rib',(x+math.cos(a)*.33*h/4,y+math.sin(a)*.37*h/4,.3),(x+math.cos(a)*.28*h/4,y+math.sin(a)*.31*h/4,h*.9),.035*h/4,rib)
+ for s,z in [(-1,.48),(1,.66)]:
+  rod('Saguaro arm',(x,y,h*z),(x+s*h*.24,y,h*z),.22*h/4,cactus)
+  sphere('Saguaro arm tip',(x+s*h*.24,y,h*(z+.12)),(.23*h/4,.25*h/4,h*.22),cactus)
+ for i in range(int(h*3)):
+  a=random.random()*math.tau;z=random.uniform(.5,h*.92);sphere('Cactus thorn',(x+math.cos(a)*.39*h/4,y+math.sin(a)*.4*h/4,z),(.035,.035,.06),thorn)
+for x,y,h in [(-19,14,6.8),(-16,23,4.2),(-16,34,3.7),(19,28,4.2),(27,39,6),(31,40,4.8),(-7,48,4),(43,75,6),(78,13,5),(-15,-15,6),(50,-42,5)]:cactus_at(x,y,h)
+# Roadside stones and desert scrub, placed outside the drivable ribbon.
+scrub=mat('Dry agave','8F9453',.95)
+for i in range(90):
+ t=random.random()*8;p=sample(t,random.choice([-1,1])*random.uniform(14,23))
+ if i%4:
+  o=sphere('Tumbled sandstone',(p.x,p.y,.15),(random.uniform(.2,.7),random.uniform(.2,.65),random.uniform(.15,.4)),random.choice(rocks));o.rotation_euler.z=random.random()*6
+ else:
+  for j in range(9):
+   a=j*math.tau/9;b=(p.x,p.y,0);tip=(p.x+math.cos(a)*1.1,p.y+math.sin(a)*1.1,random.uniform(.4,1.5))
+   obj('Agave blade',mesh('Blade',[b,(p.x+.12,p.y+.12,.05),tip],[(0,1,2),(2,1,0)],scrub))
+cloud=mat('Soft cream clouds','FCFCED',1)
+# Puffy distant clouds remain beyond the cliffs, far from casting track shadows.
+for x,y,z,sz in [(-65,165,47,9),(0,175,39,8),(65,170,45,12),(122,155,54,11),(-80,70,50,8)]:
+ for j in range(8):sphere('Cloud puff',(x+random.uniform(-sz,sz),y+random.uniform(-4,4),z+random.uniform(-3,4)),(random.uniform(3,7),4,random.uniform(2,5)),cloud)
+for o in set(bpy.data.objects)-before:o['environment_owned']=True
+# Avoid drawing camera wireframe over the intended shot.
+bpy.data.objects['Chase camera'].hide_set(True)
+bpy.ops.wm.save_as_mainfile(filepath=ROOT+'/src/models/canyon.blend')
+print('Milestone 2: layered canyon, open rock arch, cacti, arrows, guardrails, cloud banks')

package/starter/playable/src/models/finish_scene.py

@@ -0,0 +1,13 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright 2026 Volter AI, Inc.
+import bpy,math,datetime
+from pathlib import Path
+ROOT=str(Path(bpy.data.filepath).resolve().parents[2])
+for name in ['West high mesa','West middle mesa','West ledge','Arch east tower','East foreground cliff','Arch west tower','Distant mesa','Far left mesa','Far right mesa','Natural sandstone arch']:
+ o=bpy.data.objects[name]
+ if not o.get('eroded'):
+  for v in o.data.vertices:
+   v.co.x+=.22*math.sin(v.co.z*1.3+v.co.y*.7);v.co.y+=.16*math.sin(v.co.z*2.1+v.co.x*.5)
+  b=o.modifiers.new('Weathered sandstone edges','BEVEL');b.width=.28;b.segments=3;o['eroded']=True
+bpy.ops.wm.save_as_mainfile(filepath=ROOT+'/src/models/canyon.blend')
+print('Weathered sandstone edges saved')

package/starter/playable/src/models/kart_finish.py

@@ -0,0 +1,31 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright 2026 Volter AI, Inc.
+import bpy,math,bmesh
+from pathlib import Path
+ROOT=str(Path(bpy.data.filepath).resolve().parents[2])
+exec(compile(open(ROOT+'/src/models/scene_helpers.py').read(),'scene_helpers.py','exec'))
+# Reusable rounded rear bumper and flat-tread racing tyre geometry.
+verts=[];profile=[(-.225,.27),(-.225,.39),(-.18,.465),(.18,.465),(.225,.39),(.225,.27)]
+for x,r in profile:
+ for i in range(32):a=i*math.tau/32;verts.append((x,r*math.cos(a),r*math.sin(a)))
+faces=[]
+for j in range(len(profile)):
+ for i in range(32):faces.append((j*32+i,j*32+(i+1)%32,((j+1)%len(profile))*32+(i+1)%32,((j+1)%len(profile))*32+i))
+d=mesh('Rounded racing tire',verts,faces,tire);bm=bmesh.new();bm.from_mesh(d);bmesh.ops.recalc_face_normals(bm,faces=list(bm.faces));bm.to_mesh(d);bm.free()
+for p in d.polygons:p.use_smooth=True
+for i in range(6):
+ root=bpy.data.objects['Kart.'+str(i)]
+ for ob in root.children:
+  if ' tire' in ob.name:ob.data=d;ob.rotation_euler=(0,0,0)
+  if ' bumper' in ob.name and not ob.get('rounded_final'):
+   ob.data=box('Temporary bumper mesh',(0,0,0),(.88,.29,.48),white).data.copy()
+   temp=bpy.data.objects['Temporary bumper mesh'];bpy.data.objects.remove(temp,do_unlink=True)
+   # Box helper stores unit corners; bake its dimensions into the mesh.
+   for v in ob.data.vertices:v.co.x*=.44;v.co.y*=.145;v.co.z*=.24
+   ob.location=(0,-1.47,.48);ob.scale=(1,1,1)
+   m=ob.modifiers.new('Rounded bumper corners','BEVEL');m.width=.11;m.segments=4
+   ob['rounded_final']=True
+ # Tail reflector directly over the chrome pipes.
+ if not bpy.data.objects.get('K%d bumper reflector'%i):box('K%d bumper reflector'%i,(0,-1.622,.59),(.31,.012,.065),red,root)
+bpy.ops.wm.save_as_mainfile(filepath=ROOT+'/src/models/canyon.blend')
+print('Reusable flat-tread tyres and rounded rear bumpers saved')

package/starter/playable/src/models/polish.py

@@ -0,0 +1,75 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright 2026 Volter AI, Inc.
+import bpy,math,random,datetime
+from pathlib import Path
+ROOT=str(Path(bpy.data.filepath).resolve().parents[2])
+exec(compile(open(ROOT+'/src/models/scene_helpers.py').read(),'scene_helpers.py','exec'))
+# More road in the foreground and a distant outside verge, matching the open bend.
+for ob in bpy.data.objects:
+ if ob.type!='MESH':continue
+ if ob.name=='Circuit asphalt':bounds=(-12,12)
+ elif ob.name.startswith('Ivory shoulder'):s=int(ob.name.rsplit(' ',1)[1]);bounds=(s*12,s*12.5)
+ elif ob.name.startswith('Turquoise racing edge'):s=int(ob.name.rsplit(' ',1)[1]);bounds=(s*11.45,s*12)
+ else:continue
+ for i in range(512):
+  t=i*8/512;p=center(t);wide=17*math.exp(-max(0,p.y)/28) if t<2.4 or t>7.3 else 0
+  for j,off in enumerate(bounds):
+   if off<0:off-=wide
+   q=sample(t,off);ob.data.vertices[i*2+j].co.x=q.x;ob.data.vertices[i*2+j].co.y=q.y
+ ob.data.update()
+ if ob.name=='Circuit asphalt':
+  uv=ob.data.uv_layers.active
+  for p in ob.data.polygons:
+   for li in p.loop_indices:
+    v=ob.data.vertices[ob.data.loops[li].vertex_index].co;uv.data[li].uv=(v.x/9,v.y/9)
+for o in bpy.data.objects:
+ if o.name.startswith('Lane dash'):o.location.x-=4
+# Remove nearby rail, leaving the broad distant guardrail seen in the target.
+for ob in list(bpy.data.objects):
+ if ob.name.startswith(('Guardrail','Rail post')):bpy.data.objects.remove(ob,do_unlink=True)
+for i in range(65):
+ if i<23:
+  p=Vector((-58+i*2,24));q=Vector((-56+i*2,24))
+ else:p=sample(.92+(i-23)*.04,-13);q=sample(.92+(i-22)*.04,-13)
+ rod('Guardrail beam',(p.x,p.y,.98),(q.x,q.y,.98),.14,metal)
+ rod('Guardrail lower',(p.x,p.y,.75),(q.x,q.y,.75),.08,metal)
+ if i%2==0:box('Rail post',(p.x,p.y,.43),(.18,.25,.86),metal)
+# Move each complete sign assembly consistently according to original coordinates.
+for ob in bpy.data.objects:
+ if ob.name.startswith(('Arrow','Flag','Sunrise racing pennant')):
+  # Flags store their absolute points in the mesh; all other parts have absolute locations.
+  if ob.name.startswith(('Flag gold','Sunrise')):
+   if ob.type=='MESH':
+    cx=sum(v.co.x for v in ob.data.vertices)/len(ob.data.vertices);cy=sum(v.co.y for v in ob.data.vertices)/len(ob.data.vertices)
+   else:continue
+  else:cx,cy=ob.location.x,ob.location.y
+  idx=min(range(3),key=lambda k:abs(cy-[10,24,38][k]))
+  dx,dy,dz=[(-4,12,2.1),(-3,10,.5),(-1,10,0)][idx]
+  ob.location.x+=dx;ob.location.y+=dy;ob.location.z+=dz
+# The arch opening occupies the right half and leaves a broad cyan sky above it.
+ob=bpy.data.objects['Natural sandstone arch'];ob.location.x+=6;ob.location.y+=9;ob.scale.z=.88
+ob=bpy.data.objects['Arch east tower'];ob.location.x+=4
+ob=bpy.data.objects['Distant mesa'];ob.location.x+=14;ob.scale.z=.8
+# Directional afternoon shadows fall towards the camera's lower left.
+bpy.data.objects['Afternoon sun'].rotation_euler=(-.52,.62,0)
+bpy.data.lights['Afternoon sun'].color=(1,.91,.79)
+bpy.data.lights['Afternoon sun'].energy=3.2
+# Broader rear bodies, fitted lamps, twin chrome pipes and inset mechanical details.
+for i in range(6):
+ rt=bpy.data.objects['Kart.'+str(i)]
+ for ob in list(rt.children):
+  if 'sculpted chassis' in ob.name:ob.scale.x*=1.08;ob.scale.z*=.92
+  if 'red lamp' in ob.name:ob.location.y=-1.37
+  if 'lamp glint' in ob.name:ob.location.y=-1.44
+  if 'white rear pod' in ob.name:ob.location.x*=1.02
+  if 'rear cream stripe' in ob.name:ob.scale.z*=1.2
+ # Decorative engine ventilation and lower diffuser behind the driver.
+ for x in [-.42,-.21,0,.21,.42]:box('K%d rear grille'%i,(x,-1.45,.55),(.11,.02,.08),tire,rt)
+ for x in [-.17,.17]:
+  rod('K%d exhaust tube'%i,(x,-1.4,.34),(x,-1.7,.34),.13,metal,rt)
+# Add small cream cloud banks in the open sky.
+cloud=bpy.data.materials['Soft cream clouds'];random.seed(821)
+for x,y,z,s in [(-6,150,39,8),(40,170,40,12),(62,185,54,8),(-41,170,50,7)]:
+ for j in range(12):sphere('Cloud bank',(x+random.uniform(-s,s),y+random.uniform(-4,4),z+random.uniform(-2,4)),(random.uniform(2,5),3,random.uniform(2,4)),cloud)
+bpy.ops.wm.save_as_mainfile(filepath=ROOT+'/src/models/canyon.blend')
+print('Polished verge, signs, karts, shadows and clouds')

package/starter/playable/src/models/race-state.ts

@@ -0,0 +1,15 @@
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Volter AI, Inc.
+export type RacePhase='ready'|'countdown'|'racing'|'finished';
+export interface Racer {id:number;name:string;x:number;y:number;heading:number;speed:number;progress:number;lap:number;finished:boolean;finishTime:number|null;coins:number;boost:number;parked:boolean;drifting:boolean;offroad:boolean;}
+export interface RaceEvent {time:number;frame:number;kind:string;[key:string]:unknown}
+export interface RaceState {phase:RacePhase;paused:boolean;autoplay:boolean;time:number;frame:number;countdown:number;speed:number;lap:number;coins:number;place:number;boost:number;racers:Racer[];events:RaceEvent[];message:string;}
+export const initialState:RaceState={phase:'ready',paused:false,autoplay:false,time:0,frame:0,countdown:3,speed:0,lap:1,coins:8,place:6,boost:0,racers:[],events:[],message:'CANYON COMET'};
+let state=initialState;const listeners=new Set<()=>void>();
+export const getRaceState=()=>state;
+export const subscribeRaceState=(fn:()=>void)=>{listeners.add(fn);return()=>{listeners.delete(fn)}};
+export const publishRaceState=(s:RaceState)=>{state=s;for(const fn of listeners)fn()};
+export type Command='start'|'auto'|'pause'|'restart'|'boost';
+const commands:Command[]=[];
+export const raceAction=(cmd:Command)=>commands.push(cmd);
+export const consumeCommands=()=>commands.splice(0);

package/starter/playable/src/models/refine.py

@@ -0,0 +1,69 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright 2026 Volter AI, Inc.
+import bpy, math, datetime
+from mathutils import Vector
+from pathlib import Path
+ROOT=str(Path(bpy.data.filepath).resolve().parents[2])
+exec(compile(open(ROOT+'/src/models/scene_helpers.py').read(),'scene_helpers.py','exec'))
+# One world for the camera, neutral diffuse illumination for the scene.
+w=bpy.context.scene.world;ns=w.node_tree.nodes;ls=w.node_tree.links;ns.clear();out=ns.new('ShaderNodeOutputWorld');mix=ns.new('ShaderNodeMixShader');path=ns.new('ShaderNodeLightPath');ambient=ns.new('ShaderNodeBackground');back=ns.new('ShaderNodeBackground');ambient.inputs[0].default_value=(.72,.76,.79,1);ambient.inputs[1].default_value=.8;back.inputs[0].default_value=(.15,.70,.82,1);back.inputs[1].default_value=1
+ls.new(path.outputs['Is Camera Ray'],mix.inputs[0]);ls.new(ambient.outputs[0],mix.inputs[1]);ls.new(back.outputs[0],mix.inputs[2]);ls.new(mix.outputs[0],out.inputs[0])
+bpy.data.lights['Afternoon sun'].energy=3.0
+# Correct signed wrapping of the closed spline at its seam.
+for ob in bpy.data.objects:
+ if ob.type!='MESH':continue
+ if ob.name=='Circuit asphalt':bounds=(-12,12)
+ elif ob.name.startswith('Ivory shoulder'):s=int(ob.name.rsplit(' ',1)[1]);bounds=(s*12,s*12.5)
+ elif ob.name.startswith('Turquoise racing edge'):s=int(ob.name.rsplit(' ',1)[1]);bounds=(s*11.45,s*12)
+ else:continue
+ for i in range(512):
+  for j,off in enumerate(bounds):
+   p=sample(i*8/512,off);ob.data.vertices[i*2+j].co.x=p.x;ob.data.vertices[i*2+j].co.y=p.y
+ ob.data.update()
+# Photo-like micrograin with UVs in metres, never screen-space decoration.
+def texture(m,file):
+ # The textures stay files in src/textures/, referenced relative to the .blend rather than packed.
+ im=bpy.data.images.load(ROOT+'/src/textures/'+file,check_existing=True);im.filepath='//../textures/'+file;im.colorspace_settings.name='sRGB'
+ n=m.node_tree.nodes.new('ShaderNodeTexImage');n.image=im;m.node_tree.links.new(n.outputs['Color'],m.node_tree.nodes.get('Principled BSDF').inputs['Base Color'])
+ return n
+texture(bpy.data.materials['Granular warm asphalt'],'asphalt.png')
+o=bpy.data.objects['Circuit asphalt'];uv=o.data.uv_layers.new(name='Metre UV')
+for poly in o.data.polygons:
+ for li in poly.loop_indices:
+  v=o.data.vertices[o.data.loops[li].vertex_index].co;uv.data[li].uv=(v.x/5,v.y/5)
+rock=mat('Continuous sandstone strata','D58454',.95);texture(rock,'sandstone.png')
+rocknames=['West high mesa','West middle mesa','West ledge','Arch east tower','East foreground cliff','Arch west tower','Distant mesa','Far left mesa','Far right mesa']
+for name in rocknames:
+ ob=bpy.data.objects[name];ob.data.materials.clear();ob.data.materials.append(rock)
+ for p in ob.data.polygons:p.material_index=0
+ uv=ob.data.uv_layers.new(name='Sandstone strata')
+ for p in ob.data.polygons:
+  for li in p.loop_indices:
+   v=ob.data.vertices[ob.data.loops[li].vertex_index].co;uv.data[li].uv=((v.x+v.y*.61)/18,v.z/9)
+for name,dx,dy,sz in [('West ledge',-12,6,.6),('West middle mesa',-9,8,1),('West high mesa',-11,8,1),('Arch west tower',-5,0,1)]:
+ ob=bpy.data.objects[name];ob.location.x+=dx;ob.location.y+=dy;ob.scale.z=sz
+# A continuous naturally uneven arch, with no radial masonry pattern.
+for ob in list(bpy.data.objects):
+ if ob.name.startswith('Natural arch span'):bpy.data.objects.remove(ob,do_unlink=True)
+v=[];N=48
+for i in range(N+1):
+ a=i*math.pi/N;outer=28+math.sin(i*1.7)*.7;inner=20+math.sin(i*2.3)*.35
+ for y,r in [(46,inner),(46,outer),(55,outer),(55,inner)]:v.append((13+r*math.cos(a),y,3+r*.65*math.sin(a)))
+f=[]
+for i in range(N):
+ for j in range(4):f.append((i*4+j,i*4+(j+1)%4,(i+1)*4+(j+1)%4,(i+1)*4+j))
+f+=[(3,2,1,0),(N*4,N*4+1,N*4+2,N*4+3)]
+d=mesh('Eroded arch strata',v,f,rock);o=obj('Natural sandstone arch',d);o['environment_owned']=True
+uv=d.uv_layers.new(name='Arch strata')
+for p in d.polygons:
+ for li in p.loop_indices:
+  a=d.vertices[d.loops[li].vertex_index].co;uv.data[li].uv=((a.x+a.y*.61)/18,a.z/9)
+# Rear three-quarter silhouettes aligned to reference landmarks.
+bpy.data.objects['Kart.1'].location=(-6.2,2.7,0)
+bpy.data.objects['Kart.2'].location=(4.8,6,0)
+bpy.data.objects['Kart.3'].location=(-1.5,24,0)
+bpy.data.objects['Kart.4'].location=(1,31,0)
+bpy.data.objects['Kart.5'].location=(7,41,0)
+cam=bpy.data.objects['Chase camera'];cam.location=(0,-10.7,4.7);cam.rotation_euler=(Vector((0,18,.05))-cam.location).to_track_quat('-Z','Y').to_euler();cam.data.lens=23.25
+bpy.ops.wm.save_as_mainfile(filepath=ROOT+'/src/models/canyon.blend')
+print('Refined textures, neutral fill, arch, seam and chase framing')

package/starter/playable/src/models/scene_helpers.py

@@ -0,0 +1,54 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+# Copyright 2026 Volter AI, Inc.
+# Shared by the milestone scripts after circuit.py: materials, mesh helpers and the circuit spline.
+import bpy, math, random
+from mathutils import Vector
+from pathlib import Path
+ROOT=str(Path(bpy.data.filepath).resolve().parents[2])
+col=bpy.data.collections["Canyon Comet"]
+def own(o): o['canyon_owned']=True; col.objects.link(o); return o
+def lin(c): return c/12.92 if c<.04045 else ((c+.055)/1.055)**2.4
+def mat(n,h,rough=.55,metal=0):
+ m=bpy.data.materials.get(n) or bpy.data.materials.new(n); m.use_nodes=True
+ rgb=[lin(int(h[i:i+2],16)/255) for i in (0,2,4)]; m.diffuse_color=(*rgb,1)
+ p=m.node_tree.nodes.get('Principled BSDF'); p.inputs['Base Color'].default_value=(*rgb,1); p.inputs['Roughness'].default_value=rough;p.inputs['Metallic'].default_value=metal
+ return m
+sand=mat('Warm peach sand','EBA76B'); road=mat('Granular warm asphalt','777970',.98); white=mat('Ivory enamel','EDF1E7',.28); teal=mat('Lagoon turquoise','13C8CF',.25,.15); yellow=mat('Golden yellow','F5C62B',.3); purple=mat('Violet racer','773FDC',.28); green=mat('Apple racer','59BC37',.28); blue=mat('Sky racer','319BBE',.27); coral=mat('Coral racer','F05C33',.3); tire=mat('Graphite rubber','202A29',.9); metal=mat('Brushed aluminum','A3AFAA',.3,.55); dark=mat('Ink blue helmet','203D58',.28); red=mat('Ruby tail lamps','BA291D',.22); orange=mat('Tangerine trim','F68B25',.3); mint=mat('Mint creature','38CCAC',.4); edge=mat('Mint track paint','5AF1B9',.8); black=mat('Sign charcoal','343B32',.8); lamp=mat('Amber lamps','FFF399',.4)
+lamp.node_tree.nodes.get('Principled BSDF').inputs['Emission Color'].default_value=(1,.72,.15,1);lamp.node_tree.nodes.get('Principled BSDF').inputs['Emission Strength'].default_value=1.2
+cache={}
+def mesh(n,v,f,m):
+ d=bpy.data.meshes.new(n);d.from_pydata(v,[],f);d.materials.append(m);d.update();return d
+def obj(n,d,loc=(0,0,0),scale=(1,1,1),parent=None):
+ o=own(bpy.data.objects.new(n,d));o.location=loc;o.scale=scale;o.parent=parent;return o
+def sphere(n,loc,scale,m,parent=None):
+ key=('sphere',m.name)
+ if key not in cache:
+  v=[(math.sin(math.pi*j/16)*math.cos(2*math.pi*i/28),math.sin(math.pi*j/16)*math.sin(2*math.pi*i/28),math.cos(math.pi*j/16)) for j in range(17) for i in range(28)]
+  f=[(j*28+i,j*28+(i+1)%28,(j+1)*28+(i+1)%28,(j+1)*28+i) for j in range(16) for i in range(28)]
+  # Sphere param runs north to south, winding outward.
+  d=mesh('Smooth '+m.name,v,[tuple(reversed(a)) for a in f],m)
+  for p in d.polygons:p.use_smooth=True
+  cache[key]=d
+ return obj(n,cache[key],loc,scale,parent)
+def box(n,loc,s,m,parent=None):
+ key=('box',m.name)
+ if key not in cache:
+  v=[(-1,-1,-1),(1,-1,-1),(1,1,-1),(-1,1,-1),(-1,-1,1),(1,-1,1),(1,1,1),(-1,1,1)]
+  cache[key]=mesh(m.name+' block',v,[(0,3,2,1),(0,1,5,4),(1,2,6,5),(2,3,7,6),(3,0,4,7),(4,5,6,7)],m)
+ return obj(n,cache[key],loc,tuple(a/2 for a in s),parent)
+def rod(n,a,b,r,m,parent=None):
+ mid=(Vector(a)+Vector(b))/2;o=sphere(n,mid,(r,r,(Vector(b)-Vector(a)).length/2+r),m,parent);o.rotation_euler=(Vector(b)-Vector(a)).to_track_quat('Z','Y').to_euler();return o
+def torus(n,loc,R,r,m,parent=None):
+ key=('torus',R,r,m.name)
+ if key not in cache:
+  v=[((R+r*math.cos(j*math.tau/12))*math.cos(i*math.tau/28),(R+r*math.cos(j*math.tau/12))*math.sin(i*math.tau/28),r*math.sin(j*math.tau/12)) for i in range(28) for j in range(12)]
+  f=[(i*12+j,((i+1)%28)*12+j,((i+1)%28)*12+(j+1)%12,i*12+(j+1)%12) for i in range(28) for j in range(12)]
+  d=mesh(n,v,f,m)
+  for p in d.polygons:p.use_smooth=True
+  cache[key]=d
+ return obj(n,cache[key],loc,parent=parent)
+POINTS=[(0,0),(0,25),(12,55),(42,70),(68,45),(65,5),(40,-25),(8,-25)]
+def center(t):
+ k=math.floor(t)%8;u=t%1;p0=Vector(POINTS[(k-1)%8]);p1=Vector(POINTS[k]);p2=Vector(POINTS[(k+1)%8]);p3=Vector(POINTS[(k+2)%8]);return .5*((2*p1)+(-p0+p2)*u+(2*p0-5*p1+4*p2-p3)*u*u+(-p0+3*p1-3*p2+p3)*u*u*u)
+def sample(t,offset=0):
+ p=center(t);d=(center(t+.001)-center(t-.001)).normalized();return p+Vector((d.y,-d.x))*offset