group_activate

Activates a specific group for the bot — for example, to gain build rights on a parcel.

// See "LSL Helper Functions" page for this function
smartbotsAPI("group_activate", [
  "groupuuid", "0b65a122-8f77-64fe-5b2a-225d4c490d9c"
]);

This command also has an older alias: activate_group.

Variables

The following table shows input values (you send them with the API call) and returned output values.

Input basic parameters

Variable

Required

Description

action

yes

= group_activate

apikey

yes

Your personal developer's API key

botname

yes

Your bot’s SL login

secret

yes

Bot access code of your bot

dataType

optional

Set to "json" to get JSON reply instead of URL-encoded string

custom

optional

Custom data (string) to be passed back to caller script. This value will be returned in the HTTP response

Input

Variable

Required

Description

groupuuid

yes

UUID of the group to activate

Special values for groupuuid:

Value

Description

LAND

Sets active group to the current parcel’s group (useful to gain rez/build rights)

00000000-0000-0000-0000-000000000000

Removes active group (sets to none)

Note: The bot must already be a member of the group to activate it.

Output

(To be received in http_response LSL event — see docs for details)

Variable

Description

result

OK— command completed successfully
FAIL — command failed

resulttext

Detailed reason for the failure

custom

The value from input "custom" parameter

Examples

1. Activate the group that matches the current parcel’s group

Used to automatically gain rez/build rights.

smartbotsAPI("group_activate", [
  "groupuuid", "LAND"
]);

Equivalent HTTP request:

action=activate_group&groupuuid=LAND

2. Remove the active group (set to none)

smartbotsAPI("group_activate", [
  "groupuuid", "00000000-0000-0000-0000-000000000000"
]);

Equivalent HTTP request:

action=group_activate&groupuuid=00000000-0000-0000-0000-000000000000