BreakObject

This function breaks a specific object.

ADDED/UPDATED IN VERSION 1.6.0 r22489:

This function is now also available on the server side.

[[{{{image}}}|link=|]]	Note: Only breakable objects can be broken.

Syntax

bool breakObject ( object theObject )

OOP Syntax Help! I don't understand this!

Method: object:break(...)

Required Arguments

• theObject: an object element

Returns

• true if the object was successfully broken.
• false if the object is not breakable, or a wrong object was given.

Example

This example checks if the object created is breakable and if it is then breaks it.

addCommandHandler("createObj",
function(command, id)
    local x, y, z = getElementPosition(localPlayer)
    local object = createObject (id, x, y, z)
    if (id) then
        if isObjectBreakable(object) then
            breakObject(object)
        end
    end
end
)

See Also

• createObject
ADDED/UPDATED IN VERSION 1.6.0 r22489:
breakObject
• getObjectScale
• moveObject
ADDED/UPDATED IN VERSION 1.6.0 r22708:
respawnObject
toggleObjectRespawn
isObjectRespawnable
• setObjectScale
ADDED/UPDATED IN VERSION 1.6.0 r22430:
isObjectMoving
ADDED/UPDATED IN VERSION 1.6.0 r21765:
isObjectBreakable
setObjectBreakable
• stopObject
• getObjectMass
• getObjectProperty
• setObjectMass
• setObjectProperty