Add a Group Dynamically to Corrade's Configuration

7 October 2016

  • Release 9.135 - added.
addconfigurationgroup (Commands)
TypeCorrade progressive command
Commandaddconfigurationgroup
DescriptionThe addconfigurationgroup command can be used to add a group to Corrade's configuration.
Permissionssystem
Parametersgroup, password, target, secret, workers, schedules, database, logs, path, permissions, notifications
Last ChangesRelease 9.135 - added.

The addconfigurationgroup command can be used to add a group to Corrade's configuration.

Command Required Parameters Required Corrade Permissions Example
addconfigurationgroup group, password, target, secret, workers, schedules, database, path, permissions, notifications system
llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // Configure a new group.
            "command", "addconfigurationgroup",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            // The name or the UUID of a group.
            "target", "b2eaaaea-995a-01d3-10eb-712d3b2d68f4",
            "secret", llSHA1String("test"),
            "workers", 5,
            "schedules", 2,
            "database", "databases/mygroup.db",
            "logs", "false",
            "path", "logs/groupchat/mygroup.log",
            // Corrade group permissions to set.
            "permissions", wasListToCSV(
                [
                    "group",
                    "notifications",
                    "talk",
                    "interact"
                ]
            ),
            // Corrade group notifications to set.
            "notifications", wasListToCSV(
                [
                    "alert",
                    "balance",
                    "inventory"
                ]
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);
Optional Parameter Possible Values Description
logs true or false Whether Corrade should log the group chat to the file specified by the path parameter.

Notes

  • The added group has to exist on the connecting grid or Corrade will not find the group.
  • When the command is executed, Corrade adds the group to the configuration, the configuration file (Corrade.ini) is updated and then Corrade will reload the configuration. As a consequence, adding a group with this command is permanent since the group configuration will be stored in Corrade's configuration file.
  • This command is added out of convenience because pulling the entire configuration (or even just a group configuration) would most likely exceed the 2KiB restriction imposed by http_request. To change individual settings for a group, you should consider accessing the configuration using the configuration command instead of removing and creating the entire group again.
  • To remove a group dynamically, you would use the removeconfigurationgroup command.

secondlife/scripted_agents/corrade/api/progressive/commands/addconfigurationgroup.txt ยท Last modified: 2017/06/29 09:13 by Wizardry and Steamworks

Access website using Tor


For the copyright, license, warranty and privacy terms for the usage of this website please see the license and privacy pages.