Difference between revisions of "AdminBot for LSL/Commands/SB INVITE SEND"
Line 5: | Line 5: | ||
{{AdminBot Required Vars|SB_INVITE_SEND}} | {{AdminBot Required Vars|SB_INVITE_SEND}} | ||
− | {{ | + | {{AdminBot Variable|str|yes}} flags, separated by commas |
The following flags can be used: | The following flags can be used: | ||
Line 12: | Line 12: | ||
* Role:''role-name'' - invite to specific role instead of "Everyone" | * Role:''role-name'' - invite to specific role instead of "Everyone" | ||
− | + | See the "Examples" section below. | |
− | {{ | + | {{AdminBot Variable|id|yes}} avatar UUID |
{{API Variables Table End}} | {{API Variables Table End}} | ||
Line 20: | Line 20: | ||
== Comments == | == Comments == | ||
− | + | === Important: existing members check === | |
− | + | Bot updates the list of existing members every 15-20 minutes. Thus: | |
− | + | * if avatar leaves the group, bot will not invite him to the group during the next 20 minutes. | |
+ | * if avatar just joined the group, an immediate second join command will send another group invitation (bot still does not know about new group member). | ||
− | + | By default, existing group members are not invited. Use the ''FORCE'' flag to invite them too. | |
− | + | ||
− | + | ||
Take this into account while testing your group inviter. | Take this into account while testing your group inviter. | ||
Line 34: | Line 33: | ||
=== Roles === | === Roles === | ||
− | ==== 1. Use the role name, not the role title! The name is case-sensitive | + | By default, an invitation is being sent to "Everyone" role. This can be changed by using the ''Role'' flag. |
+ | |||
+ | ==== 1. Use the role name, not the role title! The name is case-sensitive ==== | ||
Make sure that you use the role name. Using the role title (or the role tag name) won't work. Also remember that role name is cAsE SeNsItIvE! | Make sure that you use the role name. Using the role title (or the role tag name) won't work. Also remember that role name is cAsE SeNsItIvE! | ||
Line 43: | Line 44: | ||
Inviting to the specific role requires additional group setup: | Inviting to the specific role requires additional group setup: | ||
+ | |||
# "Assign members to Assigner's Roles" ability given to the bot | # "Assign members to Assigner's Roles" ability given to the bot | ||
# Bot have to be a member of that role. | # Bot have to be a member of that role. |
Revision as of 21:02, 3 May 2017
Invites resident to the group.
// Command usage:
API parameters
llMessageLinked function accepts str and id parameters. Their meaning for SB_INVITE_SEND is explained below:
Variable | Required | Description.
| |
---|---|---|---|
str | yes | flags, separated by commas
The following flags can be used:
See the "Examples" section below. | |
id | yes | avatar UUID |
Comments
Important: existing members check
Bot updates the list of existing members every 15-20 minutes. Thus:
- if avatar leaves the group, bot will not invite him to the group during the next 20 minutes.
- if avatar just joined the group, an immediate second join command will send another group invitation (bot still does not know about new group member).
By default, existing group members are not invited. Use the FORCE flag to invite them too.
Take this into account while testing your group inviter.
Roles
By default, an invitation is being sent to "Everyone" role. This can be changed by using the Role flag.
1. Use the role name, not the role title! The name is case-sensitive
Make sure that you use the role name. Using the role title (or the role tag name) won't work. Also remember that role name is cAsE SeNsItIvE!
If role-name is misspelled, then invite will work though but will invite avatars to default Everyone role.
2. Give the necessary permissions to the bot!
Inviting to the specific role requires additional group setup:
- "Assign members to Assigner's Roles" ability given to the bot
- Bot have to be a member of that role.
If bot has lack abilities, the flashing pop-up appears in viewer of the invited person, reporting that "Inviter is lack of permission...".
Read Inviting residents to custom role page for more details.
Examples
See Goup Inviter Script for group inviter example.