View source for Bot Playground/Commands/takeInworldPrim

{{DISPLAYTITLE:{{SUBPAGENAME}}}}
<onlyinclude>Takes (de-rezzes) or copies in-world prim into bot's inventory. {{NotAvailableForQB}}</onlyinclude>

<syntaxhighlight lang="javascript">
Bot.takeInworldPrim(operation, objectUUID, folderUUID);
</syntaxhighlight>

{{API Command Table}}
{{API Required Vars|login}}

{{API Variable Group|Input}}
{{API Variable|operation|yes}} one of the following values:
* take - to take object from the world completely
* copy - to take a copy of the object
{{API Variable|objectUUID|yes}} the UUID of the in-world object
{{API Variable|folderUUID|yes}} (optional) UUID of the folder to put object to. "Objects" folder will be used if not specified.
{{API Variable Group|Output}}
{{API Return promise}}

{{API Variables Table End}}

== Return value ==

'''Important:''' the command does not checks for the operation success.

== Comments ==

Your bot has to have rights to grab the object specified (own it, or have permissions an owner's friend).

== Examples ==

Touch a special test attachment object (contact SmartBots support to get it):

<syntaxhighlight lang="javascript">
// Take (de-rez) in-world object to the default ("Objects") folder
Bot.takeInworldPrim("take", "bd36c29f-8a14-4350-b648-3e0f50b6d32a");
</syntaxhighlight>

{{NavMenu}}
__NOTOC__