Go Kart

showcase/go-kart/

A procedural rental go-kart on a patch of kart-track asphalt against a red and white kerb — a 30 mm tube chassis whose main loop is one bar swept round every bend, cross tubes ending inside the rails with welded gussets, bearing hangers and kingpin C-brackets; spindles on kingpin bolts with 14° caster, a raked column in a bushing, a steering plate and two tie rods on rod-end eyes; blue moulded bodywork — a nose cone with a raised hump and lipped shoulders, pods with a crest, a ribbed deck and a groove, a front panel leaning back from the hump with a white number plate — on ten strap brackets welded to the tubes and bolted to the mouldings; a moulded seat on stays, a floor tray, pedals, a brake master cylinder with its hose to the caliper, a throttle cable, a strapped fuel tank and a lead ballast block; a finned four-stroke clamped to the rail driving the live rear axle through a clutch, an 88-link chain solved to a whole number of pitches and a 60-tooth sprocket, bearing carriers, a brake disc and caliper; and four loaded slicks on split rims with valve stems, the fronts narrower than the rears — through UVs, bake, LOD, collider, and Unity glTF, asserting recomputed budgets rather than an API contract.

Rendered headless by the showcase piece itself. Select it to enlarge.

witnesses Recomputed: 81854 tris, fourteen materials with 3168 frame paint, 6994 chrome, 8188 rubber, 3708 bodywork, 1548 seat, 12666 aluminium, 1920 engine casting, 4130 steel, 1686 black plastic, 172 fuel tank, 168 lead, 646 asphalt, 126 kerb paint and 124 number plate faces, UVs in 0..1 with zero AABB overlap, outer AABB 1.895×1.774×0.640 m, zmin 0, hygiene 0 including zero coplanar cross-shell pairs, all 4 tyres pressed 1.5 mm into the asphalt with their patches in one plane (band 0.8–3.0 mm), 4 hubs and 2 bearings 0.0 mm off their axles (≤ 0.3 mm), 4 tie-rod eyes on their pins and biting their plates 0.3–0.5 mm, tyre beads seated 0.864–1.000 mm on the rims (band 0.4–2.0 mm), the chain's inner edge 1.911–1.946 mm under both tooth-root circles (band 0.8–3.0 mm), frame and bodywork mirrored within 0.043 mm and the wheels within 0.0001 mm, wheelbase 1.040 m and tracks 1.100 / 1.200 m, caster 14.0°, the mass centre 0.374 m inside the tyres' support polygon (≥ 0.312 m), one connected assembly of 330 shells, 10 bodywork brackets each biting its tube 0.90–1.99 mm and its moulding 1.00–1.47 mm (band 0.5–2.5 mm), LOD ratios in band, collider 598 tris, non-empty glTF. --skip-decimate exits 9; --stray-vert 15; --lift-z 16; --float-tyre 16; --cock-hub 17; --drop-bearing 17; --short-tierod 17; --sink-tyre 18; --lift-chain 18; --toe-wheel 19; --wide-track 19; --odd-frame 19; --no-caster 19; --aft-ballast 20; --loose-ballast 21; --float-nose 23.

category Vehicles

tags mesh export showcase

blender --background --python showcase/go-kart/go_kart.py --

A showcase piece, not an example, and the eighth in the vehicles category: things that move. It builds a rental/racing go-kart (generic, no marks or text) parked on a patch of kart-track asphalt:

It asserts budget conformance of the generated result. It does not witness an API contract. "It rendered without error" is not a check.

Composes skills mesh-editing-and-bmesh, bake-high-to-low, depsgraph-and-evaluated-data, engine-export-presets, and snippets bake_normal_high_to_low.py, setup_bake_target_image.py, lod_chain.py / decimate_to_budget.py, convex_hull_collider.py, export_preset_unity.py (helpers copied inline, not imported).

Intended size: wheelbase 1.040 m, front track 1.100 m and rear track 1.200 m (tyre centre to tyre centre); overall 1.75 × 1.40 m, the seat back 0.47 m over the asphalt. The patch with its kerb is 1.90 × 1.77 m; the top of the envelope is the seat back at 0.64 m. The origin is under the patch centre at the slab's underside.

Budgets#

Every budget is declared as a named constant. Every gate recomputes its value from the mesh, materials, UVs, evaluated LOD, collider, or export file. Shells are found by a part face attribute; every measured value is read from their vertices.

AxisDeclaredMeasured (5.2.1)
Base triangles81000–8270081854
LOD1 ratio0.32–0.62 of base0.5000
LOD2 ratio0.10–0.35 of base0.2200
Materialsexactly 14 distinct; ≥2910 frame paint, ≥6430 chrome, ≥7530 rubber, ≥3410 bodywork, ≥1420 seat, ≥11650 aluminium, ≥1760 engine casting, ≥3790 steel, ≥1550 black plastic, ≥158 fuel tank, ≥154 lead, ≥590 asphalt, ≥115 kerb paint, ≥114 number plate faces14 slots; 3168 / 6994 / 8188 / 3708 / 1548 / 12666 / 1920 / 4130 / 1686 / 172 / 168 / 646 / 126 / 124
UVsin 0..1, AABB overlap ≤ 1e-5in range, overlap 0
Outer AABB(1.8950, 1.7738, 0.6397) m ± 0.01, read off the vertices(1.8950, 1.7738, 0.6397), zmin 0
Collider tris≤ 900598
Exportwritten, size > 0, removed after measuring6072672 / 6072672 / 6072664 bytes (4.5.11 / 5.1.2 / 5.2.1)

Every falsifier leaves the triangle count at 81854 and the envelope at (1.8950, 1.7738, 0.6397): they move parts, never add or remove them.

DECIMATE COLLAPSE triangle counts are not identical across Blender series, so the LOD gate is a ratio band, not an exact count. Bake pixels are stochastic, so the bake gate is has_data plus operator FINISHED, not byte-identity. Construction uses no RNG; two default runs print identical measurements, and 4.5.11 and 5.1.2 print the same measurements as 5.2.1 (the export differs by 76 bytes).

Hygiene and grounding#

AxisDeclaredMeasured
Non-manifold edges00
Loose verts / edges0 / 00 / 0
Doubles merged at 1e-500
Zero-area faces00
N-gons00
Coplanar cross-shell face pairs (KD range 0.05 m, plane ε 1e-4)00
Grounded: zminwithin 1e-4 of 00.0000
Tyres: each tyre's lowest vertex under the asphalt's top read off the slab, the four patches in one plane4 tyres; 0.8–3.0 mm; spread ≤ 0.1 mm4; 1.5 mm each; 0

The first draft measured 725 coplanar pairs, none of them in a part: hex heads turned by the bolt circle's own angle step, so every head in a ring put its flats on its neighbours' planes (each head is now turned a further, non-commensurate step); the axle's end cap on the plane of the rear split bolts' heads; equal 19.5 mm bores on the axle sharing facet planes (every axle part is now turned a further step); stacked ballast plates of one size; a brake carrier's face on the caliper's; gussets' edges on one plane along their cross tube; a clamp face on a cross tube's end cap; and a sprocket root flat on the plane of the chain's waist face. Mirrored rays onto the bodywork also hit 2.3 mm apart until its lofts were triangulated on their short diagonals: a fixed split is not mirror-symmetric, and a fastener aimed at one triangulation floated over the other.

Joints, seats, size, stance and assembly#

AxisDeclaredMeasured
Joint fit: each front hub against its stub axle and each rear hub and bearing against the axle (the part's axis of revolution and centre against the host's principal axis)4 hubs, 2 bearings; ≤ 0.3 mm off, ≤ 0.3°4, 2; 0.0 mm, 0.0°
Joint fit: each tie-rod eye on its pin (plan offset) and biting the plate under it (a ray down onto the steering arm or plate)4 eyes; ≤ 0.5 mm; bite 0.2–1.5 mm4; 0.0 mm; 0.3 / 0.5 mm
Tyre seat: per tyre, per angular segment, the bead vertices against the rim's bead seat (a ray toward the axis along each vertex's own radial)4 tyres, each on a rim; 0.4–2.0 mm0.864–1.000 mm
Chain seat: per sprocket, one bin per tooth over the middle half of the wrap, the tooth-root circle less the chain's inner edge; the chain's plane against the sprocket's2 sprockets; 0.8–3.0 mm; ≤ 0.5 mm1.911 and 1.943–1.946 mm; 0.005 / 0.006 mm
Mirror: every frame-paint and bodywork vertex (nose, panel, pods, grip ribs) against its partner across the loop's centre plane (KD-tree)≤ 0.5 mm0.043 mm
Wheels: front and rear tyres paired, centres and extents compared≤ 0.5 mm0.0001 mm
Size: wheelbase and both tracks from the tyres' own centres1.040 / 1.100 / 1.200 m ± 4 mm1.0400 / 1.1000 / 1.2000
Caster: each kingpin sleeve's principal axis, tilt back in plan2 kingpins; 10–18°14.0°, 14.0°
Stance: mass centre (per-shell volume × a per-material density) inside the convex hull of the four contact patches≥ 0.312 m (30 % of the wheelbase)0.3735 m (88.6 kg)
One connected assembly (union of shells whose BVH trees overlap, the patch included)1 component1 (330 shells)
Bodywork brackets: per strap, its bite into every moulding or tube it meets (the deepest strap vertex inside that shell: nearest-face distance, signed by a three-ray parity vote); the two deepest are its two joints10 brackets; both joints 0.5–2.5 mm10; welded ends 0.90–1.99 mm, tabs 1.00–1.47 mm

Densities are effective: tubes, rims and tyres are modelled solid but are hollow, so each material carries a density that makes its mass plausible.

The bracket bite is signed by ray parity, not by the nearest face's normal: beside the panel's 4 mm rim the nearest face is the rim strip, and its normal read the tab's back face, 2 mm behind the panel, as 1.96 mm inside. Each panel tab's width follows the panel's own across-direction: laid along world Y, the wrapped sides tipped one edge of the tab off the panel. Measuring it also found the nose inside out: recalc_face_normals had turned it, so every closed island is now oriented by its signed volume before shipping.

Falsifiers#

Each falsifier violates one named budget. Every one was run on 5.2.1, 4.5.11 and 5.1.2 and exited its declared code, with the triangle count and envelope unchanged and every budget checked before the target green.

FlagBudget violatedExit
--skip-decimateLOD1 ratio band (measured 1.0000)9
--stray-vertloose vertex count is 0 (measured 1, placed inside the envelope)15
--lift-zbounding box zmin is 0 (measured 0.05000)16
--float-tyreevery tyre pressed into the asphalt in one plane (the left front lifted 4 mm: −2.5 mm, the rest 1.5 mm)16
--cock-hubhubs coaxial (the left rear hub 1.5 mm off the axle: 1.5 mm)17
--drop-bearingaxle through both bearings (the right bearing and carrier 2 mm low: 2.0 mm)17
--short-tierodtie-rod eyes on their pins (the left rod 6 mm short: 6.0 mm)17
--sink-tyretyre bead seat (the right rear bead 3 mm into its seat: 3.000 mm)18
--lift-chainchain seated on its sprockets (the chain 4 mm off both: −2.089 and −2.060 mm)18
--toe-wheelwheels mirrored (the left front corner turned 1.5°: 4.539 mm)19
--wide-trackrear track at its stated size (each rear wheel 4 mm out: 1.2080 m)19
--odd-framechassis mirror symmetry (the left rail bowed 3 mm out: 1.819 mm)19
--no-castercaster band (kingpins vertical: 0.0°)19
--aft-ballaststance (the 8 kg ballast moved behind the axle: 0.2887 m)20
--loose-ballastone connected assembly (the ballast lifted 3 mm off the tray: 2 components, 5 and 325 shells)21
--float-nosebodywork brackets (the nose and its bolts slid 3 mm forward: both nose brackets' tabs −2.0 mm)23

--float-tyre lifts the tyre alone, after the patch is flattened, while the slab still grounds the box. --toe-wheel turns the whole corner (spindle, hub, rim and tyre) about the vertical through the kingpin, and the tie rod is rebuilt to the moved arm, so the hubs stay coaxial and the eye stays on its pin; a turn about the raked kingpin itself would have dropped the patch out of its band first. --lift-chain moves the chain alone, keeping the tooth phase of the seated chain: phasing the teeth to the lifted pins, and lifts of 1.7, 2.0, 2.5, 3.0 and 3.5 mm, each put a chain face within 0.1 mm of a tooth flat's plane and exited 15. The assembly falsifier first lifted a side pod, which broke the bodywork's mirror and exited 19; the ballast stack is measured by nothing else. --float-nose moves the nose along X only, so the mirror holds, the nose stays on its bumper bars and on the panel's foot (one assembly), and the slab still sets the envelope.

Run#

blender --background --python go_kart.py --
blender --background --python go_kart.py -- --skip-decimate
blender --background --python go_kart.py -- --stray-vert
blender --background --python go_kart.py -- --lift-z
blender --background --python go_kart.py -- --float-tyre
blender --background --python go_kart.py -- --cock-hub
blender --background --python go_kart.py -- --drop-bearing
blender --background --python go_kart.py -- --short-tierod
blender --background --python go_kart.py -- --sink-tyre
blender --background --python go_kart.py -- --lift-chain
blender --background --python go_kart.py -- --toe-wheel
blender --background --python go_kart.py -- --wide-track
blender --background --python go_kart.py -- --odd-frame
blender --background --python go_kart.py -- --no-caster
blender --background --python go_kart.py -- --aft-ballast
blender --background --python go_kart.py -- --loose-ballast
blender --background --python go_kart.py -- --float-nose
blender --background --python go_kart.py -- --output kart.png

Smoke passes no flags.

The hero looks from the front right and above, so the nose, the front panel with its plate and the right-hand wheels lead, the engine, chain and silencer show over the right pod, and the kerb runs behind. The wall stands 5 m behind the patch and the warm wedge pools on it behind the kart. Default stage; no deviation.

Shading#

Lathed parts, tubes, tyres, the seat and the bodywork are smooth-shaded; chamfers, fins, teeth and every material boundary stay crisp through sharp edges above 35°. Every part carries a PartTone face attribute that moves it between two tones, so the four tyres and the ballast plates differ, and the kerb's stripes are the same attribute picking red or white. Grime rises from the asphalt on every part and scuffs are sparse. Chrome, aluminium, steel and the casting carry a studio reflection term so they do not read as grey plastic on a dark stage; the track asphalt is streaked darker along the racing line. The bodywork's lower half carries dark tyre-rubber streaks and light scratches, both stretched fore and aft; the frame is scratched through to steel low down; the frame, casting, aluminium, steel and chrome darken with oily grime toward the engine.

The livery is blue with a white number plate, so the warm notes are the red frame and the kerb. The yellow livery the piece first shipped with filled the lower half of the hero and measured a wedge warmth of +0.288, out of the calibration band (−0.144 to +0.105); blue measures −0.094.

Exit codes#

File-local. 9 is a valid check code. 10 is reserved for gallery_framing.check_framing on the --output path. 15–19 are the hygiene and joint-fit family. 20, 21 and 23 are file-local. 22 is the asset-quality floor on the render path: check_asset_quality returns 11, which this piece already spends on the collider ceiling, so the call site remaps it.

CodeMeaning
0Success
1Uncaught exception (FATAL wrapper)
2argparse / usage
3Mesh did not build / no UV layer
4Base triangle count outside range
5Material count ≠ 14 distinct slots, or a face-count floor missed
6UVs outside 0..1
7UV AABB overlap above tolerance
8World AABB off declared outer size
9LOD ratio band (--skip-decimate lands here)
10Framing gate (render path only)
11Collider triangle count above ceiling
12Bake did not finish or image has no data
13Export file missing or empty
14--output produced no file
15Mesh hygiene: loose, non-manifold, zero-area, doubles, n-gons, coplanar cross-shell pairs
16Not grounded: bounding box zmin off 0, or a tyre outside its band, the patches out of one plane, or not 4 tyres (--lift-z, --float-tyre)
17Joint fit: a hub or bearing off its axle, a tie-rod eye off its pin or out of its bite band, or a part missing (--cock-hub, --drop-bearing, --short-tierod)
18Seat: a tyre bead out of its seat band, the chain off its sprockets' roots or out of line, or a part missing (--sink-tyre, --lift-chain)
19Mirror, size and angle: frame or bodywork not mirrored, wheels not mirrored, wheelbase or a track off, caster out of band (--toe-wheel, --wide-track, --odd-frame, --no-caster)
20Stance: the mass centre too near an edge of the support polygon (--aft-ballast)
21Assembly splits into more than one connected component (--loose-ballast)
22Asset-quality floor (render path only; remapped from 11)
23Bodywork brackets: not 10 straps, or a strap's weld or tab out of its bite band (--float-nose)

Source

showcase/go-kart/go_kart.py View the script on GitHub →
Blue go-kart on a patch of track asphalt before a red and white kerb: moulded nose, side pods and a front panel with a white plate, red tube chassis, black seat, finned engine.