Difference between revisions of "Bot Playground"

From SmartBots Developers Docs
Jump to: navigation, search
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{DISPLAYTITLE:SmartBots Bots Playground}}
 
{{DISPLAYTITLE:SmartBots Bots Playground}}
SmartBots Bots Playground is a dedicated sandbox to run your own programs which control your bot.
+
SmartBots Bots Playground is a JavaScript sandbox to run your own programs to control your Second Life bot.
  
 
The Bots Playground is available here: [https://play.mysmartbots.com/ play.mysmartbots.com/]
 
The Bots Playground is available here: [https://play.mysmartbots.com/ play.mysmartbots.com/]
  
== Playground Language ==
+
== Controlling bots with JavaScript==
  
Playground runs programs written JavaScript. The pure javascript: with callbacks, functions, arrays and objects. The underlying javascript engine is NodeJS (V8).
+
[[Image:Bots Playground screenshot-2.png|link=|center|800px]]
 +
Playground runs programs written JavaScript. The pure javascript: with callbacks, functions, arrays and objects. The underlying javascript engine is NodeJS.
  
 
There are some limitations applied yet:
 
There are some limitations applied yet:
Line 16: Line 17:
 
== Interacting with your bot ==
 
== Interacting with your bot ==
  
Your program sends commands to the bot. Events come from the bots to your program.
+
Your program runs in a sandbox and sends commands to the bot. Events come from the bots to your program.
  
 
This two-way communication is tied directly into javascript program routines:
 
This two-way communication is tied directly into javascript program routines:
Line 23: Line 24:
 
* [[/Events|events]] are callback functions you specify
 
* [[/Events|events]] are callback functions you specify
  
Refer to [[Playground Examples]] page for more info.
+
Refer to [[/Examples|Examples]] page for more info.
  
== Limitations ==
+
== Read more ==
  
Yes, there are still some:
+
* [[/Faq|Playground FAQ]]
 
+
* [[/Bug Hunter program|Bug Hunter program]]
# '''Scripts stop when Bots Playground server gets restarted.''' This is just an early-stage limitation, it will be removed very soon.
+
* [[/Store|Create and sell Playground scripts]]
# '''Bots "forget" the event handlers when bot server get restarted.''' Also the very early-stage limitation.
+
 
+
In few words: bot scripts do work, reliably start and stop. Just don't expect it to run for ''weeks'' yet.
+
 
+
== Safety FAQ ==
+
 
+
; Is my bot password safe? : Yes. We do not store bot and SmartBots account passwords on a sandbox server at all.
+
; Can scripts read files? : No. The scripts are sandboxed and can't access world outside the sandbox. However, check the "Bug Hunter" program below.
+
; Can I crash the server? : Yes, easily. Just write the script which starts a dead loop. During the beta test we don't track and kill such scripts (we will later). So... just act wisely.
+
; Can someone access my scripts? : We think nobody can, but check the Bug Hunter program below. And remember that your program does not hold any bot and account passwords.
+
 
+
== Bug Hunter program ==
+
 
+
Playground scripts run in their own sandboxes. Well, they are supposed to be sandboxes... we appreciate if you report the security holes within [[Bot Playground/Bug Hunter program|Bug Hunter program]].
+
  
 
{{NavMenu}}
 
{{NavMenu}}
 +
__NOTOC__

Latest revision as of 20:21, 19 January 2024

SmartBots Bots Playground is a JavaScript sandbox to run your own programs to control your Second Life bot.

The Bots Playground is available here: play.mysmartbots.com/

Controlling bots with JavaScript

Bots Playground screenshot-2.png

Playground runs programs written JavaScript. The pure javascript: with callbacks, functions, arrays and objects. The underlying javascript engine is NodeJS.

There are some limitations applied yet:

  • We do not support ECMAScript 6
  • import/export is disabled
  • you can't include one script into another (yet)

Interacting with your bot

Your program runs in a sandbox and sends commands to the bot. Events come from the bots to your program.

This two-way communication is tied directly into javascript program routines:

Refer to Examples page for more info.

Read more