unreal.ChaosWheeledVehicleMovementComponent

class unreal.ChaosWheeledVehicleMovementComponent(outer=None, name='None')

Bases: unreal.ChaosVehicleMovementComponent

Chaos Wheeled Vehicle Movement Component

C++ Source:

  • Plugin: ChaosVehiclesPlugin

  • Module: ChaosVehicles

  • File: ChaosWheeledVehicleMovementComponent.h

Editor Properties: (see get_editor_property/set_editor_property)

  • aerofoils (Array(VehicleAerofoilConfig)): [Read-Write] Aerofoils: Optional aerofoil setup - can be used for car spoilers or aircraft wings/elevator/rudder

  • asset_user_data (Array(AssetUserData)): [Read-Write] Asset User Data: Array of user data stored with the component

  • auto_activate (bool): [Read-Write] Auto Activate: Whether the component is activated at creation or must be explicitly activated.

  • auto_register_physics_volume_updates (bool): [Read-Write] Auto Register Physics Volume Updates: If true, then applies the value of bComponentShouldUpdatePhysicsVolume to the UpdatedComponent. If false, will not change bShouldUpdatePhysicsVolume on the UpdatedComponent at all. see: bComponentShouldUpdatePhysicsVolume

  • auto_register_updated_component (bool): [Read-Write] Auto Register Updated Component: If true, registers the owner’s Root component as the UpdatedComponent if there is not one currently assigned.

  • auto_update_tick_registration (bool): [Read-Write] Auto Update Tick Registration: If true, whenever the updated component is changed, this component will enable or disable its tick dependent on whether it has something to update. This will NOT enable tick at startup if bAutoActivate is false, because presumably you have a good reason for not wanting it to start ticking initially.

  • brake_input_rate (VehicleInputRateConfig): [Read-Write] Brake Input Rate: Rate at which input brake can rise and fall

  • can_ever_affect_navigation (bool): [Read-Write] Can Ever Affect Navigation: Whether this component can potentially influence navigation

  • center_of_mass_override (Vector): [Read-Write] Center Of Mass Override: The center of mass override value, this value overrides the calculated COM and the COM offset value in the mesh is also ignored.

  • chassis_height (float): [Read-Write] Chassis Height: Chassis height used for drag force computation (cm)

  • chassis_width (float): [Read-Write] Chassis Width: Chassis width used for drag force computation (cm)

  • component_should_update_physics_volume (bool): [Read-Write] Component Should Update Physics Volume: If true, enables bShouldUpdatePhysicsVolume on the UpdatedComponent during initialization from SetUpdatedComponent(), otherwise disables such updates. Only enabled if bAutoRegisterPhysicsVolumeUpdates is true. WARNING: UpdatePhysicsVolume is potentially expensive if overlap events are also disabled because it requires a separate query against all physics volumes in the world.

  • component_tags (Array(Name)): [Read-Write] Component Tags: Array of tags that can be used for grouping and categorizing. Can also be accessed from scripting.

  • constrain_to_plane (bool): [Read-Write] Constrain to Plane: If true, movement will be constrained to a plane. see: PlaneConstraintNormal, PlaneConstraintOrigin, PlaneConstraintAxisSetting

  • differential_setup (VehicleDifferentialConfig): [Read-Write] Differential Setup: Differential

  • downforce_coefficient (float): [Read-Write] Downforce Coefficient: DownforceCoefficient of the vehicle chassis - force pressing vehicle into ground at speed

  • drag_coefficient (float): [Read-Write] Drag Coefficient: DragCoefficient of the vehicle chassis - force resisting forward motion at speed

  • editable_when_inherited (bool): [Read-Write] Editable when Inherited: True if this component can be modified when it was inherited from a parent actor class

  • enable_center_of_mass_override (bool): [Read-Write] Enable Center Of Mass Override: Enable to override the calculated COM position with your own fixed value - this prevents the vehicle handling changing when the asset changes

  • engine_setup (VehicleEngineConfig): [Read-Write] Engine Setup: Engine

  • fixed_path_braking_distance (float): [Read-Write] Fixed Path Braking Distance: Braking distance override used with acceleration driven path following (bUseAccelerationForPaths)

  • handbrake_input_rate (VehicleInputRateConfig): [Read-Write] Handbrake Input Rate: Rate at which input handbrake can rise and fall

  • idle_brake_input (float): [Read-Write] Idle Brake Input: How much to press the brake when the player has release throttle

  • inertia_tensor_scale (Vector): [Read-Write] Inertia Tensor Scale: Scales the vehicle’s inertia in each direction (forward, right, up)

  • is_editor_only (bool): [Read-Write] Is Editor Only: If true, the component will be excluded from non-editor builds

  • mass (float): [Read-Write] Mass: Mass to set the vehicle chassis to. It’s much easier to tweak vehicle settings when the mass doesn’t change due to tweaks with the physics asset. [kg]

  • mechanical_sim_enabled (bool): [Read-Write] Mechanical Sim Enabled

  • nav_agent_props (NavAgentProperties): [Read-Write] Nav Agent Props: Properties that define how the component can move.

  • on_component_activated (ActorComponentActivatedSignature): [Read-Write] On Component Activated: Called when the component has been activated, with parameter indicating if it was from a reset

  • on_component_deactivated (ActorComponentDeactivateSignature): [Read-Write] On Component Deactivated: Called when the component has been deactivated

  • pitch_input_rate (VehicleInputRateConfig): [Read-Write] Pitch Input Rate: Rate at which input pitch can rise and fall

  • plane_constraint_axis_setting (PlaneConstraintAxisSetting): [Read-Write] Plane Constraint Axis Setting: Setting that controls behavior when movement is restricted to a 2D plane defined by a specific axis/normal, so that movement along the locked axis is not be possible. see: SetPlaneConstraintAxisSetting

  • plane_constraint_normal (Vector): [Read-Write] Plane Constraint Normal: The normal or axis of the plane that constrains movement, if bConstrainToPlane is enabled. If for example you wanted to constrain movement to the X-Z plane (so that Y cannot change), the normal would be set to X=0 Y=1 Z=0. This is recalculated whenever PlaneConstraintAxisSetting changes. It is normalized once the component is registered with the game world. see: bConstrainToPlane, SetPlaneConstraintNormal(), SetPlaneConstraintFromVectors()

  • plane_constraint_origin (Vector): [Read-Write] Plane Constraint Origin: The origin of the plane that constrains movement, if plane constraint is enabled. This defines the behavior of snapping a position to the plane, such as by SnapUpdatedComponentToPlane(). see: bConstrainToPlane, SetPlaneConstraintOrigin().

  • primary_component_tick (ActorComponentTickFunction): [Read-Write] Primary Component Tick: Main tick function for the Component

  • replicates (bool): [Read-Write] Replicates: Is this component currently replicating? Should the network code consider it for replication? Owning Actor must be replicating first!

  • requires_controller_for_inputs (bool): [Read-Write] Requires Controller for Inputs: Bypass the need for a controller in order for the controls to be processed.

  • reverse_as_brake (bool): [Read-Write] Reverse as Brake: If true, the brake and reverse controls will behave in a more arcade fashion where holding reverse also functions as brake. For a more realistic approach turn this off

  • roll_input_rate (VehicleInputRateConfig): [Read-Write] Roll Input Rate: Rate at which input roll can rise and fall

  • sleep_slope_limit (float): [Read-Write] Sleep Slope Limit: Option to apply some aggressive sleep logic if slopes up Z is less than this value, i.e value = Cos(SlopeAngle) so 0.866 will sleep up to 30 degree slopes

  • sleep_threshold (float): [Read-Write] Sleep Threshold: Option to apply some aggressive sleep logic, larger number is more agressive, 0 disables

  • snap_to_plane_at_start (bool): [Read-Write] Snap to Plane at Start: If true and plane constraints are enabled, then the updated component will be snapped to the plane when first attached.

  • stabilize_control (VehicleStabilizeControlConfig): [Read-Write] Stabilize Control: Arcade style control of vehicle

  • steering_input_rate (VehicleInputRateConfig): [Read-Write] Steering Input Rate: Rate at which input steering can rise and fall

  • steering_setup (VehicleSteeringConfig): [Read-Write] Steering Setup: Transmission data

  • stop_threshold (float): [Read-Write] Stop Threshold: Auto-brake when absolute vehicle forward speed is less than this (cm/s)

  • suspension_enabled (bool): [Read-Write] Suspension Enabled

  • target_rotation_control (VehicleTargetRotationControlConfig): [Read-Write] Target Rotation Control: Arcade style direct control of vehicle rotation via torque force

  • throttle_input_rate (VehicleInputRateConfig): [Read-Write] Throttle Input Rate: Rate at which input throttle can rise and fall

  • thrusters (Array(VehicleThrustConfig)): [Read-Write] Thrusters: Optional thruster setup, use one or more as your main engine or as supplementary booster

  • tick_before_owner (bool): [Read-Write] Tick Before Owner: If true, after registration we will add a tick dependency to tick before our owner (if we can both tick). This is important when our tick causes an update in the owner’s position, so that when the owner ticks it uses the most recent position without lag. Disabling this can improve performance if both objects tick but the order of ticks doesn’t matter.

  • torque_control (VehicleTorqueControlConfig): [Read-Write] Torque Control: Arcade style direct control of vehicle rotation via torque force

  • transmission_setup (VehicleTransmissionConfig): [Read-Write] Transmission Setup: Transmission data

  • update_nav_agent_with_owners_collision (bool): [Read-Write] Update Nav Agent with Owners Collision: If set to true NavAgentProps’ radius and height will be updated with Owner’s collision capsule size

  • update_only_if_rendered (bool): [Read-Write] Update Only if Rendered: If true, skips TickComponent() if UpdatedComponent was not recently rendered.

  • updated_component (SceneComponent): [Read-Write] Updated Component: The component we move and update. If this is null at startup and bAutoRegisterUpdatedComponent is true, the owning Actor’s root component will automatically be set as our UpdatedComponent at startup. see: bAutoRegisterUpdatedComponent, SetUpdatedComponent(), UpdatedPrimitive

  • updated_primitive (PrimitiveComponent): [Read-Write] Updated Primitive: UpdatedComponent, cast as a UPrimitiveComponent. May be invalid if UpdatedComponent was null or not a UPrimitiveComponent.

  • use_acceleration_for_paths (bool): [Read-Write] Use Acceleration for Paths: If set, pathfollowing will control character movement via acceleration values. If false, it will set velocities directly.

  • use_fixed_braking_distance_for_paths (bool): [Read-Write] Use Fixed Braking Distance for Paths: If set, FixedPathBrakingDistance will be used for path following deceleration

  • velocity (Vector): [Read-Write] Velocity: Current velocity of updated component.

  • wheel_friction_enabled (bool): [Read-Write] Wheel Friction Enabled

  • wheel_setups (Array(ChaosWheelSetup)): [Read-Write] Wheel Setups: Wheels to create

  • wheel_trace_collision_responses (CollisionResponseContainer): [Read-Write] Wheel Trace Collision Responses

  • wheels (Array(ChaosVehicleWheel)): [Read-Write] Wheels: Our instanced wheels

  • wrong_direction_threshold (float): [Read-Write] Wrong Direction Threshold: Auto-brake when vehicle forward speed is opposite of player input by at least this much (cm/s)

  • yaw_input_rate (VehicleInputRateConfig): [Read-Write] Yaw Input Rate: Rate at which input yaw can rise and fall

classmethod break_wheel_snapshot(snapshot) -> (suspension_offset=float, wheel_rotation_angle=float, steering_angle=float, wheel_radius=float, wheel_angular_velocity=float)

Break Wheel Snapshot

Parameters

snapshot (WheelSnapshot) –

Returns

suspension_offset (float):

wheel_rotation_angle (float):

steering_angle (float):

wheel_radius (float):

wheel_angular_velocity (float):

Return type

tuple

classmethod break_wheel_status(status) -> (contact=bool, contact_point=Vector, phys_material=PhysicalMaterial, normalized_suspension_length=float, spring_force=float, slip_angle=float, is_slipping=bool, slip_magnitude=float, is_skidding=bool, skid_magnitude=float, skid_normal=Vector)

Break Wheel Status

Parameters

status (WheelStatus) –

Returns

contact (bool):

contact_point (Vector):

phys_material (PhysicalMaterial):

normalized_suspension_length (float):

spring_force (float):

slip_angle (float):

is_slipping (bool):

slip_magnitude (float):

is_skidding (bool):

skid_magnitude (float):

skid_normal (Vector):

Return type

tuple

classmethod break_wheeled_snapshot(snapshot) -> (transform=Transform, linear_velocity=Vector, angular_velocity=Vector, selected_gear=int32, engine_rpm=float, wheel_snapshots=Array(WheelSnapshot))

Break Wheeled Snapshot

Parameters

snapshot (WheeledSnaphotData) –

Returns

transform (Transform):

linear_velocity (Vector):

angular_velocity (Vector):

selected_gear (int32):

engine_rpm (float):

wheel_snapshots (Array(WheelSnapshot)):

Return type

tuple

enable_mechanical_sim(state) → None

Enable or completely bypass the ProcessMechanicalSimulation call

Parameters

state (bool) –

enable_suspension(state) → None

Enable or completely bypass the ApplySuspensionForces call

Parameters

state (bool) –

enable_wheel_friction(state) → None

Enable or completely bypass the ApplyWheelFrictionForces call

Parameters

state (bool) –

get_engine_max_rotation_speed() → float

Get current engine’s max rotation speed

Return type

float

get_engine_rotation_speed() → float

Get current engine’s rotation speed

Return type

float

get_num_wheels() → int32

Get Num Wheels

Return type

int32

get_snapshot() → WheeledSnaphotData

Grab a snapshot of the vehicle instance dynamic state

Return type

WheeledSnaphotData

get_wheel_state(wheel_index) → WheelStatus

Get a wheels current simulation state

Parameters

wheel_index (int32) –

Return type

WheelStatus

classmethod make_wheel_snapshot(suspension_offset, wheel_rotation_angle, steering_angle, wheel_radius, wheel_angular_velocity) → WheelSnapshot

Make Wheel Snapshot

Parameters

  • suspension_offset (float) –

  • wheel_rotation_angle (float) –

  • steering_angle (float) –

  • wheel_radius (float) –

  • wheel_angular_velocity (float) –

Return type

WheelSnapshot

classmethod make_wheel_status(contact, phys_material, normalized_suspension_length, spring_force, slip_angle, is_slipping, slip_magnitude, is_skidding, skid_magnitude) -> (WheelStatus, contact_point=Vector, skid_normal=Vector)

Make Wheel Status

Parameters
Returns

contact_point (Vector):

skid_normal (Vector):

Return type

tuple

classmethod make_wheeled_snapshot(transform, linear_velocity, angular_velocity, selected_gear, engine_rpm, wheel_snapshots) → WheeledSnaphotData

Make Wheeled Snapshot

Parameters
Return type

WheeledSnaphotData

set_abs_enabled(wheel_index, enabled) → None

Set ABSEnabled

Parameters

  • wheel_index (int32) –

  • enabled (bool) –

set_affected_by_brake(wheel_index, enabled) → None

Set Affected by Brake

Parameters

  • wheel_index (int32) –

  • enabled (bool) –

set_affected_by_engine(wheel_index, enabled) → None

Set Affected by Engine

Parameters

  • wheel_index (int32) –

  • enabled (bool) –

set_affected_by_handbrake(wheel_index, enabled) → None

Set Affected by Handbrake

Parameters

  • wheel_index (int32) –

  • enabled (bool) –

set_affected_by_steering(wheel_index, enabled) → None

Set Affected by Steering

Parameters

  • wheel_index (int32) –

  • enabled (bool) –

set_differential_front_rear_split(front_rear_slpit) → None

Set Differential Front Rear Split

Parameters

front_rear_slpit (float) –

set_downforce_coefficient(downforce_coeff) → None

Set Downforce Coefficient

Parameters

downforce_coeff (float) –

set_drag_coefficient(drag_coeff) → None

Set Drag Coefficient

Parameters

drag_coeff (float) –

set_max_engine_torque(torque) → None

change handling via blueprint at runtime

Parameters

torque (float) –

set_snapshot(snapshot_in) → None

Set snapshot of vehicle instance dynamic state

Parameters

snapshot_in (WheeledSnaphotData) –

set_traction_control_enabled(wheel_index, enabled) → None

Set Traction Control Enabled

Parameters

  • wheel_index (int32) –

  • enabled (bool) –

set_wheel_class(wheel_index, wheel_class) → None

Set Wheel Class

Parameters

  • wheel_index (int32) –

  • wheel_class (type(Class)) –

set_wheel_friction_multiplier(wheel_index, friction) → None

Set Wheel Friction Multiplier

Parameters

  • wheel_index (int32) –

  • friction (float) –

set_wheel_handbrake_torque(wheel_index, torque) → None

Set Wheel Handbrake Torque

Parameters

  • wheel_index (int32) –

  • torque (float) –

set_wheel_max_brake_torque(wheel_index, torque) → None

Set Wheel Max Brake Torque

Parameters

  • wheel_index (int32) –

  • torque (float) –

set_wheel_max_steer_angle(wheel_index, angle_degrees) → None

Set Wheel Max Steer Angle

Parameters

  • wheel_index (int32) –

  • angle_degrees (float) –

set_wheel_radius(wheel_index, radius) → None

Set Wheel Radius

Parameters

  • wheel_index (int32) –

  • radius (float) –

set_wheel_slip_graph_multiplier(wheel_index, multiplier) → None

Set Wheel Slip Graph Multiplier

Parameters

  • wheel_index (int32) –

  • multiplier (float) –

property wheels

[Read-Only] Wheels: Our instanced wheels

Type

(Array(ChaosVehicleWheel))