LlRequestPermissions

Looking for the current API? Open the llRequestPermissions reference →

Wiki description

Ask agent for permissions to run certain classes of functions.

Function guidance

Script execution continues without waiting for a response. When a response is given, a run_time_permissions event is put in the event queue.

Specification

Constants		Action	Category	Granter	Automatically granted when…
PERMISSION_DEBIT	0x2	take money from agent's account	Money	Owner
PERMISSION_TAKE_CONTROLS	0x4	take agent's controls	Control	Anyone	sat on, attached
PERMISSION_TRIGGER_ANIMATION	0x10	start or stop Animations on agent	Animation	Anyone	sat on, attached
PERMISSION_ATTACH	0x20	attach/detach from agent	Attachment	Owner or Anyone	attached
PERMISSION_CHANGE_LINKS	0x80	change links	Link	Owner
PERMISSION_TRACK_CAMERA	0x400	track the agent's camera position and rotation	Camera	Anyone	sat on, attached
PERMISSION_CONTROL_CAMERA	0x800	control the agent's camera (must be sat on or attached; automatically revoked on stand or detach)	Camera	Anyone	sat on, attached
PERMISSION_TELEPORT	0x1000	teleport the agent	Teleport	AnyonePERMISSION_TELEPORT cannot be held by temporary attachments.
PERMISSION_SILENT_ESTATE_MANAGEMENT	0x4000	manage estate access without notifying the owner of changes	Estate	Owner
PERMISSION_OVERRIDE_ANIMATIONS	0x8000	configure the overriding of default animations on agent	Animation	Anyone	attached
PERMISSION_RETURN_OBJECTS	0x10000	Used by llReturnObjectsByOwner and llReturnObjectsByID to return objects from parcels	Cleanup	Owner, Group Owner
PERMISSION_PRIVILEGED_LAND_ACCESS	0x80000	Grants the script privileged access to land parcel functions, such as parcel sale. Used by llSetParcelForSale.	Land	Owner
PERMISSION_GAME_CONTROL	0x100000	Permission to receive game_control input events.	Control	Anyone	sat on, attached

Caveats

• A dialog is presented to the agent to grant these permissions except when granted automatically as shown in the table above.
• If object is attached to agent, "automatic" permissions are granted without notification upon request.
• Permissions persist across state changes.
• Regardless of whether granting is automatic, you should always use the run_time_permissions event. Granting permissions takes time, and you shouldn't assume it's completed until the run_time_permissions handler gets invoked.
• The menu-option "Stop Animating Me" will release certain permissions (PERMISSION_TRIGGER_ANIMATION and PERMISSION_OVERRIDE_ANIMATIONS), if the script which holds these permissions is in the same region as the agent, and the script is not attached to the permission granter.
• Permissions do not accumulate.
  • If a permission was requested with a previous call to this function and granted, then in subsequent call was not requested, that permission is released (lost).
  • To request two or more permissions at the same time, use the bitwise OR (|) operator, e.g.:

    llRequestPermissions(AvatarID, PERMISSION_TAKE_CONTROLS | PERMISSION_TRIGGER_ANIMATION)

• Permissions are requested and granted separately for each script, even if they are located in the same object.
• It is currently not possible to request no permissions at all (see Issues below); as a workaround llResetScript can be used.
• Scripts may hold permissions for only one agent at a time. To hold permissions for multiple agents you must use more than one script.
• The result of granting permissions affects the return of llGetPermissions and llGetPermissionsKey immediately, despite the run_time_permissions event being queued, or dropped if the object's event queue is full.
• Permission request dialogs never time out.
• If a script makes two permission requests, whichever response is last is considered the granted permissions.
• The viewer limits permission requests from any agent to any other agent to 5 dialogs in 10 seconds.
• Permission requests and changing state ...
  • Requesting a permission in one state, then changing state before the agent response, will cause run_time_permissions to be fired in the new state once the agent responds.
  • Requesting only auto-granted permissions in one state, then immediately changing state, will never fire run_time_permissions.

Examples

Request permission to animate an avatar

default
{
    touch_start(integer detected)
    {
        llRequestPermissions(llDetectedKey(0), PERMISSION_TRIGGER_ANIMATION);
    }
    run_time_permissions(integer perm)
    {
        if (perm & PERMISSION_TRIGGER_ANIMATION)
        {
            llStartAnimation("sit");
            llOwnerSay("animation will end in 5 seconds");
            llSetTimerEvent(5.0);
        }
    }
    timer()
    {
        llSetTimerEvent(0.0);
        llStopAnimation("sit");
    }
}

To request two (or more) permissions at the same time, use the bitwise OR (|) operator.

llRequestPermissions(AvatarID, PERMISSION_TAKE_CONTROLS | PERMISSION_TRIGGER_ANIMATION);

: - or -

integer perms = PERMISSION_TAKE_CONTROLS | PERMISSION_TRIGGER_ANIMATION;
llRequestPermissions(AvatarID, perms);

Notes

When an agent grants a script non-automatic permissions they will receive a notification (in chat) of

• The name of the object that contains the script that has been granted perms,
• The name of the owner of the object,
• The location of the object in the order Region name at position, and
• A statement of what permissions were granted.

If the script that holds the permissions is in a child prim the name will be that of the child prim (not the object (root)) and position will be its local position (relative to its root).

See also: functions

llGetPermissions — Get the permissions granted

llGetPermissionsKey — Get the avatar who granted permissions.

See also: events

run_time_permissions — Permission receiver event

See also: articles

Script permissions

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-1006

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

{{Issues|SVC-1006|Unable to release [[:Category:LSL_Permissions/Script|script permissions]]|type=bug|status=open|resolution=unres}}

Template:Issues/SVC-8067

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

{{Issues|SVC-8067|Improved Permissions Handling|type=nf}}

Template:LSL Function/avatar

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

{{LSL Injection Test}}<noinclude>{{Multi-lang|category=LSL}}</noinclude>{{#if:

{{#vardefine:p_{{{1|none}}}_desc|avatar {{#if:{{{group|}}}|or group}} {{HoverLink|UUID|Universally Unique Identifier}} {{#if:{{{sim|}}}{{{region|}}}|that is in the same [[region]] {{#ifeq:{{{sim|}}}{{{region|}}}|known|or is otherwise known to the region{{Footnote|handle=known}}}}}}}}

{{#vardefine:p_{{{1|none}}}_hover|avatar {{#if:{{{group|}}}|or group}} UUID {{#if:{{{sim|}}}{{{region|}}}|that is in the same region {{#ifeq:{{{sim|}}}{{{region|}}}|known|or is otherwise known to the region}}}}}}

<includeonly>
{{#if:{{{nc|}}}||{{#vardefine:hidden-text|{{#var:hidden-text}}
{{#if:{{#pos:{{#var:moded}}|r}}{{#pos:{{#var:moded}}|u}}||{{LSLC|Avatar/As A Parameter||{{#var:lang}}}}}}
}}}}
</includeonly>

}}<noinclude>
{| {{Prettytable}}
|-{{Hl2}}
! #var
! value
|-
{{VarPair|p_{{{1|none}}}_desc}}
|-
{{VarPair|p_{{{1|none}}}_hover}}
|}
</noinclude>

Original wiki source

Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.

From the Second Life Wiki

Community documentation adapted from LlRequestPermissions, by Linden Research, Inc. and contributing residents.View contributors and history.

Built from these wiki pages, as imported:

• LlRequestPermissions (revision 1210161, 2021-08-03)
• Template:LSL Constants/Permissions (revision 1219061, 2026-09-16)
• Template:Issues/SVC-1006 (revision 240542, 2009-02-16)
• Template:Issues/SVC-8067 (revision 1170734, 2012-07-19)
• Template:LSL Function/avatar (revision 1179236, 2013-06-15)

Licensed under CC BY-SA 3.0. Last wiki edit: 2026-09-16.Formatting and links have been adapted for this site; API metadata follows the LSL definitions.