DEMANDROIDS GROUP INVITER ADVANCED FEATURES

This page contains an explanation of the more advanced features of the Demandroids group inviter system. More information about the basics can be found via the home page for the system. Related information can also be found on the List of Available Configuration Parameters page.

Each Demandroids droid is capable of doing much more than just inviting people to join groups. At the time of this writing, the droids are programmed to recognise 14 different instant message comands, and more are coming soon. However, only the droids' creator is authorised to use all 14 commands. Owning a group inviter sign gives you access to three of the commands: 'invite', 'roles', and 'note'. As you've probably guessed, the 'invite' command is the main one that is sent to the droid by your signs. If you have looked closely at the dialog box that you get when you touch a sign that you own, you have also probably guessed what the 'roles' command is for. It causes the droid to send you an instant message listing all the roles in your group along with the SL UUID key for each role. The 'note' command is not directly related to groups, although it is used internally by the Demandroids systems during the initial set up of your systems. The 'note' command instructs the droid to create a notecard and give that notcard to you. Both the 'invite' and 'roles' commands require UUID key(s), so these commands are really intended to be used by scripts (but they can still be used directly in a "normal" IM session if you can obtain the key(s) that you need somehow). The 'note' command can be more easily used in a normal IM session, but it's difficult to imagine a situation where you would want to use it that way since you would normally just be able to create a notecard yourself. In other words, these commands are really for use in scripts, so the information that follows may be of limited interest to non-scripters.

Command usage and syntax
Each of the following paragraphs in this section describes one command. The first line of the paragraph describes the command's syntax. Items surrounded by angle brackets <like this> are place-holders that need to be replaced with a "real" value when actually issuing the command. The text between the angle brackets provides a clue as to what goes in its place. Items surrounded by square brackets [like this] are optional parts of the command that can be omitted. Everything else, including the spaces between words and keys, should be typed in just as it is written here. The rest of each paragraph explains what the command does and what to put in place of each of the place-holders.

invite <avatar key> <group key> [<role key>]
Invites the avatar identified by the SL UUID key <avatar key> to join the group identified by <group key>, optionally adding that avatar to the role identified by <role key>. If <role key> is not specified then the avatar is added to the "Everyone" role.
You can use the word "me" (without the quotes) in place of <avatar key> to have the group invitation sent to the avatar who is sending the command (this is mostly only useful for testing).
Example to invite me, Demantoid Dagger, to join the Sunnydale-SL Club VIP group
invite 798e6063-dca3-4356-949f-24d15e7cefca 109fe61e-98be-972f-21d9-4cb73d846101
OR
invite me 109fe61e-98be-972f-21d9-4cb73d846101

note [to <avatar key>] <notecard name>:<notecard text>
Causes the droid to create a notecard named <notecard name> containing the text <notecard text>. If the 'to' clause is included, the droid then gives the notecard to the avatar identified by <avatar key>. If the 'to' cluase is omitted, the notecard is given to the avatar that issued the command.
Scripts can create multi-line notecards by embedding newline characters in the notecard text part of the command.
Example to create a notcard called "test notecard" containing the text "this is a test" and send it to me, Demantoid Dagger
note to 798e6063-dca3-4356-949f-24d15e7cefca test notecard:this is a test
Example to create the same notcard and give it back to the avatar who sent this command
note test notecard:this is a test

roles <group key>
Requests a list of the roles defined for the group identified by the SL UUID key <group key>. Note that this command will only work for groups that are associated with a group inviter system that is owned by the avatar issuing the command, and only with the droid that has been assigned to that particular group inviter system. The easiest way to issue this command is to touch a group inviter sign that you own and then click the "Roles" button in the dialog that pops up. The droid responds to this command with an IM in the following format.
<count> roles.
<role name> (<role key>)
...
where <count> is the number of roles defined for the group, and the ellipsis (...) represents more <role name> (<role key>) lines for the rest of the roles. These keys can then be used with the 'invite' command, or in the 'role' configuration parameter of your group inviter sign(s) (see the List of Available Configuration Parameters page).

Home