@volter/cyclotron 0.5.211 → 0.5.213

package/starter/playable/src/models/canyon.play.ts

@@ -1,107 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright 2026 Volter AI, Inc.
-import * as THREE from 'three';
-import type {ModelPlayContext} from '@volter/play/play-script';
-import {initialState,publishRaceState,consumeCommands,type Racer,type RaceState,type RaceEvent,type Command} from './race-state';
-import {at,nearest,length,wrap,angle,leftWidth} from './course';
-type Car=Racer & {object:THREE.Object3D;s:number;distance:number;checkpoint:number;lane:number;parked:boolean;boostCooldown:number;drift:number;drifting:boolean;offroad:boolean;collisionCooldown:number;lastDecision:number};
-type Inputs={throttle:number;brake:boolean;steer:number;drift:boolean;boost:boolean};
-export default function play(ctx:ModelPlayContext){
- const initialPositions=[[0,0],[-6.2,2.7],[4.8,6],[-1.5,24],[1,31],[7,41]];
- const names=['Pip','Miso','Nova','Sprig','Mica','Rook'];
- let state:RaceState={...initialState,events:[],racers:[]};let events:RaceEvent[]=[];let simTime=0,frame=0,clock=0,accumulator=0,previousKeys=new Set<string>(),endTime:number|null=null;let lastManual='';
- // Each race event is kept for the HUD's race state and written to the editor's play log (`cyclotron play-log`).
- const log=(kind:string,detail:Record<string,unknown>={})=>{events.push({time:+simTime.toFixed(3),frame,kind,...detail});if(events.length>1200)events.shift();ctx.log(kind,detail)};
- const cars:Car[]=initialPositions.map(([x,y],id)=>{const object=ctx.find('Kart.'+id);if(!object)throw new Error('Missing authored Kart.'+id);const n=nearest(x,y);return {id,name:names[id],object,x,y,s:n.s,distance:n.s,heading:0,speed:0,progress:n.s/length,lap:1,finished:false,finishTime:null,coins:id===0?8:4,boost:0,checkpoint:1,lane:[0,-4.6,4.6,-2.2,1.8,3.7][id],parked:false,boostCooldown:0,drift:0,drifting:false,offroad:false,collisionCooldown:0,lastDecision:-1}});
- ctx.root.traverse((o:any)=>{if(o.isDirectionalLight){o.shadow.mapSize.set(4096,4096);o.shadow.map?.dispose();o.shadow.map=null}});
- const pickups=new THREE.Group();pickups.name='Race coin pickups';ctx.root.add(pickups);
- const coinMaterial=new THREE.MeshStandardMaterial({color:0xffbe18,metalness:.55,roughness:.25});
- const coinGeometry=new THREE.TorusGeometry(.34,.1,8,20);
- const coins=Array.from({length:24},(_,i)=>{const s=(.25+Math.floor(i/3)*.086)*length, lane=[-4,0,4][i%3],p=at(s,lane);const mesh=new THREE.Mesh(coinGeometry,coinMaterial);mesh.name='Coin.'+i;mesh.position.set(p.x,p.y,.95);mesh.rotation.x=Math.PI/2;mesh.castShadow=true;pickups.add(mesh);return {mesh,x:p.x,y:p.y,ready:0,id:i}});
- const sparks=new THREE.Group();sparks.name='Boost exhaust';ctx.root.add(sparks);const flameMat=new THREE.MeshBasicMaterial({color:0x47e5ff,transparent:true,opacity:.7});const flameGeo=new THREE.ConeGeometry(.18,.8,8);const flames=cars.map(()=>{const a=new THREE.Mesh(flameGeo,flameMat);a.rotation.x=Math.PI/2;sparks.add(a);return a});
- const reset=(start=false)=>{const auto=state.autoplay;events=[];simTime=frame=clock=accumulator=0;endTime=null;lastManual='';for(const c of cars){const [x,y]=initialPositions[c.id],n=nearest(x,y);Object.assign(c,{x,y,s:n.s,distance:n.s,heading:0,speed:0,progress:n.s/length,lap:1,finished:false,finishTime:null,coins:c.id===0?8:4,boost:0,checkpoint:1,parked:false,boostCooldown:0,drift:0,drifting:false,offroad:false,collisionCooldown:0,lastDecision:-1});c.object.position.set(x,y,0);c.object.rotation.set(0,0,0)}for(const c of coins){c.ready=0;c.mesh.visible=true;c.mesh.rotation.z=0;}flames.forEach(f=>f.visible=false);state={...initialState,autoplay:auto,phase:start?'countdown':'ready',events:[],racers:[]};log('restart',{autoplay:auto,positions:cars.map(c=>({id:c.id,x:c.x,y:c.y}))});if(start)log('phase',{phase:'countdown'});publish();};
- const publish=()=>{const order=[...cars].sort((a,b)=>a.finished&&b.finished?(a.finishTime??0)-(b.finishTime??0):a.finished?-1:b.finished?1:b.distance-a.distance);const p=cars[0];state={...state,time:simTime,frame,speed:p.speed,lap:p.lap,coins:p.coins,boost:p.boost,place:order.indexOf(p)+1,racers:cars.map(c=>({id:c.id,name:c.name,x:+c.x.toFixed(3),y:+c.y.toFixed(3),heading:+c.heading.toFixed(4),speed:+c.speed.toFixed(3),progress:+(c.distance/length).toFixed(5),lap:c.lap,finished:c.finished,finishTime:c.finishTime,coins:c.coins,boost:+c.boost.toFixed(3),parked:c.parked,drifting:c.drifting,offroad:c.offroad})),events:[...events],message:cars.every(c=>c.parked)?'All six racers finished':state.message};publishRaceState(state)};
- const start=()=>{if(state.phase==='ready'){state={...state,phase:'countdown',countdown:3};log('phase',{phase:'countdown'})}};
- const command=(cmd:Command)=>{if(cmd==='restart'){reset(state.autoplay);return;}if(cmd==='pause'){if(state.phase!=='ready'){state={...state,paused:!state.paused};log(state.paused?'pause':'resume')}return;}if(state.paused)return;if(cmd==='auto'){state={...state,autoplay:!state.autoplay};log('autoplay',{enabled:state.autoplay});if(state.autoplay)start()}else if(cmd==='start')start();};
- function controller(c:Car):Inputs{
-  const look=at(c.s+7+Math.abs(c.speed)*.45,c.finished?9.5:c.lane);const desired=Math.atan2(look.x-c.x,look.y-c.y),err=angle(desired-c.heading);const bend=Math.abs(angle(at(c.s+18).heading-at(c.s+3).heading));const target=(c.id===0?24.5:20.5+c.id*.25)-Math.min(6,bend*7);
-  const inputs={throttle:c.speed<target?1:0,brake:c.speed>target+1,steer:Math.max(-1,Math.min(1,err*2.4)),drift:Math.abs(err)>(c.drifting?.20:.40)&&c.speed>13,boost:!c.finished&&bend<.15&&c.coins>=2&&c.speed>15&&c.boostCooldown===0};
-  if(c.finished){const remaining=length*3+28+c.id*8-c.distance;const desiredSpeed=Math.min(15,Math.sqrt(Math.max(0,remaining-.7)*32));inputs.throttle=c.speed<desiredSpeed-.2?1:0;inputs.brake=c.speed>desiredSpeed+.05;inputs.drift=false;inputs.boost=false;}
-  if(c.id===0&&simTime-c.lastDecision>2){c.lastDecision=simTime;log('autoplay-decision',{racer:c.id,targetSpeed:+target.toFixed(2),target:{x:+look.x.toFixed(2),y:+look.y.toFixed(2)},inputs:{...inputs,steer:+inputs.steer.toFixed(2)}})}
-  return inputs;
- }
- const boost=(c:Car,drift=false)=>{if(c.boostCooldown>0||c.finished)return;if(!drift&&c.coins<2)return;if(!drift)c.coins-=2;c.boost=drift?.7:1.4;c.boostCooldown=drift?1.2:3;log('boost',{racer:c.id,source:drift?'drift':'coins',coins:c.coins,duration:c.boost})};
- function drive(c:Car,input:Inputs,dt:number){
-  if(c.parked)return;
-  c.collisionCooldown=Math.max(0,c.collisionCooldown-dt);c.boostCooldown=Math.max(0,c.boostCooldown-dt);
-  if(c.boost>0){c.boost=Math.max(0,c.boost-dt);if(c.boost===0)log('boost-end',{racer:c.id})}
-  if(input.boost)boost(c);
-  const drift=input.drift&&Math.abs(input.steer)>.1&&c.speed>6;
-  if(drift!==c.drifting){log(drift?'drift-start':'drift-end',{racer:c.id,charge:+c.drift.toFixed(2)});if(!drift&&c.drift>.6)boost(c,true);if(!drift)c.drift=0;c.drifting=drift}if(drift)c.drift+=dt;
-  let acceleration=input.throttle*12;
-  if(input.brake)acceleration=c.speed>0?-22:(c.finished?0:-9);
-  if(c.finished&&Math.abs(c.speed)<=.5&&c.distance>=3*length+26.5+c.id*8){c.speed=0;c.parked=true;log('parked',{racer:c.id,x:c.x,y:c.y,clearedFinish:true});return;}
-  const drag=input.throttle===0&&!input.brake?2.8:1.7;
-  if(c.speed!==0)acceleration-=Math.sign(c.speed)*drag;
-  c.speed+=acceleration*dt;
-  const maxSpeed=c.boost>0?33:25.5;
-  c.speed=Math.max(-7,Math.min(maxSpeed,c.speed));if(!input.throttle&&!input.brake&&Math.abs(c.speed)<.12)c.speed=0;
-  const turn=input.steer*(drift?1.9:1.45)*Math.min(1,Math.abs(c.speed)/7)*(c.speed<0?-1:1);c.heading=angle(c.heading+turn*dt);
-  c.x+=Math.sin(c.heading)*c.speed*dt;c.y+=Math.cos(c.heading)*c.speed*dt;
-  let n=nearest(c.x,c.y);const left=leftWidth(n.t,n.y),limit=n.lane<0?left:12;
-  const offroad=n.d>limit-1.2;
-  if(offroad!==c.offroad){c.offroad=offroad;log(offroad?'surface-leave':'surface-enter',{racer:c.id,surface:'Circuit asphalt',x:+c.x.toFixed(2),y:+c.y.toFixed(2)})}
-  if(offroad)c.speed*=Math.exp(-1.8*dt);
-  if(n.d>limit+1.2){const sign=Math.sign(n.lane),p=at(n.s,sign*(limit+1));c.x=p.x;c.y=p.y;c.speed*=.6;if(c.collisionCooldown===0){log('barrier-contact',{racer:c.id,object:sign<0?'Outside guardrail':'Inside sandstone verge',x:c.x,y:c.y});c.collisionCooldown=.8}n=nearest(c.x,c.y)}
-  let delta=n.s-c.s;if(delta>length/2)delta-=length;if(delta<-length/2)delta+=length;
-  // Projection advances only through physically adjacent road segments.
-  if(Math.abs(delta)<3+Math.abs(c.speed)*dt*2)c.distance+=delta;
-  c.s=n.s;
-  if(!c.finished&&c.distance>=c.checkpoint*length/4){log('checkpoint',{racer:c.id,checkpoint:c.checkpoint,x:c.x,y:c.y});c.checkpoint++;}
-  const lap=Math.min(3,Math.max(1,Math.floor(c.distance/length)+1));if(lap!==c.lap){c.lap=lap;log('lap',{racer:c.id,lap})}
-  if(!c.finished&&c.distance>=3*length&&c.checkpoint>=12){c.finished=true;c.finishTime=simTime;log('finish',{racer:c.id,name:c.name,time:simTime,x:c.x,y:c.y});if(c.id===0){endTime=simTime;state={...state,phase:'finished'};log('phase',{phase:'finished'})}}
-  c.object.position.set(c.x,c.y,0);c.object.rotation.set(0,0,-c.heading);
- }
- const eye=new THREE.Vector3(),target=new THREE.Vector3();
- function camera(){const p=cars[0],h=p.heading;ctx.root.localToWorld(eye.set(p.x-Math.sin(h)*10.7,p.y-Math.cos(h)*10.7,4.7));ctx.root.localToWorld(target.set(p.x+Math.sin(h)*18,p.y+Math.cos(h)*18,.05));ctx.camera.position.copy(eye);ctx.camera.up.set(0,1,0);ctx.camera.lookAt(target);const cam=ctx.camera as THREE.PerspectiveCamera;cam.fov=47;cam.far=180;cam.updateProjectionMatrix();}
- function physics(dt:number){
-  if(state.phase==='ready'||state.paused||cars.every(c=>c.parked))return;
-  simTime+=dt;frame++;
-  if(state.phase==='countdown'){state={...state,countdown:Math.max(0,state.countdown-dt)};if(state.countdown===0){state={...state,phase:'racing'};log('phase',{phase:'racing'});}return;}
-  const k=ctx.keys,manual:Inputs={throttle:k.has('ArrowUp')||k.has('KeyW')?1:0,brake:k.has('ArrowDown')||k.has('KeyS'),steer:(k.has('ArrowRight')||k.has('KeyD')?1:0)-(k.has('ArrowLeft')||k.has('KeyA')?1:0),drift:k.has('Space'),boost:k.has('ShiftLeft')||k.has('ShiftRight')};
-  const manualString=JSON.stringify(manual);if(!state.autoplay&&!botNow&&manualString!==lastManual){lastManual=manualString;log('manual-input',{inputs:manual});}
-  for(const c of cars)drive(c,c.id===0&&!state.autoplay&&!c.finished?manual:controller(c),dt);
-  for(let i=0;i<cars.length;i++)for(let j=i+1;j<cars.length;j++){
-   const a=cars[i],b=cars[j];if(a.finished||b.finished)continue;const dx=b.x-a.x,dy=b.y-a.y,d=Math.hypot(dx,dy);if(d>0&&d<2){const push=(2-d)*.51;a.x-=dx/d*push;a.y-=dy/d*push;b.x+=dx/d*push;b.y+=dy/d*push;if(a.collisionCooldown===0&&b.collisionCooldown===0){a.speed*=.85;b.speed*=.85;log('kart-contact',{a:i,b:j,object:'Kart.'+j,x:a.x,y:a.y});a.collisionCooldown=b.collisionCooldown=.5}}
-  }
-  for(const coin of coins){coin.mesh.visible=simTime>=coin.ready;if(!coin.mesh.visible)continue;coin.mesh.rotation.z=simTime*2;for(const c of cars){if(c.finished)continue;if(Math.hypot(c.x-coin.x,c.y-coin.y)<1.5){c.coins++;coin.ready=simTime+6;coin.mesh.visible=false;log('pickup',{racer:c.id,object:'Coin.'+coin.id,coins:c.coins});break}}}
-  cars.forEach((c,i)=>{const f=flames[i];f.visible=c.boost>0&&!c.parked;f.position.set(c.x-Math.sin(c.heading)*1.8,c.y-Math.cos(c.heading)*1.8,.38);f.rotation.set(Math.PI/2,0,-c.heading);f.scale.setScalar(.8+.25*Math.sin(simTime*42));});
- }
- // THE GAME PANEL'S AUTOPLAY (`play autoplay on race`): a bot that drives Pip with the keys a person
- // holds, through the manual code above, steering as the race's own AUTO does (`controller`, which logs
- // its decisions). Steering keys are pulsed so their average follows that steer; while the bot drives,
- // those key changes are not logged as manual input.
- let botDriving=false,botNow=false,steerDebt=0;
- ctx.autoplay({race:()=>{
-  botDriving=true;const c=cars[0];
-  if(state.paused)return {keys:[],state:'race paused'};
-  if(state.phase==='ready')return {keys:['ArrowUp'],state:'starting the race'};
-  if(state.phase==='countdown')return {keys:[],state:'waiting for the countdown'};
-  if(c.finished)return {keys:[],state:'finished; Pip parks past the line'};
-  const input=controller(c),keys:string[]=[];steerDebt+=input.steer;
-  if(steerDebt>=.5){keys.push('ArrowRight');steerDebt-=1}else if(steerDebt<=-.5){keys.push('ArrowLeft');steerDebt+=1}
-  if(input.throttle)keys.push('ArrowUp');if(input.brake)keys.push('ArrowDown');if(input.drift)keys.push('Space');if(input.boost)keys.push('ShiftLeft');
-  return {keys,state:`racing lap ${c.lap} of 3`};
- }});
- reset(false);
- return {update(dt:number){
-  botNow=botDriving;botDriving=false;
-  const keyCommands:[string,Command][]=[['Enter','start'],['KeyO','auto'],['KeyP','pause'],['KeyR','restart']];
-  const commands=consumeCommands();for(const [key,cmd]of keyCommands)if(ctx.keys.has(key)&&!previousKeys.has(key))commands.push(cmd);
-  for(const cmd of commands)command(cmd);
-  const moving=['ArrowUp','ArrowDown','ArrowLeft','ArrowRight','KeyW','KeyA','KeyS','KeyD'].some(k=>ctx.keys.has(k));
-  if(moving&&!state.paused&&!cars[0].finished){if(state.autoplay){state={...state,autoplay:false};log('autoplay',{enabled:false,cause:'manual takeover'})}start()}
-  previousKeys=new Set(ctx.keys);if(!state.paused){accumulator+=Math.min(dt,.1);while(accumulator>=1/60){physics(1/60);accumulator-=1/60}}else accumulator=0;
-  camera();clock+=dt;if(clock>.075||commands.length){publish();clock=0;}
- },dispose(){pickups.removeFromParent();sparks.removeFromParent();coinGeometry.dispose();coinMaterial.dispose();flameGeo.dispose();flameMat.dispose();}};
-}

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

@@ -1,55 +0,0 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-#
-# THE bpy SCRIPTS ARE GPL, AND THE REST OF YOUR PROJECT IS NOT.
-#
-# This file and the step scripts beside it drive `bpy`, Blender's Python API.
-# The Blender Foundation's stated position — their licence page, under
-# "Add-ons (Python scripts)" — is that the API "is an integral part of the
-# software" and that the GPL "therefore requires that such scripts (if
-# published) are being shared under a GPL compliant license". So a bpy script
-# is a derivative work of Blender, and these are licensed GNU General Public
-# License version 3 or later, exercising Blender's own "or later".
-#
-# WHAT THIS DOES NOT TOUCH. `canyon.blend` beside this file is YOURS, and so
-# is anything you export from it — glTF, GLB, renders. That is the
-# Foundation's position too, on the same page under "Your Artwork": what you
-# make with Blender is your sole property, "including the .blend files and
-# other data files Blender can write". The play script, the race state, the
-# textures and the React UI the template gave you are MIT. This licence
-# reaches the bpy scripts and nothing else.
-#
-# If you would rather not carry them: delete them. The `.blend` is the
-# document — these are only the recorded source of how it was made — and
-# nothing in the project reads them at runtime. If you write your own bpy
-# scripts, the Foundation's position applies to them on the same terms; it is
-# not a rule of ours and is not ours to waive, because the copyright in
-# Blender is Blender's authors'.
-#
-# Copyright 2026 Volter AI, Inc.
-
-"""Canyon Comet's authoring entry: the record of how `canyon.blend` was made.
-
-The saved `canyon.blend` is the document, and it is authoritative: this script
-never rebuilds existing artwork. Run on a file without the `Canyon Comet`
-collection, it runs the milestone scripts beside it in order (the circuit,
-six karts and chase camera, then the canyon, textures from `src/textures/`,
-polish and details, and last `scenery_ao.py`, which bakes ambient occlusion
-into the static scenery), each saving `src/models/canyon.blend`.
-
-Run it through the session's Blender, from this project:
-
-    exec(open("<project root>/src/models/canyon.py").read())
-
-Coordinates are metres, Z is up. At Play, `canyon.play.ts` drives the six
-`Kart.N` empties around the circuit that `course.ts` shares with these scripts.
-"""
-import bpy
-from pathlib import Path
-ROOT=Path(bpy.data.filepath).resolve().parents[2]
-if bpy.data.collections.get('Canyon Comet'):
-    print('Canyon Comet is already authored. Existing geometry and manual edits preserved.')
-else:
-    # Each step runs in its own namespace: they all name their own ROOT and helpers.
-    for step in ['circuit','environment','refine','polish','detail','complete_environment','kart_finish','driver_details','finish_scene','scenery_ao']:
-        source=ROOT/'src'/'models'/(step+'.py')
-        exec(compile(source.read_text(),step+'.py','exec'),{'__name__':'__main__','__file__':str(source)})

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

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

@@ -1,35 +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'))
-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

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

@@ -1,44 +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'))
-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

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

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

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

@@ -1,31 +0,0 @@
-# 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')