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](../../../../_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](../../../../_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](../../../../_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](../../../../_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](../../../../_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.