Change Appearance

1 July 2020

C10 - added the exclude and include parameters.

6 October 2016

Release 9.133 - The command now can take a path instead of a name.

4 November 2015

Release 9.36 - Added the deanimate optional parameter that stops all animations before the command executes.

changeappearance (Commands)
Type	Corrade progressive command
Command	`changeappearance`
Description	The `changeappearance` command can be used to wear and attach all the items in a folder.
Permissions	`grooming`
Parameters	`group`, `password`, `folder`
Last Changes	Release 9.133 - The command now can take a path instead of a name.

The changeappearance command performs the following steps:

takes as input an inventory path to a folder.
removes all the items being worn or attached to the avatar provided they are not body-parts that will not be replaced by the items in the input folder.
wears all the resulting items.

In other words, the changeappearance command can be used to wear all items in a folder by replacing all the currently worn items.

Command Required Parameters Required Corrade Permissions Example

changeappearance

group, password, folder

grooming

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // wears all the items in
            // the CoolOutfit folder
            "command", "changeappearance",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            // or just the UUID of an inventory folder
            "folder", "/My Inventory/CoolOutfit"
        ]
    )
);

Optional Parameters	Possible Value	Description
`deanimate`	`True` or `False`	Stop all non-Linden animations before executing the command.
`exclude`	a list of inventory items by UUID or by path	All the inventory items passed as a list to the `exclude` parameter will not be unequipped.
`include`	a list of inventory items by UUID or by path	All inventory items passed as a list to the `include` parameter will be added to the outfit aside the items found in the folder specified by the `folder` parameter.

This command is particularly useful to model bots that must change outfits: you will need to create folders containing the outfit and then issue this command with the folder path as parameter in order to change between outfits. So far, Corrade does not support multiple attachments per slot so when you make the outfit folders, make sure that they do not contain multiple attachments per slot and you should be fine.

Change Appearance

Demonstration