Edit Object Actuator

See also

See the Python reference of this logic brick in KX_SCA_AddObjectActuator, KX_SCA_DynamicActuator, KX_SCA_EndObjectActuator and KX_SCA_ReplaceMeshActuator.

The Edit Object Actuator allows the user to edit settings of objects in-game. In example edits the object’s mesh, adds objects, or destroys them. It can also change the mesh of an object (and soon also recreate the collision mesh).

Properties

Edit Object
How the object is modified, each is described below.

Dynamics

Provides a menu of Dynamic Operations to set up dynamics options for object.

../../../../_images/logic-actuators-types-edit_object-dynamics.png

Edit Object: Dynamics.

Set Mass
Enables the user to set the mass of the current object for Physics.
Disable Rigid Body
Disables the Rigid Body state of the object – disables collision.
Enable Rigid Body
Disables the Rigid Body state of the object – enables collision.
Suspend Dynamics
Suspends the object dynamics (object velocity).
Restore Dynamics
Resumes the object dynamics (object velocity).

Track To

Makes the object “look at” another object, in 2D or 3D. The Y axis is considered the front of the object.

../../../../_images/logic-actuators-types-edit_object-track_to.jpg

Edit Object: Track To.

Object
Object to follow.
Time
Number of frames it will take to turn towards the target object.
3D Button (toggle).
Enable 2D (X, Y) or 3D (X, Y, Z) tracking.

Replace Mesh

Replace mesh with another. Both the mesh and/or its physics can be replaced, together or independently.

../../../../_images/logic-actuators-types-edit_object-replace_mesh.jpg

Edit Object: Replace Mesh.

Mesh
Name of mesh to replace the current mesh.
Gfx Button
Replace visible mesh.
Phys Button
Replace physics mesh (not compound shapes).

End Object

Destroy the current object (note, debug properties will display error Zombie Object in console).

../../../../_images/logic-actuators-types-edit_object-end_object.png

Edit Object: End Object.

Add Object

Adds an object at the center of the current object. The object that is added needs to be on another, hidden, layer.

../../../../_images/logic-actuators-types-edit_object-add_object.png

Edit Object: Add Object.

Object
The name of the object that is going to be added.
Time
The time (in frames) the object stays alive before it disappears. Zero makes it stay forever.
Linear Velocity
Linear Velocity, works like in the motion actuator but on the created object instead of the object itself. Useful for shooting objects, create them with an initial speed.
Angular Velocity
Angular velocity, works like in the motion actuator but on the created object instead of the object itself.