Constraints Actuator

See also

See the Python reference of this logic brick in KX_ConstraintActuator.

The Constraints Actuator adds a constraint to the location or orientation of an object. This is useful for controlling the physics of the object in-game.

Properties

Constraint Mode
Constraint type to use. Each is described below.

Force Field Constraint

Create a force field buffer zone along one axis of the object.

../../../../_images/logic-actuators-types-constraint-forcefield.png

Force Field Constraint.

Damping
Damping factor of the Fh spring force.
Distance
Height of Fh area.
Rot Fh
Make game object axis parallel to the normal of trigger object.
Direction
Axis in which to create force field (can be + or -, or None).
Force
Force value to be used.
N
When on, use a horizontal spring force on slopes.
M/P
Trigger on another Object will be either Material (M) or Property (P).
Property
Property/Material that triggers the Force Field constraint (blank for all Properties/Materials).
Per
Persistence button When on, force field constraint always looks at Property/Material; when off, turns itself off if it cannot find the Property/Material.
Time
Number of frames for which constraint remains active.
RotDamp
Damping factor for rotation.

Orientation Constraint

Constrain the specified axis in the Game to a specified direction in the World axis.

../../../../_images/logic-actuators-types-constraint-orientation.png

Orientation Constraint.

Direction
Game axis to be modified (X, Y, Z or none).
Damping
Delay (frames) of the constraint response.
Time
Time (frames) for the constraint to remain active.
Reference Direction
Reference direction (global coordinates) for the specified game axis.
Min Angle
Minimum angle for the axis modification.
Max Angle
Maximum angle for the axis modification.

Distance Constraint

Maintain the distance the Game Object has to be from a surface.

../../../../_images/logic-actuators-types-constraint-distance.jpg

Distance Constraint.

Direction
Axis Direction (X, Y, Z, -X, -Y, -Z, or None).
L
If on, use local axis (otherwise use World axis).
N
If on, orient the Game Object axis with the mesh normal.
Range
Maximum length of ray used to check for Material/Property on another game object.
Force Distance
Distance to be maintained between object and the Material/Property that triggers the Distance Constraint.
Damping
Delay (frames) of the constraint response.
M/P
Trigger on another Object will be either Material (M) or Property (P).
Property
Property/Material that triggers the Force Field constraint (blank for all Properties/Materials).
Per
Persistence button: When on, force field constraint always looks at Property/Material; when off, turns itself off if it cannot find the Property/Material.
Time
Number of frames for which constraint remains active.
Rotation Damping
Damping factor for rotation.

Location Constraint

Limit the position of the Game Object within one World Axis direction. To limit movement within an area or volume, use two or three constraints.

../../../../_images/logic-actuators-types-constraint-location.png

Location Constraint.

Limit
Axis in which to apply limits (LocX, LocY, LocZ or none).
Min
Minimum limit in specified axis (Blender Units).
Max
Maximum limit in specified axis (Blender Units).
Damping
Delay (frames) of the constraint.

Examples