Avatar Target

Inspect avatars and find APIs that act on them.

Feature: Avatars

What do you want to do?

integer llGetAgentInfo(key id)Returns an integer bitfield containing status information about the agent specified by id (such as AGENT_FLYING, AGENT_ATTACHMENTS, AGENT_SITTING, etc.).list llGetAgentList(integer scope, list options)Requests a list of avatar UUID keys for agents currently in the region, limited by scope. Returns a list of keys or a list containing an error message string.string llGetDisplayName(key id)Returns the display name string of the avatar specified by id if they are in the region or cached; returns an empty string otherwise (use llRequestDisplayName if the avatar is absent).

Reference

Find topic entries

54 topic entries

• integer llAgentInExperience(key agent)function

  Returns TRUE if the specified agent is in the experience and the experience can run in the current region/location; returns FALSE otherwise.

• llAttachToAvatar(integer attach_point)function

  Attaches the object to the avatar who has granted the PERMISSION_ATTACH permission. Takes the object into the user's inventory and attaches it at attach_point.

• llAttachToAvatarTemp(integer attach_point)function

  Attaches the object temporarily to an avatar who has granted the PERMISSION_ATTACH permission. No permanent inventory is created, and the object disappears on detach or disconnect. Can be used on non-owners (changing ownership to the wearer).

• key llAvatarOnLinkSitTarget(integer link)function

  Returns the UUID of the avatar seated on the specified link's sit target, or NULL_KEY if no avatar is sitting there.

• key llAvatarOnSitTarget()function

  Returns the UUID of the avatar seated on the prim's sit target (defined via llSitTarget), or NULL_KEY if no avatar is sitting there or the prim lacks a sit target.

• 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).

• llDetachFromAvatar()function

  Detaches the object containing the script from the avatar. Requires the PERMISSION_ATTACH runtime permission (automatically granted to attached objects). Note that the detached object is completely removed from the region and not dropped on the ground.

• key llDetectedOwner(integer number)function

  Returns the key (UUID) of the owner of the detected object specified by number. Returns an invalid key if number is not a valid index.

• 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.

• integer llGetAgentInfo(key id)function

  Returns an integer bitfield containing status information about the agent specified by id (such as AGENT_FLYING, AGENT_ATTACHMENTS, AGENT_SITTING, etc.).

• string llGetAgentLanguage(key avatar)function

  Returns a string representing the language code of the preferred interface language set by the avatar.

• list llGetAgentList(integer scope, list options)function

  Requests a list of avatar UUID keys for agents currently in the region, limited by scope. Returns a list of keys or a list containing an error message string.

• vector llGetAgentSize(key avatar)function

  Returns a vector representing the estimated bounding box size of the specified avatar, or ZERO_VECTOR if they are not in the same region.

• 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.

• list llGetAttachedList(key avatar)function

  Returns a list of object keys (UUIDs) worn by the specified avatar, in the order they were attached. HUDs are not included because they are neither public nor visible. Returns a list containing an error message string on failure.

• list llGetAttachedListFiltered(key avatar, list options)function

  Returns a list of object keys (UUIDs) worn by the specified avatar, in the order they were attached, filtered by options. Returns a list containing an error message string on failure.

• 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.

• string llGetDisplayName(key id)function

  Returns the display name string of the avatar specified by id if they are in the region or cached; returns an empty string otherwise (use llRequestDisplayName if the avatar is absent).

• integer llGetGameControlMode(key id)function

  Returns a GAME_CONTROL_MODE_* integer indicating the current game-control mode for the avatar specified by id.

• list llGetGameControlModeAxes(key id)function

  Returns a list of floats representing the modal axes for the current game-control mode of the avatar specified by id. Element count and index meanings vary by mode; use the GAME_CONTROL_AXIS_* constants as indices.

• integer llGetGameControlModeButtons(key id)function

  Returns a bitmask of the modal buttons currently active for the current game-control mode of the avatar specified by id. Bit meanings vary by mode; use the GAME_CONTROL_BUTTON_* constants as masks.

• 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.

• string llGetUsername(key id)function

  Returns a string representing the unique username of the avatar specified by id if they are connected to the region or cached; returns an empty string otherwise (use llRequestUsername if the avatar is absent).

• list llGetVisualParams(key agentid, list params)function

  Returns a list containing the values of the visual parameters requested in params for the agent specified by agentid.

• 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).

• integer llIsFriend(key agent_id)function

  Returns TRUE if agent_id and the owner of the script are friends, and FALSE otherwise.

• key llName2Key(string name)function

  Requests the key (UUID) of the avatar name in the current region. Returns NULL_KEY if no matching agent is present. Formats are 'First Last' or 'first.last' (assumes 'Resident' if last name is omitted; case-insensitive).

• llReleaseControls()function

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

• integer llReplaceAgentEnvironment(key agent_id, float transition, string environment)function

  Replaces the region and parcel environment seen by the specified agent_id as part of an experience, transitioning the settings over transition seconds. Passing NULL_KEY or an empty string for environment restores defaults.

• key llRequestAgentData(key id, integer data)function

  Asynchronously requests the specified data category (DATA_*) about the agent id. Triggers a dataserver event with the results and returns a key query handle.

• key llRequestDisplayName(key id)function

  Asynchronously requests the display name of the agent specified by id, triggering a dataserver event with the results. The agent does not need to be online or in the region. Returns a key query handle.

• 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.

• key llRequestUserKey(string username)function

  Asynchronously requests the Agent ID key (UUID) for the agent specified by their current or historical username, returning NULL_KEY if not found. Returns a key query handle for the dataserver event.

• key llRequestUsername(key id)function

  Asynchronously requests the unique single-word username of the agent identified by id, triggering a dataserver event. The agent does not need to be online or in the region. Returns a key query handle.

• integer llSetAgentEnvironment(key agent_id, float transition, list params)function

  Sets an individual agent's environmental settings using the attributes in params over a duration of transition seconds. Must be used as part of an experience; passing an empty list removes overrides.

• llSetAgentRot(rotation rot, integer flags)function

  Sets the rotation of the avatar to rot, controlled by flags.

• 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.

• llTeleportAgentHome(key avatar)function

  Teleports the avatar (who must be standing on land owned by the script owner) directly to their designated home location without warning (similar to a God Summons).

• llUnSit(key id)function

  Forces the agent specified by id to stand up if they are sitting on the object containing the script, or are currently over land owned by the object's owner.

• 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.

• control(key id, integer level, integer edge)event

  Triggered to pass captured avatar control inputs into the script. The parameter level indicates held controls, and edge indicates change in controls (both are bitfields of CONTROL_* constants).

• 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).

• game_control(key id, integer button_levels, list axes)event

  Triggered when a compatible viewer sends game controller input changes for the avatar specified by id. Only triggers for scripts in attachments or seats.