LlInviteToGroup
From Second Life Wiki
Second Life Wiki > LlInviteToGroup
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Tutorials |
| LSL Feature Request |
| The described function does not exist. This article is a feature request. |
Contents |
Summary
Function: llInviteToGroup( key avatar, string role );| REQUEST | Function ID |
| Delay | |
| Energy |
Adds avatar to the group the object is deeded to.
| • key | avatar | |||
| • string | role | – | Role name avatar is to have. |
Requires the PERMISSION_GROUP_INVITE permission, granted by a group officer, to run.
Specification
We need some way to invite an avatar to join the owners group if he has the right to invite members and has given the script permission to act as his delegate.
llInviteToGroup(key group, key avatar)
or
llInviteToGroup(key avatar)
would be great.
We basically need to be able to perform group administration tasks if the script owner is in the group and has the right to perform these tasks.
Depending on if the script has a ('active') group if it's not group-owned we might or might not need another function: list llGetOwnerGroups()
Caveats
- Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event.
- If the script lacks the permission PERMISSION_GROUP_INVITE, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run).
- If PERMISSION_GROUP_INVITE is granted by anyone other than a group officer, then when the function is called an error will be shouted on DEBUG_CHANNEL.
- Once the PERMISSION_GROUP_INVITE permission is granted there is no way to revoke it except from inside the script (for example, with a new llRequestPermissions call). Otherwise, the script will only lose the permission if it is reset or the object is derezzed (deleted, detached, or taken).
See Also
Events
| • | run_time_permissions | – | Permission receiving event |
Functions
| • | llGetPermissions | – | Get the permissions granted | |
| • | llGetPermissionsKey | – | Get the agent who granted permissions | |
| • | llRequestPermissions | – | Request permissions |
Articles
| • | Script permissions |
