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/commands/addconfigurationgroup.txt ยท Last modified: 2020/09/04 06:44 (external edit)

Access website using Tor Access website using i2p Wizardry and Steamworks PGP Key


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