Set Script Running State

31 July 2019

C10 - added the selection optional parameter.

19 May 2015

Release 8.12 - range is now an optional parameter and not required to locate the item.

setscriptrunning (Commands)
Type	Corrade progressive command
Command	`setscriptrunning`
Description	The `setscriptrunning` command can be used to set a script's running state inside a primitive to `start` or `stop` depending on the `action` parameter.
Permissions	`interact`
Parameters	`group`, `password`, `item`, `entity`, `action`
Last Changes	Release 8.12 - `range` is now an optional parameter and not required to locate the item.

The setscriptrunning command can be used to set a script's running state inside a primitive to start or stop depending on the action parameter.

Command Required Parameters Required Corrade Permissions Example

Command	Required Parameters	Required Corrade Permissions	Example
`setscriptrunning`	`group`, `password`, `item`, `entity`, `action`	`interact`	llInstantMessage(CORRADE, wasKeyValueEncode( [ // starts the script called // "sit" in a "Chair" object "command", "setscriptrunning", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), "item", wasURLEscape("Chair"), "range", 5, "entity", wasURLEscape("sit"), "action", "start", "callback", wasURLEscape(URL) ] ) );

setscriptrunning

group, password, item, entity, action

interact

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            // starts the script called
            // "sit" in a "Chair" object
            "command", "setscriptrunning",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "item", wasURLEscape("Chair"),
            "range", 5,
            "entity", wasURLEscape("sit"),
            "action", "start",
            "callback", wasURLEscape(URL)
        ]
    )
);

Optional Parameter	Possible Value	Description
`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

Note that scripts that are added to a primitive using the give command have to be first compiled and then set to running. You can perform both last steps with the recompilescript command that has an optional parameter "run" that will also set the script to running. Additionally, if you have the textual representation of a script, you can also use the updatescript command that will allow you to perform all the steps in one go.