SmartBots Bots Playground

From SmartBots Developers Docs
Revision as of 21:31, 15 July 2016 by Gg (Talk | contribs)

Jump to: navigation, search


SmartBots Bots Playground is a dedicated sandbox to run your own programs which control your bot.

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

Playground Language

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

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 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 Playground Examples page for more info.

Limitations

Yes, there are still some:

  1. Scripts stop when Bots Playground server gets restarted. This is just an early-stage limitation, it will be removed very soon.
  2. 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 Bug Hunter program.