From SmartBots Developers Docs
Jump to: navigation, search

Touches an object attached to the bot (HUD or attachment).

The attached object is being selected by name, and the button to be clicked - by link number.


The following table shows input values (you send them with the API call) and returned output values.

Variable Required Description.
Input basic parameters:
action yes = attachment_touch
apikey yes Your personal developer's API key.
botname yes Your bot's SL login.
secret yes Bot access code of your bot.
custom no The custom data (string) to be passed back to caller script. This value will be returned back to the caller in HTTP response.
objectname yes the name of the attached object (exact, including all spaces)
linkset yes the link number of the object to touch. See the "Comments" section below.
result OK - command completed successfully
FAIL - command failed
resulttext Detailed reason for the failure.
custom The value from input "custom" parameter. See above.
Additional "resulttext" values are available:
  • OBJECT NOT FOUND - The attachment object you've specified was not found
  • LINK NOT FOUND - The object has been found, but it contains less prims than your "linkset" value


1. Determining the link number

To determine the right button using Phoenix Firestorm or a similar viewer. Open object editor window to get the exact linkset of the prim:

  • The link number of the root prim is always "1".
  • Single-prim objects are also have linkset=1

2. IMPORTANT: Data availability

Please note that bot loads all nearby prims within 10-20 seconds after startup. Thus, wait a bit after logging in your bot to issue this command.


Bot locates the "Weapons HUD" on his screen and clicks the button at linkset 15:


<< return back to Bot commands