Batch Derez or Return Objects

31 July 2019

C10 - added the selection optional parameter.

12 June 2018

C10 Beta - Available in C10 Beta.

batchderez (Commands)
Type	Corrade progressive command
Command	`batchderez`
Description	The `batchderez` command attempts to de-rez multiple objects from a parcel and either save it in the inventory or to a different destination depending on the `type` parameter.
Permissions	`inventory`
Parameters	`group`, `password`, `item`
Last Changes	Available in C10 Beta.

The batchderez command attempts to de-rez multiple objects from a parcel and either save it in the inventory or to a different destination depending on the type parameter.

Command Required Parameters Required Corrade Permissions Example

batchderez

group, password, item

inventory

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // attempt to derez an object
            // called Chair in a 5m range
            "command", "batchderez",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "item", wasListToCSV(
                [
                    wasURLEscape("Chair & Stuff"),
                    "07217bc8-ffa7-4beb-bdb7-f874a54846e0"
                ]
            ),
            "range", 5,
            "callback", wasURLEscape(URL)
        ]
    )
);

Optional Parameter	Possible Value	Description
`folder`	A path or `UUID` of a folder.	Attempts to de-rez the items to the specified `folder`
`type`	A field name from DeRezDestination.	Can take, delete, attach, etc… The specified item as the de-rez action.
`range`	A range in meters.	The spherical distance from Corrade in which to locate the item.
`selection`	`attached`, `rezzed` or `all` (default: `all`)	Either `attached`, `rezzed` or `all` for selecting only primitives or objects attached to avatars, primitives or objects rezzed in-world or all primitives or objects respectively.

Notes

This command is a batch variation of the derez command.
The command may be slow given a large provided list of items to derez since every single item has to be processed individually. If you wish to return items from a parcel or an estate, then please use the returnprimitives command since returnprimitives uses the underlying protocol and is the correct way of returning items.