Hover Bike

showcase/hover-bike/

A procedural sci-fi hover bike — a sculpted two-tone fuselage with panel seams, gasketed access panels with hex fasteners, a belly service plate, decal plate, hinged charge-port door, heat sink, intake grilles, grab rail and tail light, a stitched pleated saddle, a twin-stanchion fork through sculpted triple clamps with clip-ons, switch pods, pivoted levers and a visored instrument cluster, two glowing exhaust nozzles, two ducted fans with canted stator vanes and handed seven-blade rotors, aerofoil pylons flared into the shrouds with fastener rows and a conduit, and landing gear of twin-plate pressed links and oleo shocks on sixteen pinned joints carrying ski-section skids on wear strips — 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: 45796 tris, ten materials with 3796 livery, 5832 composite, 6008 gunmetal, 1304 rubber, 1760 leather, 532 light, 476 glass, 2788 anodised, 1344 carbon and 1320 chrome faces, UVs in 0..1 with zero AABB overlap, outer AABB 2.234×0.660×1.112 m, zmin 0, hygiene 0 including zero coplanar cross-shell pairs, both wear strips on the floor, both rotor hubs and motor cans on their shroud axes (0.001 mm) with level shrouds 1.600 m apart, blade-tip clearance 9.8 mm on both fans (band 6–14 mm), the fuselage mirror-symmetric to 0.000 mm at 1.033×0.344 m with the saddle at 0.852 m, seven blades per rotor with gaps within 0.0001° of 360/7°, the mass centre 0.252 m inside the skids' contact polygon (floor 0.200), one connected assembly of 322 shells, all 16 pins coaxial with their three bushings (0.000 mm), all 4 shock rods on their barrels' axes with 0.123 m of rod out of the gland (band 0.100–0.140) and 0.065 m engaged (floor 0.045), LOD ratios in band, collider 1246 tris, non-empty glTF. --skip-decimate exits 9; --stray-vert 15; --lift-z 16; --float-skid 16; --offset-hub 17; --long-blades 18; --odd-hull 19; --skew-blade 20; --narrow-skids 21; --pop-lens 22; --offset-pin 24; --skew-rod 25; --short-rod 25.

category Vehicles

tags mesh export showcase

blender --background --python showcase/hover-bike/hover_bike.py --

A showcase piece, not an example, and the second in the vehicles category. It builds a procedural sci-fi hover bike, parked on its landing gear:

The layout is solved from named constants. Every blade section is wrapped onto its own cylinder about the fan axis, so the tip is exactly BLADE_TIP from it and the clearance to the throat is a design number (10 mm), not a side effect of a flat section's corners. Grilles, fins, panels and plates are laid on the fuselage's closed-form surface along its own normal. The hull's section parameter is symmetric about its crown, so the hull is its own mirror image vertex for vertex. The gear's pins, bushings, barrels, rods and wear strips carry a part face tag (role and unit), so the joint, shock and ground audits read the parts they mean rather than guessing them from shape.

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: 2.23 m long, 0.66 m across the bar ends, 1.11 m to the top of the cluster's visor, with the saddle's top at 0.852 m. The shrouds set the length, the bar-end weights the width and the visor the top. The fuselage is 1.033 × 0.344 m. The origin is under the bike's centre, so it lands on the soles of its wear strips.

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.

AxisDeclaredMeasured (5.2.1)
Base triangles45000–4600045796
LOD1 ratio0.32–0.62 of base0.5000
LOD2 ratio0.10–0.35 of base0.2197
Materialsexactly 10 distinct; ≥3490 livery, ≥5365 composite, ≥5525 gunmetal, ≥1200 rubber, ≥1620 leather, ≥490 light, ≥460 glass, ≥2565 anodised, ≥1235 carbon, ≥1215 chrome faces10 slots; 3796 / 5832 / 6008 / 1304 / 1760 / 532 / 476 / 2788 / 1344 / 1320
UVsin 0..1, AABB overlap ≤ 1e-5in range, overlap 0
Outer AABB(2.234, 0.660, 1.112) m ± 0.01(2.2338, 0.6598, 1.1124), zmin 0
Collider tris≤ 19901246
Exportwritten, size > 0, removed after measuring3472164 / 3472164 / 3472160 bytes (4.5.11 / 5.1.2 / 5.2.1)

The collider is the convex hull of the whole bike. Its count is carried by the two 72-segment shroud lips, which are the hull's outline in plan.

Every falsifier leaves the triangle count at 45796: they move, scale or bend 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.

Hygiene#

Recomputed from the generated mesh, not asserted about the script.

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
Skids: each of the 2 wear strips has its own zminwithin 1e-4 of 00, 0

Coplanar pairs are kept at zero by staggering parts, not by widening the band. The two bosses and the eye on a joint are turned to three different phases, so their bores never share a face plane; the two plates of a link and the two cheeks of a clevis differ by 0.4 mm; hex heads are turned 15°, so a row or a column of them never shares a flat; skin, gasket and panel faces sit at least 1 mm apart, front and back.

Fans, symmetry, stance, joints and shocks#

AxisDeclaredMeasured
Fans coaxial: each rotor hub and motor can (vertex mean) on its shroud's axis (vertex mean of the lathe); shrouds level (PCA); fan axes 1.60 m apart on the centrelinehub and can within 1 mm of the axis; tilt ≤ 0.3°; pitch 1.600 ± 0.002 m, axes within 1 mm of y = 00.001 mm; 0°; 1.60000 m
Blade-tip clearance: from the shroud axis, a level ray through each outer blade vertex to the shroud's inner wall, minus the vertex's radius; every blade overlaps its hub0.006–0.014 m0.0098 m on both fans; 0 unseated
Hull mirror symmetry: every fuselage vertex against its nearest vertex at (x, −y, z)≤ 0.5 mm0.000 mm
Size: fuselage length and width, saddle top1.033 × 0.344 m, 0.852 m, each ± 0.0041.0330 × 0.3437, 0.8520
Blade spacing: blades per rotor, and the angular gaps between them about the rotor hub's own axis7 per rotor; each gap 360/7° ± 0.3°7 and 7; worst 0.0001°
Stance: mass centre (shell volumes × density per material) inside the convex polygon of both wear strips' soles≥ 0.200 m inside every edge0.2515 (148.5 kg, centre at x −0.019)
One connected assembly (union of shells whose BVH trees overlap)1 component1 (322 shells)
Joints: 16, each one pin through three bushings; every bushing's centre on its pin's axis (PCA of the turned part), its axis parallel, its centre inside the pin's spanoffset ≤ 0.3 mm, tilt ≤ 0.3°16 joints; 0.000 mm, 0.000°
Shocks: 4, the rod on its barrel's axis; the rod's length out of the gland, and its length still inside the barreloffset ≤ 0.3 mm, tilt ≤ 0.3°; exposed 0.100–0.140 m; engaged ≥ 0.045 m0.000 mm, 0.010°; 0.1233 m; 0.065 m

A ducted fan is only as good as its tip gap: the thrust a duct adds comes from the blade tips running close to the wall. Too wide and it is an open propeller in a ring; the blade touches the wall if the gap is zero. The clearance budget measures that gap along the ray the tip travels on. The coaxiality budget is its precondition, since a rotor off its shroud's axis closes the gap on one side. Blade spacing is the rotor's balance, measured about the rotor's own hub, so a rotor shifted off the shroud axis fails coaxiality alone. A pinned joint binds if its pin is off its bushings' axis, and a shock tops out if its rod is not engaged in the barrel, so the gear carries the same two checks as the loader's rams (showcase/cargo-loader). The densities are named constants (composite shells 1600 kg/m³, the fuselage as a hollow monocoque with its internals 250, aluminium 2700, rubber and lights 1200, leather and foam 300, glass 2500, carbon 1600, chrome-plated steel 7800), and the volumes come from the mesh.

Falsifiers#

Each falsifier violates one named budget. Every one was run on 5.2.1 and exited its declared code. None moves the envelope: every run measured the same outer AABB and triangle count as the default, and every budget checked before the target stayed 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-skidboth skids on the ground (the y+ shoe, strip, caps and bolts 4 mm up: its zmin 0.004, the other 0)16
--offset-hubfans coaxial (rear rotor 2.5 mm off its shroud's axis: 0.00250 m)17
--long-bladesblade-tip clearance band (rear blades 12 mm longer: clearance −0.0022 m)18
--odd-hullhull mirror symmetry (a 4 mm sideways bow, zero at both ends: deviation 0.00799 m)19
--skew-bladeblade spacing (one rear blade turned 4°: worst gap error 4.000°)20
--narrow-skidsstance (shoes drawn in to ±0.150 m: margin 0.1715 m)21
--pop-lensone connected assembly (headlight lens 20 mm out of its housing: 2 components)22
--offset-pinjoints (the near front link's foot pin 1.5 mm along x: 0.001500 m off its bushings' axis)24
--skew-rodshocks (the near rear rod 1.5 mm across its axis: 0.001500 m off its barrel's)25
--short-rodshocks (the near rear rod's inner end drawn out 45 mm: engaged 0.020 m, floor 0.045)25

The rear fan is the one --offset-hub, --long-blades and --skew-blade change, because nothing inside a shroud sets the envelope. --offset-hub leaves the tip clearance inside its band and the blade gaps exact, so only coaxiality sees it. --long-blades pushes the tips 2.2 mm into the wall, and every blade still sits in its hub. --odd-hull bows the fuselage by cos(πx / 2·0.515), so both ends stay inside their shroud walls, and it bows everything laid on the skin with it: when only the hull bowed, a panel met a hull facet at a shared plane and the run stopped at hygiene (15) instead. --float-skid lifts one skid's own parts while the other grounds the box; its first draft lifted the skid lug's pin too, which slid a pin face onto a boss's plane and also stopped at 15, so the lug and its pin now stay with the gear. --pop-lens first stopped at 15 because the lens (36 segments) and its housing (32) had faces within 0.6° of parallel; both are now 32 segments turned half a step apart. --narrow-skids keeps both strips on the ground and the envelope unchanged; only the contact polygon shrinks. --offset-pin moves a pin and no bushing; --skew-rod and --short-rod move a rod and no pin, so each fails its own budget alone.

Run#

blender --background --python hover_bike.py --
blender --background --python hover_bike.py -- --skip-decimate
blender --background --python hover_bike.py -- --stray-vert
blender --background --python hover_bike.py -- --lift-z
blender --background --python hover_bike.py -- --float-skid
blender --background --python hover_bike.py -- --offset-hub
blender --background --python hover_bike.py -- --long-blades
blender --background --python hover_bike.py -- --odd-hull
blender --background --python hover_bike.py -- --skew-blade
blender --background --python hover_bike.py -- --narrow-skids
blender --background --python hover_bike.py -- --pop-lens
blender --background --python hover_bike.py -- --offset-pin
blender --background --python hover_bike.py -- --skew-rod
blender --background --python hover_bike.py -- --short-rod
blender --background --python hover_bike.py -- --output bike.png

Smoke passes no flags.

The hero turns the piece HERO_YAW_DEG (−62°), so the nose, headlight and front fan come toward the lens on the right, and the near side's gear, panels and decal face it. The camera stands high enough to look into both shrouds, where the blades and spinners show. The wall stands 2.8 m behind the bike, and the warm wedge pools on it. Gunmetal and chrome carry a studio reflection term (after showcase/road-bicycle), so the gear reads as metal on the dark stage.

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–25 are file-local. 23 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 ≠ 10 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 skid's wear strip off the ground, or not 2 skids (--lift-z, --float-skid)
17Fans not coaxial: a rotor hub or motor can off its shroud's axis, a shroud tilted, the fan pitch off, or not 2 shrouds, hubs and cans (--offset-hub)
18Blade-tip clearance outside its band, or a blade not in its hub (--long-blades)
19Hull mirror symmetry, or fuselage length, width or saddle height off (--odd-hull)
20Blade spacing: not 7 blades per rotor, or a gap off 360/7° (--skew-blade)
21Stance: mass centre within 0.200 m of the skids' contact-polygon edge (--narrow-skids)
22Assembly splits into more than one connected component (--pop-lens)
23Asset-quality floor (render path only; remapped from 11)
24Joints: not 16, a joint without one pin and three bushings, or a bushing off its pin's axis or span (--offset-pin)
25Shocks: not 4, a rod off its barrel's axis, its exposed length outside 0.100–0.140 m, or engaged under 0.045 m (--skew-rod, --short-rod)

Source

showcase/hover-bike/hover_bike.py View the script on GitHub →
A muted-teal hover bike with panelled flanks, a stitched saddle and two ducted fans, standing on pinned landing gear with orange shock absorbers and teal skis on a dark studio floor.