LlSetPos

Wiki description

Moves the object or primitive towards pos without using physics.

Function notes

Movement is capped to 10m per call for unattached root prims.^{Unless you exploit the undocumented warpPos bug.}

Specification

This function is available for nonphysical root prims and all child prims. It has no effect on the root prim if the object is physical.

Coordinate Frame

Root prims (or single prim objects)
- Attached
  - pos is a local coordinate relative to the attach point.
- Not attached
  - pos is a region coordinate.
Child prims (non root prims)
- pos is a local coordinate relative to the root prim.

Caveats

Because of the intermixing of local and regional coordinates with this function, when a prims position is wanted it is best to use llGetLocalPos.
This function does not work in the root prim of physical objects. Use a physical function like llMoveToTarget instead.
If you have explicitally set your object as "static obstacle" for pathfinding , the function will fail with the error in the debug channel:
- "Unable to set prim position or scale: object contributes to the navmesh."
The function cannot move a world object below the region ground level, and the midpoint of the root will be snapped to the ground instead.

Examples

//Move the object up 1m when someone touches it.
default {
     touch_start(integer i) {
          llSetPos(llGetPos() + <0,0,1>);
     }
}
// to bypass the small movement bug use this
// - created by Madpeter Zond
// notes: it does not check if the movement would go out of limit range for linked prims
llSetLocalPos(vector offset)
{
    vector save = offset;
    if(offset.x < 0.0) offset.x -= 1;
    else offset.x += 1;
    if(offset.y < 0.0) offset.y -= 1;
    else offset.y += 1;
    if(offset.z < 0.0) offset.z -= 1;
    else offset.z += 1;
    llSetPos(offset);
    llSetPos(save);    
}

Notes

Multiple movement commands can be chained together with llSetPrimitiveParams and PRIM_POSITION. The advantage of doing this is that the script only sleeps once per function call instead of once per movement.

Shared wiki helpers

The original page also injects shared parameter notes, caveats or issue information through these helpers. Their conditional MediaWiki logic is not reproduced here; inspect the preserved helper source for additional material.

Template:Issues/SVC-1945

Original shared helper source (conditional wiki logic is not evaluated)

{{Issues|SVC-1945|[[llSetPos]]() doesn't change position for small vectors when called in attachments on Havok4 unless interacted with|type=bug}}

Template:LSL Function/position