KX_SCA_AddObjectActuator(SCA_IActuator)

base class — SCA_IActuator

class bge.types.KX_SCA_AddObjectActuator(SCA_IActuator)

Edit Object Actuator (in Add Object Mode)

Warning

An Add Object actuator will be ignored if at game start, the linked object doesn’t exist (or is empty) or the linked object is in an active layer.

Error: GameObject 'Name' has a AddObjectActuator 'ActuatorName' without object (in 'nonactive' layer)
object

the object this actuator adds.

Type:KX_GameObject or None
objectLastCreated

the last added object from this actuator (read-only).

Type:KX_GameObject or None
time

the lifetime of added objects, in frames. Set to 0 to disable automatic deletion.

Type:integer
linearVelocity

the initial linear velocity of added objects.

Type:list [vx, vy, vz]
angularVelocity

the initial angular velocity of added objects.

Type:list [vx, vy, vz]
instantAddObject()

adds the object without needing to calling SCA_PythonController.activate()

Note

Use objectLastCreated to get the newly created object.