@volter/cyclotron 0.5.211 → 0.5.213

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

@@ -1,75 +0,0 @@
-# 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

@@ -1,15 +0,0 @@
-// 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

@@ -1,69 +0,0 @@
-# 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

@@ -1,54 +0,0 @@
-# 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

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

@@ -1,114 +0,0 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-# Copyright 2026 Volter AI, Inc.
-# Last step of canyon.py: ambient occlusion baked into the static scenery, for depth.
-#
-# Each receiver's vertices get a `scenery_ao` colour attribute: the share of a
-# cosine-weighted hemisphere of rays that reach open sky within AO_DISTANCE, a
-# hit nearer counting more. Its materials multiply Base Color by it. Nothing that
-# moves is baked or casts into the bake: the karts and their drivers (and the
-# coins and boost flames canyon.play.ts adds) are excluded, so the start grid
-# carries no baked kart shadow. A material a kart shares is copied for the
-# scenery, so no kart reads an attribute it lacks. Props (cacti, guardrails,
-# signs, stones) occlude but are not baked themselves: they share instanced
-# meshes, and baking them would need a copy of each. The three low shelves are
-# left out too: eight-vertex boxes half inside the mesas, too coarse to shade.
-# The desert floor's top face is split into a grid first, so it has vertices
-# to carry the bake.
-#
-# Pure Python against mathutils' BVH, with fixed ray directions: the same file
-# gives the same bake in native Blender and in the editor's.
-import bpy, bmesh, math
-from mathutils import Vector
-from mathutils.bvhtree import BVHTree
-from pathlib import Path
-ROOT=str(Path(bpy.data.filepath).resolve().parents[2])
-ATTRIBUTE='scenery_ao'
-AO_DISTANCE=20.0      # metres; a hit at distance d occludes by 1 - d/AO_DISTANCE
-RAYS=64
-DARKEST=0.35
-FLOOR_CELL=4.0        # metres between the desert floor's vertices
-GROUND=('Desert floor','Circuit asphalt','Ivory shoulder','Turquoise racing edge','Lane dash','Finish line tile')
-RECEIVERS=('Desert floor','Circuit asphalt','Ivory shoulder','Turquoise racing edge','Natural sandstone arch',
-           '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','Return canyon mesa')
-NOT_OCCLUDERS=('Cloud','Return cloud puff','Cactus thorn','Cactus rib','Arrow amber lamp')
-
-col=bpy.data.collections['Canyon Comet']
-def moving(o):
-    while o is not None:
-        if o.name.startswith('Kart.'):return True
-        o=o.parent
-    return False
-scenery=[o for o in col.all_objects if o.type=='MESH' and not moving(o)]
-receivers=[o for o in scenery if o.name.startswith(RECEIVERS)]
-ground=[o for o in scenery if o.name.startswith(GROUND)]
-
-# The floor is one 8-vertex box: give its top face a grid the bake can shade.
-floor=bpy.data.objects['Desert floor']
-if len(floor.data.vertices)<100:
-    if floor.data.users>1:floor.data=floor.data.copy()
-    bm=bmesh.new();bm.from_mesh(floor.data);bm.faces.ensure_lookup_table()
-    top=max(bm.faces,key=lambda f:f.normal.z)
-    cuts=max(1,round(floor.dimensions.x/FLOOR_CELL)-1)
-    bmesh.ops.subdivide_edges(bm,edges=list(top.edges),cuts=cuts,use_grid_fill=True)
-    bm.to_mesh(floor.data);bm.free();floor.data.update()
-# A receiver needs its own vertices for its own colours.
-for o in receivers:
-    if o.data.users>1:o.data=o.data.copy()
-
-def triangles(objects):
-    depsgraph=bpy.context.evaluated_depsgraph_get();verts=[];tris=[]
-    for o in objects:
-        ev=o.evaluated_get(depsgraph);mesh=ev.to_mesh();mesh.calc_loop_triangles();m=ev.matrix_world;base=len(verts)
-        verts.extend(m@v.co for v in mesh.vertices);tris.extend(tuple(base+i for i in t.vertices) for t in mesh.loop_triangles)
-        ev.to_mesh_clear()
-    return BVHTree.FromPolygons(verts,tris)
-occluders=[o for o in scenery if not o.name.startswith(NOT_OCCLUDERS)]
-everything=triangles(occluders)
-# Ground layers lie on one another: a ground receiver ignores them, or each would shade the next.
-raised=triangles([o for o in occluders if o not in ground])
-
-golden=math.pi*(3-math.sqrt(5))
-hemisphere=[(math.sqrt((i+.5)/RAYS)*math.cos(i*golden),math.sqrt((i+.5)/RAYS)*math.sin(i*golden),math.sqrt(1-(i+.5)/RAYS)) for i in range(RAYS)]
-def openness(tree,p,n):
-    t=(n.cross(Vector((0,0,1))) if abs(n.z)<.9 else n.cross(Vector((1,0,0)))).normalized();b=n.cross(t);origin=p+n*.03;hidden=0.0
-    for x,y,z in hemisphere:
-        hit=tree.ray_cast(origin,t*x+b*y+n*z,AO_DISTANCE)[0]
-        if hit is not None:hidden+=1-(hit-origin).length/AO_DISTANCE
-    return max(DARKEST,1-hidden/RAYS)
-
-report={}
-for o in receivers:
-    tree=raised if o in ground else everything;m=o.matrix_world;nm=m.to_3x3().inverted_safe().transposed();mesh=o.data
-    if ATTRIBUTE in mesh.color_attributes:mesh.color_attributes.remove(mesh.color_attributes[ATTRIBUTE])
-    layer=mesh.color_attributes.new(ATTRIBUTE,'FLOAT_COLOR','POINT');values=[]
-    for v in mesh.vertices:
-        n=(nm@v.normal).normalized()
-        # Half the track ribbons wind downward; a ground layer always faces the sky.
-        if o in ground and n.z<0:n=-n
-        a=openness(tree,m@v.co,n);values.append(a);layer.data[v.index].color=(a,a,a,1)
-    report[o.name]=(len(values),round(sum(values)/len(values),3),round(min(values),3))
-
-# Multiply each receiver material's Base Color by the attribute; a material anything else also wears is copied.
-receiving=set(receivers);copies={}
-for o in receivers:
-    for slot in o.material_slots:
-        material=slot.material
-        if material is None:continue
-        shared=any(other not in receiving for other in bpy.data.objects if other.type=='MESH' and any(s.material==material for s in other.material_slots))
-        if shared:
-            if material.name not in copies:copies[material.name]=bpy.data.materials.get(material.name+' (scenery AO)') or material.copy()
-            copies[material.name].name=material.name+' (scenery AO)';slot.material=copies[material.name];material=copies[material.name]
-        nodes=material.node_tree.nodes;links=material.node_tree.links;bsdf=nodes.get('Principled BSDF')
-        if nodes.get('Scenery AO') is not None:continue
-        ao=nodes.new('ShaderNodeVertexColor');ao.name=ao.label='Scenery AO';ao.layer_name=ATTRIBUTE;ao.location=(bsdf.location.x-520,bsdf.location.y-260)
-        mix=nodes.new('ShaderNodeMix');mix.name=mix.label='Scenery AO multiply';mix.data_type='RGBA';mix.blend_type='MULTIPLY';mix.location=(bsdf.location.x-260,bsdf.location.y-120)
-        mix.inputs['Factor'].default_value=1.0;base=bsdf.inputs['Base Color']
-        if base.is_linked:
-            source=base.links[0].from_socket;links.remove(base.links[0]);links.new(source,mix.inputs[6])
-        else:mix.inputs[6].default_value=base.default_value
-        links.new(ao.outputs['Color'],mix.inputs[7]);links.new(mix.outputs[2],base)
-for name,(count,mean,low) in sorted(report.items()):print('scenery AO',name,count,'vertices, mean',mean,'darkest',low)
-print('scenery AO materials copied for the scenery:',sorted(copies))
-bpy.ops.wm.save_as_mainfile(filepath=ROOT+'/src/models/canyon.blend')
-print('Ambient occlusion baked into',len(receivers),'static scenery meshes')

package/starter/playable/src/textures/generate.py

@@ -1,16 +0,0 @@
-# SPDX-License-Identifier: MIT
-# Copyright 2026 Volter AI, Inc.
-# Deterministic procedural surface textures; no reference pixels are used.
-import numpy as np
-from PIL import Image, ImageFilter
-from pathlib import Path
-rng=np.random.default_rng(19);root=Path(__file__).parent
-N=1024
-def noise(size,w,h):
- a=rng.random((h,w)).astype('float32');im=Image.fromarray((a*255).astype('uint8')).resize((size,size),Image.Resampling.BICUBIC);return np.asarray(im)/255-.5
-n=noise(N,256,256)*.20+noise(N,650,650)*.19+noise(N,30,30)*.06
-base=np.array([104,104,96]);out=np.clip(base+n[:,:,None]*255,0,255).astype('uint8');Image.fromarray(out).save(root/'asphalt.png')
-y=np.arange(N)[:,None];x=np.arange(N)[None,:];warp=np.sin(x*.009)*3+np.sin(x*.032)*1.2
-bands=np.sin((y+warp)*.075)*.05+np.sin((y+warp)*.28)*.035+np.sin((y+warp)*1.1)*.02
-n=noise(N,20,90)*.16+noise(N,150,500)*.11+bands
-base=np.array([211,124,79]);out=np.clip(base+n[:,:,None]*np.array([220,180,120]),0,255).astype('uint8');Image.fromarray(out).save(root/'sandstone.png')

package/starter/playable/src/ui/game.stories.tsx

@@ -1,16 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright 2026 Volter AI, Inc.
-import React, { useState } from 'react';
-import GameUI from './game';
-import { RaceHud } from './race-hud';
-import { RaceButton, RaceCounters, RaceMenu, BoostMeter } from './race-widgets';
-import { initialState, type RaceState } from '../models/race-state';
-const racing = { ...initialState, phase: 'racing' as const, speed: 26, time: 38.2, lap: 2, place: 3, coins: 12 };
-function Preview(args: RaceState) { const [state, set] = useState(args); return <RaceHud {...state} onAction={cmd => set(old => cmd === 'auto' ? { ...old, autoplay: !old.autoplay } : cmd === 'pause' ? { ...old, paused: !old.paused } : cmd === 'start' ? { ...old, phase: 'racing' } : cmd === 'restart' ? { ...initialState } : old)}/>; }
-const background = { width: '100%', height: '100%', background: 'radial-gradient(ellipse at top,#496b6a,#253a3c)', position: 'relative' as const, overflow: 'hidden' };
-function Buttons() { const [boost, set] = useState(false); return <div style={{ ...background, display: 'flex', flexDirection: 'column', alignItems: 'center', justifyContent: 'center', gap: 25 }}><RaceButton onClick={() => set(!boost)}>{boost ? 'BOOST!' : 'LET’S RACE'}</RaceButton><RaceButton secondary>CHANGE KART</RaceButton><RaceButton disabled>LOCKED</RaceButton></div>; }
-export default { title: 'Canyon Comet/Game interface', component: GameUI, render: (args: RaceState) => <div style={background}><Preview {...args}/></div>, parameters: { layout: 'fullscreen', viewport: { options: { game: { name: 'Game UI', styles: { width: '640px', height: '360px' } } } }, volter: { defaultStory: 'Race HUD' } }, globals: { viewport: { value: 'game' } }, args: racing };
-export const RaceHUD = { name: 'Race HUD', parameters: { volter: { default: true } } };
-export const PauseMenu = { name: 'Pause menu', render: () => { const [paused, set] = useState(true); return <div style={{ ...background, display: 'grid', placeItems: 'center' }}>{paused ? <RaceMenu state={{ ...racing, paused: true }} onAction={() => set(false)}/> : <RaceButton onClick={() => set(true)}>PAUSE</RaceButton>}</div>; } };
-export const Counters = { name: 'Coins · laps · boost', render: () => <div style={{ ...background, display: 'flex', flexDirection: 'column', alignItems: 'center', justifyContent: 'center', gap: 40 }}><RaceCounters coins={12} lap={2} place={3}/><BoostMeter value={5}/><BoostMeter value={8}/></div> };
-export const ButtonsStates = { name: 'Button states', render: () => <Buttons /> };

package/starter/playable/src/ui/game.tsx

@@ -1,6 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright 2026 Volter AI, Inc.
-import {useSyncExternalStore} from 'react';
-import {getRaceState,subscribeRaceState} from '../models/race-state';
-import {RaceHud} from './race-hud';
-export default function GameUI(){const state=useSyncExternalStore(subscribeRaceState,getRaceState,getRaceState);return <RaceHud {...state}/>}

package/starter/playable/src/ui/race-hud.tsx

@@ -1,29 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright 2026 Volter AI, Inc.
-import React from 'react';
-import { RaceCounters, RaceControls, RaceMenu, BoostMeter } from './race-widgets';
-import { course, at, length } from '../models/course';
-import { raceAction, type Command, type RaceState } from '../models/race-state';
-export function RaceHud(s: RaceState & {
-    onAction?: (cmd: Command) => void;
-}) {
-    const act = s.onAction ?? raceAction;
-    const raceTime = s.racers[0]?.finishTime ?? s.time;
-    const mp = (x: number, y: number) => ({ x: 23 + (x + 3) * 1.95, y: 40 + (72 - y) * 4.8 });
-    const route = course.filter((_, i) => i % 8 === 0).map((p, i) => { const v = mp(p.x, p.y); return `${i ? 'L' : 'M'}${v.x} ${v.y}`; }).join(' ') + ' Z';
-    return <div data-testid="race-hud" style={{ position: 'absolute', inset: 0, fontFamily: 'Arial, sans-serif', lineHeight: 1.1, color: 'white', pointerEvents: 'none', containerType: 'size' }}>
- <div style={{ position: 'absolute', left: '2.4%', bottom: '5%', transform: 'scale(.65)', transformOrigin: 'left bottom' }}><RaceCounters coins={s.coins} lap={s.lap} place={s.place}/></div>
- <svg viewBox="0 0 200 580" style={{ position: 'absolute', right: '3.2%', top: '9%', height: '65%', width: '13%', overflow: 'visible' }} aria-label="Circuit map">
- <path d={route} fill="none" stroke="#ffffffe0" strokeWidth="8" strokeLinecap="round" strokeLinejoin="round"/>
- {(s.racers.length ? s.racers : [{ id: 0, progress: 0 }]).map(r => { const p = at(r.progress * length), v = mp(p.x, p.y); return <g key={r.id}><circle cx={v.x} cy={v.y} r={r.id === 0 ? 15 : 7} fill={['#f58a31', '#efc629', '#824fe4', '#64c33c', '#319bbe', '#e85d3a'][r.id]} stroke={r.id === 0 ? '#ffffff' : '#283e44'} strokeWidth={r.id === 0 ? 5 : 2}/>{r.id === 0 && <circle cx={v.x} cy={v.y} r="19" fill="none" stroke="#263d46" strokeWidth="2"/>}</g>; })}
- </svg>
- <div style={{ position: 'absolute', left: '2.6%', top: '2.7%', fontWeight: 900, letterSpacing: 2, fontSize: 'clamp(11px,1.15cqw,18px)', textShadow: '0 2px 4px #243537' }}>{s.phase === 'ready' ? 'CANYON COMET' : `${s.place} / 6  ·  ${Math.floor(raceTime / 60)}:${(raceTime % 60).toFixed(1).padStart(4, '0')}`}</div>
- <div style={{ position: 'absolute', right: '2.5%', bottom: '3.4%' }}><RaceControls state={s} onAction={act}/></div>
- <div style={{ position: 'absolute', left: '50%', bottom: '1%', transform: 'translateX(-50%)', font: '600 10px system-ui', textShadow: '0 1px 3px black', opacity: .88, whiteSpace: 'nowrap' }}>↑ W accelerate · ↓ S brake / reverse · ← → A D steer · Space drift · Shift boost · O auto</div>
- {(s.paused || s.phase === 'finished') && <div style={{ position: 'absolute', inset: 0, display: 'grid', placeItems: 'center', background: '#253a3cbb' }}><RaceMenu state={s} onAction={act}/></div>}
- {s.phase === 'countdown' && <div style={{ position: 'absolute', left: '50%', top: '38%', fontSize: '9cqw', fontWeight: 900, color: '#ffc92e' }}>{Math.ceil(s.countdown)}</div>}
- <div style={{ position: 'absolute', left: '2.5%', top: '13%', transform: 'scale(.65)', transformOrigin: 'left top' }}><BoostMeter value={s.boost > 0 ? 8 : 5}/></div>
- {s.boost > 0 && <div style={{ position: 'absolute', left: '45%', top: '13%', fontSize: '2cqw', fontWeight: 900, color: '#ffe77c' }}>BOOST</div>}
- <output data-testid="race-state" style={{ display: 'none' }}>{JSON.stringify(s)}</output>
- </div>;
-}

package/starter/playable/src/ui/race-widgets.tsx

@@ -1,29 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright 2026 Volter AI, Inc.
-import React from 'react';
-import type { Command, RaceState } from '../models/race-state';
-import { raceAction } from '../models/race-state';
-const ink = '#253a3c', gold = '#ffc92e';
-const type = { fontFamily: 'Arial, sans-serif', fontWeight: 900, fontStyle: 'italic' } as const;
-export function RaceButton({ children, onClick, secondary = false, disabled = false }: {
-    children: React.ReactNode;
-    onClick?: () => void;
-    secondary?: boolean;
-    disabled?: boolean;
-}) { return <button disabled={disabled} onClick={onClick} style={{ ...type, fontSize: 20, letterSpacing: '.01em', padding: '12px 25px', border: `3px solid ${ink}`, borderRadius: 15, color: secondary ? 'white' : ink, background: secondary ? ink : gold, boxShadow: `inset 0 3px 0 ${secondary ? '#ffffff38' : '#fff4b7'},0 4px 0 ${ink}`, transform: 'skew(-5deg)', cursor: disabled ? 'default' : 'pointer', opacity: disabled ? .4 : 1 }}>{children}</button>; }
-export function RaceCounters({ coins, lap, place }: {
-    coins: number;
-    lap: number;
-    place: number;
-}) { return <div style={{ ...type, display: 'flex', gap: 12, alignItems: 'center', color: 'white', fontSize: 36, textShadow: `0 3px 0 ${ink}` }}><span style={{ display: 'flex', alignItems: 'center', gap: 12, padding: '8px 16px', background: ink, borderRadius: 18, border: '3px solid #ffffff65' }}><b style={{ display: 'grid', placeItems: 'center', width: 31, height: 37, background: gold, borderRadius: '50%', color: '#ef9500', border: '3px solid #ffe77c', boxShadow: '0 0 0 2px #af6900', fontStyle: 'normal', fontSize: 24 }}>Ⅰ</b>{String(coins).padStart(2, '0')}</span><span style={{ padding: '8px 16px', background: ink, borderRadius: 18, border: '3px solid #ffffff65' }}><small style={{ fontSize: 13, verticalAlign: 'middle', marginRight: 8 }}>LAP</small>{lap}<small style={{ fontSize: 20 }}>/3</small></span><span style={{ fontSize: 64, color: gold, WebkitTextStroke: `2px ${ink}`, paintOrder: 'stroke fill' }}>{place}<sup style={{ fontSize: 20 }}>{place === 1 ? "ST" : place === 2 ? "ND" : place === 3 ? "RD" : "TH"}</sup></span></div>; }
-export function BoostMeter({ value = 5 }: {
-    value?: number;
-}) { return <div style={{ ...type, display: 'flex', gap: 13, alignItems: 'center', color: 'white', fontSize: 18, textShadow: `0 2px 0 ${ink}` }}><span>BOOST</span><div style={{ display: 'flex', gap: 4, background: ink, padding: 7, border: '2px solid #ffffff65', borderRadius: 8, transform: 'skew(-12deg)' }}>{Array.from({ length: 8 }, (_, i) => <span key={i} style={{ width: 20, height: 22, background: i < value ? gold : '#ffffff38', borderTop: '2px solid #ffffff38' }}/>)}</div></div>; }
-export function RaceMenu({ state, onAction = raceAction }: {
-    state: RaceState;
-    onAction?: (cmd: Command) => void;
-}) { const finished = state.phase === 'finished'; return <div style={{ ...type, display: 'flex', alignItems: 'center', flexDirection: 'column', gap: 20, color: 'white', pointerEvents: 'auto', textAlign: 'center' }}><strong style={{ fontSize: 55, lineHeight: 1, color: gold, WebkitTextStroke: `2px ${ink}`, paintOrder: 'stroke fill', textShadow: `0 5px 0 ${ink}` }}>{finished ? 'RACE COMPLETE!' : 'PAUSED'}</strong><span style={{ fontSize: 17, letterSpacing: 2, textShadow: `0 2px 0 ${ink}` }}>CANYON COMET · LAP {state.lap} / 3</span>{finished && <span style={{ fontSize: 22 }}>POSITION {state.place} / 6 · {state.time.toFixed(1)}s</span>}<RaceButton onClick={() => onAction(finished ? 'restart' : 'pause')}>{finished ? 'RACE AGAIN' : 'KEEP RACING'}</RaceButton><RaceButton secondary onClick={() => onAction('restart')}>RESTART RACE</RaceButton></div>; }
-export function RaceControls({ state, onAction = raceAction }: {
-    state: RaceState;
-    onAction?: (cmd: Command) => void;
-}) { return <div style={{ display: 'flex', gap: 12, alignItems: 'center', pointerEvents: 'auto', transformOrigin: 'right bottom', transform: 'scale(.7)' }}>{state.phase === 'ready' && <RaceButton onClick={() => onAction('start')}>RACE!</RaceButton>}<RaceButton secondary onClick={() => onAction('auto')}>{state.autoplay ? 'AUTO ON' : 'AUTO'}</RaceButton><RaceButton secondary onClick={() => onAction('pause')}>{state.paused ? 'RESUME' : 'PAUSE'}</RaceButton><RaceButton secondary onClick={() => onAction('restart')}>RESTART</RaceButton></div>; }