Permissions

Request and inspect permissions for avatar and scripted actions.

Feature: Avatars

What do you want to do?

llRequestPermissions(key agent, integer permissions)Requests permissions (a bitfield specified by permissions) from the agent in the same region, calling run_time_permissions if granted. This call does not pause script execution.integer llGetPermissions()Returns an integer bitfield representing the permissions (PERMISSION_*) currently granted to the script.key llGetPermissionsKey()Returns the key (UUID) of the avatar that last granted or declined permissions to the script, or NULL_KEY if the permissions request was ignored or cancelled.

Reference

Find topic entries

28 topic entries

• llClearCameraParams()function

  Resets all camera parameters to default values and turns off scripted camera control. Requires the PERMISSION_CONTROL_CAMERA runtime permission (automatically granted for attached or sat-on objects).

• llForceMouselook(integer mouselook)function

  Sets whether any avatar sitting on this prim is forced into mouselook mode. Setting mouselook to TRUE forces the mode; FALSE (default) allows the avatar to keep their current camera mode.

• string llGetAnimation(key avatar)function

  Returns a string representing the name of the currently playing locomotion animation for the specified avatar.

• list llGetAnimationList(key avatar)function

  Returns a list of keys (UUIDs) representing all active animations currently playing on the specified avatar.

• string llGetAnimationOverride(string anim_state)function

  Returns a string representing the name of the animation currently overriding the specified anim_state. Requires the PERMISSION_OVERRIDE_ANIMATIONS or PERMISSION_TRIGGER_ANIMATION runtime permission.

• float llGetCameraAspect()function

  Returns a float representing the camera's current aspect ratio (width/height) of the agent who granted PERMISSION_TRACK_CAMERA. Returns 0.0 if permissions are not granted.

• float llGetCameraFOV()function

  Returns a float representing the camera's current field of view (FOV) in radians of the agent who granted PERMISSION_TRACK_CAMERA. Returns 0.0 if permissions are not granted.

• vector llGetCameraPos()function

  Returns a vector representing the camera's current position in region coordinates of the agent who granted PERMISSION_TRACK_CAMERA. Returns ZERO_VECTOR if permissions are not granted.

• rotation llGetCameraRot()function

  Returns a rotation representing the camera's current orientation of the agent who granted PERMISSION_TRACK_CAMERA. Returns ZERO_ROTATION if permissions are not granted.

• integer llGetPermissions()function

  Returns an integer bitfield representing the permissions (PERMISSION_*) currently granted to the script.

• key llGetPermissionsKey()function

  Returns the key (UUID) of the avatar that last granted or declined permissions to the script, or NULL_KEY if the permissions request was ignored or cancelled.

• integer llGiveMoney(key destination, integer amount)function

  Transfers the specified amount of L$ from the script owner to the destination avatar. Silently fails if the PERMISSION_DEBIT permission has not been granted. Returns 0 (use llTransferLindenDollars to match transactions to transaction_result events).

• llReleaseControls()function

  Stops taking inputs (previously acquired via llTakeControls) from the avatar, dequeuing any remaining control events and revoking the PERMISSION_TAKE_CONTROLS permission.

• llRequestExperiencePermissions(key agent, string name)function

  Requests permission from the specified agent to participate in the experience. These permissions are persistent and apply grid-wide across all scripts in the experience, automatically triggering experience_permissions or experience_permissions_denied.

• llRequestPermissions(key agent, integer permissions)function

  Requests permissions (a bitfield specified by permissions) from the agent in the same region, calling run_time_permissions if granted. This call does not pause script execution.

• llResetAnimationOverride(string anim_state)function

  Resets the animation override for anim_state to its default value (use 'ALL' to reset all states). Requires the PERMISSION_OVERRIDE_ANIMATIONS permission.

• llSetAnimationOverride(string anim_state, string anim)function

  Overrides the default animation for anim_state with anim (which must be in the object's inventory or a built-in animation). Requires the PERMISSION_OVERRIDE_ANIMATIONS permission.

• llSetCameraParams(list rules)function

  Sets multiple camera parameters simultaneously using the list of rules. Requires the PERMISSION_CONTROL_CAMERA runtime permission.

• llStartAnimation(string anim)function

  Starts the animation anim (inventory or built-in) on the avatar who granted the script the PERMISSION_TRIGGER_ANIMATION permission (automatically granted for attached or sat-on objects).

• llStopAnimation(string anim)function

  Stops the specified animation anim (inventory, built-in, or UUID) on the avatar who granted the script the PERMISSION_TRIGGER_ANIMATION permission (automatically granted for attached or sat-on objects).

• llTakeControls(integer controls, integer accept, integer pass_on)function

  Intercepts inputs (keyboard/mouse clicks) from the agent, specifically those specified by controls. The boolean accept determines if events are generated, and pass_on determines if inputs also perform their default functions. Requires the PERMISSION_TAKE_CONTROLS runtime permission.

• llTeleportAgent(key agent, string landmark, vector position, vector look_at)function

  Teleports the owning agent (who must grant PERMISSION_TELEPORT) to a landmark in the object's inventory. If landmark is empty, teleports them to position within the current region. Upon arrival, the agent is turned to face look_at. Can only teleport the owner.

• llTeleportAgentGlobalCoords(key agent, vector global_coordinates, vector region_coordinates, vector look_at)function

  Teleports the owning agent (who must grant PERMISSION_TELEPORT) to region_coordinates within a target region specified by global_coordinates. Upon landing, the agent faces the direction look_at. Can only teleport the owner.

• key llTransferLindenDollars(key destination, integer amount)function

  Transfers amount of L$ from the script owner to the destination avatar, requiring the PERMISSION_DEBIT permission. Returns a key query handle matching the resulting transaction_result event.

• vector llWorldPosToHUD(vector world_pos)function

  Returns the local position vector that places the center of the HUD object directly over the world coordinate world_pos as viewed by the current camera. Requires the PERMISSION_TRACK_CAMERA runtime permission.

• run_time_permissions(integer perm)event

  Triggered when an agent grants or denies runtime permissions requested by llRequestPermissions. Passes the active integer permissions bitfield perm (returns 0 if no permissions are currently granted).

• experience_permissions(key agent_id)event

  Triggered when the agent specified by agent_id approves an experience permissions request (interactively or automatically if previously approved).

• experience_permissions_denied(key agent_id, integer reason)event

  Triggered when the agent specified by agent_id denies experience permissions, or when permission is blocked for other reasons (specified by the error code reason).