llSetStatus

function

Function syntax

llSetStatus(

integer status,// Bitmask representing the STATUS_* flag(s) to change. Values: ObjectStatusParam
integer value// Boolean. If TRUE, enables the status; if FALSE, disables it.

);

Energy: 10

Sets the object status attributes indicated in the status} mask to value

llSetStatus(0, 0);

Specification

Constants	Value	Default	Description
`STATUS_PHYSICS`	0x001	`FALSE`	Object is physical
`STATUS_ROTATE_X`	0x002	`TRUE`	Can turn along this axis (physical objects only)
`STATUS_ROTATE_Y`	0x004	`TRUE`	Can turn along this axis (physical objects only)
`STATUS_ROTATE_Z`	0x008	`TRUE`	Can turn along this axis (physical objects only)
`STATUS_PHANTOM`	0x010	`FALSE`	Object is phantom
`STATUS_SANDBOX`	0x020	`FALSE`	Keep object within 10 meters and in the same region
`STATUS_BLOCK_GRAB`	0x040	`FALSE`	Prevent click-and-drag movement on the root prim

Constants	Value	Default	Description
`STATUS_DIE_AT_EDGE`	0x080	`FALSE`*	Delete and do not return object if it goes off world
`STATUS_RETURN_AT_EDGE`	0x100	`FALSE`	Return object to owner if it goes off world
STATUS_CAST_SHADOWS	0x200	`TRUE`	not currently used
`STATUS_BLOCK_GRAB_OBJECT`	0x400	`FALSE`	Prevent click-and-drag movement on all prims in the object
`STATUS_DIE_AT_NO_ENTRY`	0x800	`FALSE`†	Delete and do not return object if it cannot enter a parcel

^{* STATUS_DIE_AT_EDGE - If the object is rezzed by a script, the default is TRUE}

^{† STATUS_DIE_AT_NO_ENTRY - No-copy objects ignore this flag and remain in-world}

Caveats

Status is an object attribute; all prims in an object share the same status.
Except for STATUS_BLOCK_GRAB, this only affects the prim the script is in, child prims in linked objects will not be affected.
Use STATUS_BLOCK_GRAB_OBJECT to block grabbing of a link_set.
Setting STATUS_PHYSICS fails silently in attached objects. ~ svc 6549
The STATUS_ROTATE_X, STATUS_ROTATE_Y and STATUS_ROTATE_Z flags all require that the object first be made physical to have any effect.

Examples

Example 1

default
{
    state_entry()
    {
        llSetStatus( STATUS_DIE_AT_EDGE | STATUS_PHYSICS, TRUE);
        llSetStatus( STATUS_ROTATE_X | STATUS_ROTATE_Y, FALSE);
    }
}

Known issues

From the issue templates included by the wiki article:

SVC-6549 (bug): llSetStatus can’t change STATUS_PHYSICS of an attachment despite the status being preserved between attach & drop
SVC-5531 (bug): llGetStatus(STATUS_ROTATE_Z); will not work on child prims on freshly rezzed objects.
SVC-1773 (bug): STATUS_BLOCK_GRAB only affects individual prims in a linkset
SVC-4197 (fs): Create STATUS_TRANSLATE_* flags for llSetStatus
SVC-5723 (fs): New constant STATUS_BLOCK_SIT
SCR-203 (nf): <code>STATUS_PARCEL_BOUND</code> status to prevent a physical object from being able to leave the bounds of the current parcel.