LlGetAgentInfo
From Second Life Wiki
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Tutorials |
Contents |
Summary
Function: integer llGetAgentInfo( key id );| 206 | Function ID |
| 0.0 | Delay |
| 10.0 | Energy |
Returns an integer bitfield containing the agent information about id.
| • key | id | – | avatar UUID that is in the same region |
| Constant | Val | Returned if agent... |
|---|---|---|
| AGENT_ALWAYS_RUN | 0x1000 | has running ("Always Run") enabled, or is using tap-tap-hold |
| AGENT_ATTACHMENTS | 0x0002 | has attachments |
| AGENT_AUTOPILOT | 0x2000 | is in "autopilot" mode |
| AGENT_AWAY | 0x0040 | is in "away" mode |
| AGENT_BUSY | 0x0800 | is in "busy" mode |
| AGENT_CROUCHING | 0x0400 | is crouching |
| AGENT_FLYING | 0x0001 | is flying or hovering |
| AGENT_IN_AIR | 0x0100 | is in the air (jumping, flying or falling) |
| AGENT_MOUSELOOK | 0x0008 | is in mouselook |
| AGENT_ON_OBJECT | 0x0020 | is sitting on an object |
| AGENT_SCRIPTED | 0x0004 | has scripted attachments |
| AGENT_SITTING | 0x0010 | is sitting |
| AGENT_TYPING | 0x0200 | is typing |
| AGENT_WALKING | 0x0080 | is walking, running or crouch walking |
Caveats
- AGENT_BUSY indicates that the "busy" internal animation is playing, even if the user is not truly in busy mode.
- AGENT_TYPING indicates that the "typing" internal animation is playing, it will not be set if the user disables PlayTypingAnim.
- AGENT_ALWAYS_RUN|AGENT_WALKING indicates that the user requested to run using standard viewer controls. Use llGetAnimation to also detect running caused by physics.
- This function does not return reliable information immediately after a border crossing. Use llGetAnimation instead, if you can. SVC-3177[c]
Important Issues
~ Search JIRA for related Bugs| | | SVC-3177 | [c] | llGetAgentInfo() returns unreliable info after a sim border crossing |
Examples
default { touch_start(integer buf) { buf = llGetAgentInfo(llDetectedKey(0)); string out; if(buf & AGENT_FLYING) out += "The agent is flying.\n"; else out += "The agent is not flying.\n"; if(buf & AGENT_ATTACHMENTS) { if(buf & AGENT_SCRIPTED) out += "The agent has scripted attachments.\n"; else out += "The agent's attachments are unscripted.\n"; } else out += "The agent does not have attachments.\n"; if(buf & AGENT_MOUSELOOK) out += "the agent is in mouselook."; else out += "the agent is in normal camera mode."; llWhisper(0, out); } }
Deep Notes
History
- AGENT_AUTOPILOT was added in SVN:2900 r136439 Trunk s:1.33.0
Issues
~ Search JIRA for related Issues| | | SVC-3177 | [c] | llGetAgentInfo() returns unreliable info after a sim border crossing |
Tests
| • | llGetAgentInfo_Test |
This article wasn't helpful for you? Maybe the related article at the LSL Wiki is able to bring enlightenment.

