Vehicle3D¶
Category: Executor Tier: Plus
Purpose¶
Provides a unified native controller for land, air, and water travel.
Visual Reference¶

Properties¶
Property |
Type |
Default |
Notes |
|---|---|---|---|
Vehicle Mode |
Variant |
Land, Air, Water |
|
Engine Power |
Float |
Base drive or thrust multiplier |
|
Throttle Input |
Float |
-1.0..1.0 |
|
Steer Input |
Float |
-1.0..1.0 |
|
Brake Input |
Float |
0.0..1.0 |
|
Drag Coefficient |
Float, 0.0..1.0 |
Passive damping in air, water, or idle land states |
|
Handling Profile |
Arcade, Realistic |
Baseline Land handling profile |
|
Drivetrain Mode |
Auto, FWD, RWD, AWD, Custom |
Drive-wheel assignment policy |
|
Steering Limit |
Float, radians |
Optional override; 0 means use the active profile default |
|
Coast Brake |
Float |
Optional passive idle-brake multiplier; -1 means use the active profile default |
|
Min Speed |
Float, km/h |
Optional horizontal speed floor while throttle is active; 0 disables the assist |
|
Max Speed |
Float, km/h |
Optional horizontal speed ceiling; 0 disables the cap |
|
Wheel Layout |
Bike, Trike Delta, Trike Tadpole, Quad |
Slot mapping for runtime wheel roles and per-wheel overrides |
|
Wheel Count |
Int, 2..4 |
Legacy fallback used only when wheel_layout is absent in older scenes |
|
Suspension Rest |
Float |
Optional global override; 0 means use the active profile default |
|
Suspension Travel |
Float |
Optional global override; 0 means auto-derived from rest length |
|
Stiffness |
Float |
Optional global override; 0 means use the active profile default |
|
Max Force |
Float |
Optional global override; 0 means auto mass-based anti-sink default (max(6000, body_mass 9.8 1.25)) |
|
Damping Compression |
Float |
Optional global override; 0 means use the active profile default |
|
Damping Relaxation |
Float |
Optional global override; 0 means use the active profile default |
|
Friction Slip |
Float |
Optional global grip override; 0 means use the active profile default |
|
Roll Influence |
Float |
Optional global roll override; -1 means use the active profile default |
|
Mass Override |
override_mass, vehicle_mass |
Optional runtime overwrite of VehicleBody3D.mass |
|
Center of Mass Override |
override_center_of_mass, center_of_mass |
Optional runtime overwrite of VehicleBody3D.center_of_mass |
|
Per-Wheel Tuning |
per_wheel_tuning |
Enables compact per-slot runtime properties for: |
|
Native Node Authorship |
Variant |
Wheel radius and detailed per-wheel suspension geometry remain authored on the scene’s VehicleWheel3D nodes |
|
Lift Coefficient |
Variant |
||
Banking Amount |
Variant |
||
Altitude Lock |
Variant |
Reserved, not active in runtime |
|
Buoyancy Stiffness |
Variant |
||
Surface Offset |
Variant |