Difference between revisions of "Bot Playground/Store/User settings"

From SmartBots Developers Docs
Jump to: navigation, search
Line 12: Line 12:
 
* the setting "friendly" name as user sees it
 
* the setting "friendly" name as user sees it
 
* the optional hint for the user
 
* the optional hint for the user
 +
 +
All settings are string values (if you need a number or UUID you should do a transform in your script).
  
 
== Accessing user settings from script ==
 
== Accessing user settings from script ==
Line 28: Line 30:
  
 
New settings become available here as soon as you add them on "Bot Store > User settings" screen.
 
New settings become available here as soon as you add them on "Bot Store > User settings" screen.
 +
 +
== Asking user for settings ==
 +
 +
User sees the settings right after purchasing the script:
 +
 +
[[Image:Store-user-settings-3.png|center|728px]]
  
 
== Settings and releases ==
 
== Settings and releases ==
  
 
When you develop your script the user settings
 
When you develop your script the user settings
 +
 +
__NOTOC__

Revision as of 17:34, 29 August 2022

The most of scripts are supposed to be configurable for the user. The configurable options could be like group name, various messages and such.

Please note that user's bot name is not a setting. User selects the bot while purchasing your script.

Configuring settings

Store-user-settings-1.png

There are three values you specify:

  • the setting variable name as your script sees it (see below)
  • the setting "friendly" name as user sees it
  • the optional hint for the user

All settings are string values (if you need a number or UUID you should do a transform in your script).

Accessing user settings from script

User setting can be accessed from your script using userSettings object:

console.log("Using group: " + userSettings.group_name);

Specifying settings while developing scripts

You can specify the settings values for your own script while in development:

Store-user-settings-2.png

New settings become available here as soon as you add them on "Bot Store > User settings" screen.

Asking user for settings

User sees the settings right after purchasing the script:

Store-user-settings-3.png

Settings and releases

When you develop your script the user settings